v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:08:00.000Z▲ 0 upvotes

Geheimnisse im Repository: Gitleaks in Pre-Commit und CI und was zu tun ist, wenn es ein Leck gibt

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Wenn der Schlüssel bereits durchgesickert ist, zuerst dies

Die Reihenfolge der Aktionen ist wichtiger als die Werkzeuge, also fangen wir am Ende an.

  1. 1.Widerrufen Sie den Schlüssel und geben Sie ihn erneut vom Anbieter aus. Unmittelbar vor dem Löschen des Verlaufs und der Analyse. Öffentliche Repositorys werden ständig von Bots gescannt, und ein Schlüssel, der in einem öffentlichen Commit landet, sollte ab dem Moment des Pushens als kompromittiert gelten.
  2. 2.Aktualisieren Sie den Schlüssel in allen Umgebungen (CI-Geheimnisse, Hosting-Variablen, Secrets-Manager) und starten Sie die Dienste neu.
  3. 3.Überprüfen Sie das Schlüsselnutzungsprotokoll bei Ihrem Anbieter: Anrufe von unbekannten Adressen, ungewöhnliche Volumina, erstellte Ressourcen. Für Cloud-Schlüssel – neue Instanzen und IAM-Benutzer.
  4. 4.Entscheiden Sie erst dann, ob der Verlauf gelöscht werden soll. Sie können ihn über git filter-repo neu schreiben, aber Sie haben keine Kontrolle über Klone, Forks, CI-Caches und Kopien von Spiegeldiensten. Beim Entfernen aus der Geschichte geht es um Hygiene, nicht um die Behebung eines Lecks. Wenn ein Schlüssel entzogen wird, ist er ungefährlich, egal wo er sich befindet.

Ein häufiger Fehler besteht darin, die Datei mit einem neuen Commit zu löschen und das Problem als gelöst zu betrachten. Der Wert bleibt im Verlauf und wird mit einem Befehl git log -p gefunden.

Prävention: Gitleaks lokal

gitleaks durchsucht den Code und den Verlauf gemäß einer Reihe von Regeln nach Zeichenfolgen, die den Schlüsseln bekannter Dienste und Hochentropiewerten ähneln. Anbindung über Pre-Commit-Framework:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/gitleaks/gitleaks
    rev: v8.30.1   # конкретный тег; pre-commit autoupdate обновит его
    hooks:
      - id: gitleaks
pip install pre-commit      # или brew install pre-commit
pre-commit install          # ставит хук в .git/hooks
pre-commit run gitleaks --all-files

Der Hook überprüft nur, was Sie festschreiben, daher ist er schnell. Aber es ist lokal: Der Kollege, der pre-commit install nicht ausgeführt hat, hat es nicht und es ist durch git commit --no-verify deaktiviert. Daher ist das Vorab-Commit eine Annehmlichkeit für den Entwickler, und die eigentliche Hürde ist die Verifizierung im CI.

Einmalige Überprüfung der gesamten Historie eines bestehenden Repositorys (in den Versionen 8.19 und höher heißen die Befehle git und dir; die alten detect und protect werden aus Kompatibilitätsgründen beibehalten):

gitleaks git --redact -v .

Das Flag --redact verbirgt die gefundenen Werte in der Ausgabe – ohne es wird der Bericht selbst zu einem Leak, wenn er in ein Ticket kopiert wird.

Validierung in CI

# .github/workflows/secrets.yml
name: secrets
on: [pull_request, push]
permissions:
  contents: read
jobs:
  gitleaks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0       # полная история, иначе проверяется только последний коммит
      - uses: gitleaks/gitleaks-action@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Für Organisationsrepositorys erfordert gitleaks-action einen Lizenzschlüssel (kostenlos, auf Anfrage erhältlich) in der Variablen GITLEAKS_LICENSE. Eine Alternative ohne Schlüssel besteht darin, die Binärdatei selbst oder das Gitleaks-Docker-Image im Schritt run auszuführen.

Machen Sie diese Aufgabe zu einer obligatorischen Prüfung in den Zweigschutzregeln. Dann stoppt ein lokal durchgesickertes Geheimnis bei PR, noch bevor es die Hauptniederlassung erreicht.

Falsch positive Ergebnisse

Testvorrichtungen, Beispielschlüssel aus der Dokumentation und Hashes in Sperrdateien sehen manchmal wie Geheimnisse aus. Optionen:

  • Der gitleaks:allow-Kommentar in der Zeile ist eine gezielte Ausnahme, sichtbar in der Rezension.
  • Datei .gitleaksignore mit Fingerabdrücken spezifischer Ergebnisse aus dem Bericht.
  • Besitzen Sie .gitleaks.toml, erweitern Sie die Standardregeln und setzen Sie Ausnahmen entlang der Pfade.

Schließen Sie nicht ganze Verzeichnisse wie config/ aus – dort landen die Geheimnisse.

GitHub-Push-Schutz

GitHub verfügt über integriertes geheimes Scannen mit Push-Blockierung für bekannte Token-Formate. Es ist kostenlos für öffentliche Repositories und für private als Teil des kostenpflichtigen GitHub Secret Protection verfügbar. Es ergänzt GitLeaks: Es funktioniert serverseitig und kann von keinem Flag übersehen werden, kennt aber nur die Formate von GitHub-Partnern und sieht keinerlei eigene Geheimnisse.

So verhindern Sie Leckagen grundsätzlich

  • .env* in .gitignore vom ersten Commit, im Repository gibt es nur .env.example mit leeren Werten.
  • Schlüssel mit minimalen Rechten und für jede Umgebung separat: Das Durchsickern eines Testschlüssels sollte die Produktion nicht öffnen.
  • Secrets in CI – über den integrierten Secrets Store, niemals in YAML.
  • Achtung bei Protokollen: Die Werte der Umgebungsvariablen, die beim Debuggen des Builds gedruckt werden, bleiben in den CI-Protokollen.

Was man nicht tun sollte

  • „Verschlüsseln“ Sie den Base64-Schlüssel nicht vor dem Festschreiben. Scanner können dies nicht immer erkennen, aber der Angreifer wird es in einer Sekunde entschlüsseln.
  • Verzögern Sie die Drehung nicht, bis klar ist, ob jemand den Schlüssel benutzt hat. Die Klärung dauert Stunden, die Rotation dauert Minuten.
  • Schreiben Sie den Verlauf eines gemeinsamen Threads nicht stillschweigend neu. Kollegen mit lokalen Kopien werden beim nächsten Push alte Commits zurücksetzen; stimmen Sie zu und bitten Sie darum, das Repository erneut zu klonen.

Обсуждение (0)

Ещё на vbcd4u.com