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

Sekrety w repozytorium: gitleaks w pre-commit i CI oraz co zrobić, jeśli nastąpi wyciek

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

Jeśli klucz już wyciekł, najpierw to

Kolejność działań jest ważniejsza niż narzędzia, więc zacznijmy od końca.

  1. 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. 2.Zaktualizuj klucz we wszystkich środowiskach (klucze CI, zmienne hostingowe, menedżer kluczy tajnych) i uruchom ponownie usługi.
  3. 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. 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:allow w wierszu jest ukierunkowanym wyjątkiem, widocznym w recenzji.
  • Plik .gitleaksignore z 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 .gitignore z pierwszego zatwierdzenia, w repozytorium jest tylko .env.example z 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.

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

Ещё на vbcd4u.com