Segreti nel repository: gitleaks in pre-commit e CI e cosa fare in caso di perdita
Se la chiave è già trapelata, prima questa
L'ordine delle azioni è più importante degli strumenti, quindi cominciamo dalla fine.
- 1.Revocare e riemettere la chiave dal fornitore. Immediatamente, prima di cancellare la cronologia e l'analisi. I repository pubblici vengono costantemente scansionati dai bot, e una chiave che finisce in un commit pubblico dovrebbe essere considerata compromessa dal momento del push.
- 2.Aggiorna la chiave in tutti gli ambienti (segreti CI, variabili di hosting, gestore dei segreti) e riavvia i servizi.
- 3.Controlla il registro di utilizzo della chiave con il tuo provider: chiamate da indirizzi sconosciuti, volumi insoliti, risorse create. Per le chiavi cloud: nuove istanze e utenti IAM.
- 4.Solo allora decidi se cancellare la cronologia. Puoi riscriverla tramite
git filter-repo, ma non controlli cloni, fork, cache CI e copie di servizi mirror. Cancellare dalla storia è una questione di igiene, non di riparare una perdita. Se una chiave viene revocata, è innocua ovunque si trovi.
Un errore comune è eliminare il file con un nuovo commit e considerare il problema risolto. Il valore rimane nella cronologia e viene trovato con un comando git log -p.
Prevenzione: gitleaks a livello locale
gitleaks cerca nel codice e nella cronologia stringhe simili alle chiavi di servizi noti e valori ad alta entropia secondo una serie di regole. Connessione tramite framework pre-commit:
# .pre-commit-config.yaml
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.30.1 # конкретный тег; pre-commit autoupdate обновит его
hooks:
- id: gitleaks[[VB_1_CODICE]]
L'hook controlla solo ciò che commetti, quindi è veloce. Ma è locale: il collega che non ha eseguito pre-commit install non ce l'ha, ed è disabilitato da git commit --no-verify. Pertanto, il pre-commit è una comodità per lo sviluppatore e il vero ostacolo è la verifica in CI.
Controllo una tantum dell'intera cronologia di un repository esistente (nelle versioni 8.19 e successive i comandi si chiamano git e dir; i vecchi detect e protect vengono mantenuti per compatibilità):
[[VB_2_CODICE]]
Il flag --redact nasconde i valori trovati nell'output: senza di esso, il report stesso diventa una perdita se viene copiato in un ticket.
Convalida in CI
[[VB_3_CODICE]]
Per i repository organizzativi, gitleaks-action richiede una chiave di licenza (gratuita, disponibile su richiesta) nella variabile GITLEAKS_LICENSE. Un'alternativa senza chiave è eseguire il file binario stesso o l'immagine Docker gitleaks nel passaggio run.
Rendi questa attività un controllo obbligatorio nelle regole di protezione del ramo. Quindi un segreto trapelato localmente si fermerà a PR, ancor prima di arrivare alla filiale principale.
Falsi positivi
Le apparecchiature di test, le chiavi di esempio dalla documentazione e gli hash nei file di blocco a volte sembrano segreti. Opzioni:
- Il commento
gitleaks:allownella riga è un'eccezione mirata, visibile nella recensione. - File
.gitleaksignorecon le impronte digitali dei risultati specifici del rapporto. - Possedere
.gitleaks.toml, espandendo le regole standard e impostando eccezioni lungo i percorsi.
Non escludere intere directory come config/: è lì che finiscono i segreti.
Protezione push di GitHub
GitHub dispone di una scansione segreta integrata con blocco push per formati di token conosciuti. È disponibile gratuitamente per i repository pubblici e per quelli privati come parte della GitHub Secret Protection a pagamento. È complementare a gitleaks: funziona lato server e non può essere mancato da un flag, ma conosce solo i formati dei partner GitHub e non vede i tuoi segreti di alcun tipo.
Come prevenire le fughe di notizie in linea di principio
.env*in.gitignoredal primo commit, nel repository c'è solo.env.examplecon valori vuoti.- Chiavi con diritti minimi e separate per ogni ambiente: la fuga di una chiave di prova non dovrebbe aprire la produzione.
- Segreti in CI: tramite l'archivio dei segreti integrato, mai in YAML.
- Attenzione ai log: i valori delle variabili d'ambiente stampati durante il debug della build rimangono nei log CI.
Cosa non fare
- Non "crittografare" la chiave base64 prima di impegnarsi. Gli scanner non sempre lo rilevano, ma l'aggressore lo decodificherà in un secondo.
- Non ritardare la rotazione finché non sia chiaro se qualcuno ha utilizzato la chiave. Il chiarimento richiede ore, la rotazione richiede minuti.
- Non riscrivere silenziosamente la cronologia di un thread condiviso. I colleghi con copie locali ripristineranno i vecchi commit con il push successivo; accettare e chiedere di clonare nuovamente il repository.