Sekrety w repozytorium: gitleaks w pre-commit i CI oraz co zrobić, jeśli nastąpi wyciek
Jeśli klucz już wyciekł, najpierw to
Kolejność działań jest ważniejsza niż narzędzia, więc zacznijmy od końca.
- 1.Unieważnij i wyślij ponownie klucz od dostawcy. Natychmiast, przed wyczyszczeniem historii i analiz. Publiczne repozytoria są stale skanowane przez boty, a klucz, który trafia do publicznego zatwierdzenia, powinien być uważany za zagrożony od momentu wypchnięcia.
- 2.Zaktualizuj klucz we wszystkich środowiskach (klucze CI, zmienne hostingowe, menedżer kluczy tajnych) i uruchom ponownie usługi.
- 3.Sprawdź rejestr użycia klucza u swojego operatora: połączenia z nieznanych adresów, nietypowe wolumeny, utworzone zasoby. Dla kluczy chmurowych - nowe instancje i użytkownicy IAM.
- 4.Dopiero wtedy zdecyduj, czy wyczyścić historię. Możesz ją przepisać za pomocą
git filter-repo, ale nie masz kontroli nad klonami, forkami, pamięciami podręcznymi CI i kopiami usług lustrzanych. Usunięcie z historii dotyczy higieny, a nie naprawienia wycieku. Jeśli klucz zostanie unieważniony, będzie nieszkodliwy niezależnie od tego, gdzie się znajduje.
Częstym błędem jest usunięcie pliku nowym zatwierdzeniem i uznanie problemu za rozwiązany. Wartość pozostaje w historii i można ją znaleźć za pomocą jednego polecenia git log -p.
Zapobieganie: gitleak lokalnie
gitleaks przeszukuje kod i historię pod kątem ciągów znaków podobnych do kluczy znanych usług i wartości o wysokiej entropii zgodnie z zestawem reguł. Połączenie poprzez platformę przed zatwierdzeniem:
# .pre-commit-config.yaml
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.30.1 # конкретный тег; pre-commit autoupdate обновит его
hooks:
- id: gitleaks[[VB_1_KOD]]
Hak sprawdza tylko to, co popełniłeś, więc jest szybki. Ale jest lokalny: kolega, który nie uruchomił pre-commit install, nie ma go i jest wyłączony przez git commit --no-verify. Dlatego pre-commit jest wygodą dla programisty, a prawdziwą barierą jest weryfikacja w CI.
Jednorazowe sprawdzenie całej historii istniejącego repozytorium (w wersji 8.19 i późniejszych polecenia noszą nazwy git i dir; stare detect i protect zostają zachowane dla kompatybilności):
gitleaks git --redact -v .
Flaga --redact ukrywa znalezione wartości na wyjściu - bez niej sam raport staje się wyciekiem, jeśli zostanie skopiowany do zgłoszenia.
Walidacja w 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 }}W przypadku repozytoriów organizacyjnych gitleaks-action wymaga klucza licencyjnego (bezpłatnego, dostępnego na żądanie) w zmiennej GITLEAKS_LICENSE. Alternatywą bez klucza jest uruchomienie samego pliku binarnego lub obrazu Dockera gitleaks w kroku run.
Uczyń to zadanie obowiązkowym sprawdzeniem w zasadach ochrony oddziałów. Wtedy sekret wyciekający lokalnie zatrzyma się w PR, zanim jeszcze dotrze do głównego oddziału.
Fałszywe alarmy
Urządzenia testowe, przykładowe klucze z dokumentacji i skróty w plikach blokad czasami wyglądają jak sekrety. Opcje:
- Komentarz
gitleaks:alloww wierszu jest ukierunkowanym wyjątkiem, widocznym w recenzji. - Plik
.gitleaksignorez odciskami palców konkretnych ustaleń z raportu. - Posiadaj
.gitleaks.toml, rozszerzając standardowe zasady i ustawiając wyjątki na ścieżkach.
Nie wykluczaj całych katalogów, takich jak config/ – tam kończą się sekrety.
Ochrona push w GitHubie
GitHub ma wbudowane tajne skanowanie z blokowaniem push dla znanych formatów tokenów. Jest dostępny bezpłatnie dla repozytoriów publicznych, a dla prywatnych w ramach płatnej usługi GitHub Secret Protection. Uzupełnia gitleaks: działa po stronie serwera i nie można go przeoczyć flagi, ale zna tylko formaty partnerów GitHub i nie widzi żadnych własnych tajemnic.
Jak w zasadzie zapobiegać wyciekom
.env*w.gitignorez pierwszego zatwierdzenia, w repozytorium jest tylko.env.examplez pustymi wartościami.- Klucze z minimalnymi uprawnieniami i osobne dla każdego środowiska: wyciek klucza testowego nie powinien otworzyć produkcji.
- Sekrety w CI - poprzez wbudowany magazyn sekretów, nigdy w YAML.
- Uwaga na logi: wartości zmiennych środowiskowych wypisane podczas debugowania kompilacji pozostają w logach CI.
Czego nie robić
- Nie „szyfruj” klucza base64 przed zatwierdzeniem. Skanery nie zawsze to wyłapią, ale atakujący rozszyfruje to w ciągu sekundy.
- Nie opóźniaj obracania, dopóki nie będzie jasne, czy ktoś użył klucza. Wyjaśnienie zajmuje godziny, rotacja zajmuje minuty.
- Nie zapisuj po cichu historii udostępnionego wątku. Współpracownicy posiadający lokalne kopie cofną stare zatwierdzenia przy następnym naciśnięciu; zgodzić się i poprosić o ponowne sklonowanie repozytorium.