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

Segreti nel repository: gitleaks in pre-commit e CI e cosa fare in caso di perdita

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

Se la chiave è già trapelata, prima questa

L'ordine delle azioni è più importante degli strumenti, quindi cominciamo dalla fine.

  1. 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. 2.Aggiorna la chiave in tutti gli ambienti (segreti CI, variabili di hosting, gestore dei segreti) e riavvia i servizi.
  3. 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. 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:allow nella riga è un'eccezione mirata, visibile nella recensione.
  • File .gitleaksignore con 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 .gitignore dal primo commit, nel repository c'è solo .env.example con 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.

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

Ещё на vbcd4u.com