⚙️ 🤖 gitleaks als pre-commit-Hook vor dem ersten Commit #2

Closed
opened 2026-11-15 18:18:43 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand ██░░░░░░░░ Gering — Hook + Konfiguration
Nutzen █████████░ Sehr hoch — öffentliches Repo, Secrets dürfen nie in die Historie
Bruchhäufigkeit ██░░░░░░░░ Gering
Nachhaltigkeit █████████░ Sehr hoch — wirkt bei jedem Commit
Dringlichkeit █████████░ Sehr hoch — blockiert den ersten Commit

Ziel

Vor dem ersten Commit läuft gitleaks als pre-commit-Hook. Kein Commit ohne Scan der gestagten Änderungen.

Befund

  • Auf der Arbeitsmaschine ist global core.hooksPath gesetzt (globaler Secret-Guard). Damit ignoriert git jedes repo-lokale .git/hooks/pre-commit — ein dort abgelegter gitleaks-Hook liefe nie.
  • Der globale Hook ruft keine repo-lokalen Hooks auf. Ein repo-lokales Überschreiben von core.hooksPath würde den globalen Guard abschalten und ist Sessions nicht erlaubt.
  • gitleaks ist auf der Maschine nicht installiert (per nix shell nixpkgs#gitleaks verfügbar).

Lösung offen (Entscheid beim Besitzer des globalen Hooks)

  • a) Globaler Hook ruft nach seinen Prüfungen das unversionierte $GIT_DIR/hooks/pre-commit auf, falls vorhanden; das Repo liefert ein Installationsscript für den gitleaks-Hook.
  • b) Globaler Hook ruft gitleaks git --staged für alle Repos auf, falls eine .gitleaks.toml im Repo liegt oder generell.
  • c) Repo-lokales core.hooksPath auf einen versionierten Hook-Ordner, der den globalen Guard und gitleaks verkettet (setzt nur der Projektinhaber).

Abnahme

  • Test-Commit mit einem Dummy-Token-Muster wird verweigert, sauberer Commit geht durch.
  • Der globale Secret-Guard läuft weiterhin.

Bis dahin: kein Commit in diesem Repo; Arbeit liegt im Working-Tree.

🤖 angelegt von Claude v00-botkern (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `██░░░░░░░░` | Gering — Hook + Konfiguration | | Nutzen | `█████████░` | Sehr hoch — öffentliches Repo, Secrets dürfen nie in die Historie | | Bruchhäufigkeit | `██░░░░░░░░` | Gering | | Nachhaltigkeit | `█████████░` | Sehr hoch — wirkt bei jedem Commit | | Dringlichkeit | `█████████░` | Sehr hoch — blockiert den ersten Commit | ## Ziel Vor dem ersten Commit läuft `gitleaks` als pre-commit-Hook. Kein Commit ohne Scan der gestagten Änderungen. ## Befund - Auf der Arbeitsmaschine ist global `core.hooksPath` gesetzt (globaler Secret-Guard). Damit ignoriert git jedes repo-lokale `.git/hooks/pre-commit` — ein dort abgelegter gitleaks-Hook liefe nie. - Der globale Hook ruft keine repo-lokalen Hooks auf. Ein repo-lokales Überschreiben von `core.hooksPath` würde den globalen Guard abschalten und ist Sessions nicht erlaubt. - `gitleaks` ist auf der Maschine nicht installiert (per `nix shell nixpkgs#gitleaks` verfügbar). ## Lösung offen (Entscheid beim Besitzer des globalen Hooks) - a) Globaler Hook ruft nach seinen Prüfungen das unversionierte `$GIT_DIR/hooks/pre-commit` auf, falls vorhanden; das Repo liefert ein Installationsscript für den gitleaks-Hook. - b) Globaler Hook ruft `gitleaks git --staged` für alle Repos auf, falls eine `.gitleaks.toml` im Repo liegt oder generell. - c) Repo-lokales `core.hooksPath` auf einen versionierten Hook-Ordner, der den globalen Guard und gitleaks verkettet (setzt nur der Projektinhaber). ## Abnahme - Test-Commit mit einem Dummy-Token-Muster wird verweigert, sauberer Commit geht durch. - Der globale Secret-Guard läuft weiterhin. Bis dahin: kein Commit in diesem Repo; Arbeit liegt im Working-Tree. > 🤖 angelegt von Claude v00-botkern (API/Token holm)
Author
Owner

Erledigt. gitleaks 8.30.1 läuft als Inhaltsprüfung im globalen pre-commit-Hook der Arbeitsmaschine, für alle Repos. Ein repo-lokaler Hook ist damit nicht nötig.

Beleg:

  • Probe-Commit in einem Wegwerf-Repo mit Dummy-Token im Muster eines GitHub-PAT wurde verweigert (gitleaks-Fund im Inhalt, rc 1).
  • gitleaks dir über den Repo-Inhalt: keine Funde.
  • Erste Commits 120d9c5 und 3d2ba55 sind durch den Hook gelaufen und signiert.

🤖 angelegt von Claude v00-botkern (API/Token holm)

Erledigt. gitleaks 8.30.1 läuft als Inhaltsprüfung im globalen pre-commit-Hook der Arbeitsmaschine, für alle Repos. Ein repo-lokaler Hook ist damit nicht nötig. Beleg: - Probe-Commit in einem Wegwerf-Repo mit Dummy-Token im Muster eines GitHub-PAT wurde verweigert (`gitleaks-Fund im Inhalt`, rc 1). - `gitleaks dir` über den Repo-Inhalt: keine Funde. - Erste Commits 120d9c5 und 3d2ba55 sind durch den Hook gelaufen und signiert. > 🤖 angelegt von Claude v00-botkern (API/Token holm)
holm 2026-11-15 19:16:09 +01:00
Sign in to join this conversation.
No description provided.