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

Secrets dans le référentiel : gitleaks dans le pré-commit et CI et que faire en cas de fuite

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

Si la clé a déjà fui, commencez par ceci

L'ordre des actions est plus important que les outils, commençons donc par la fin.

  1. 1.Révoquer et réémettre la clé du fournisseur. Immédiatement, avant d'effacer l'historique et l'analyse. Les référentiels publics sont constamment analysés par des robots, et une clé qui aboutit dans une validation publique doit être considérée comme compromise dès le moment de sa diffusion.
  2. 2.Mettez à jour la clé dans tous les environnements (secrets CI, variables d'hébergement, gestionnaire de secrets) et redémarrez les services.
  3. 3.Vérifiez le journal d'utilisation des clés auprès de votre fournisseur : appels provenant d'adresses inconnues, volumes inhabituels, ressources créées. Pour les clés cloud : nouvelles instances et utilisateurs IAM.
  4. 4.Ensuite, décidez si vous souhaitez effacer l'historique. Vous pouvez le réécrire via git filter-repo, mais vous ne contrôlez pas les clones, les forks, les caches CI et les copies des services miroir. Supprimer de l’histoire est une question d’hygiène, pas de réparation d’une fuite. Si une clé est révoquée, elle est inoffensive, peu importe où elle se trouve.

Une erreur courante consiste à supprimer le fichier avec un nouveau commit et à considérer le problème comme résolu. La valeur reste dans l'historique et est trouvée avec une seule commande git log -p.

Prévention : gitleaks localement

gitleaks recherche dans le code et l'historique des chaînes similaires aux clés de services connus et aux valeurs à haute entropie selon un ensemble de règles. Connexion via un framework de pré-commit :

# .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

Le hook vérifie uniquement ce que vous validez, donc c'est rapide. Mais il est local : le collègue qui n'a pas exécuté pre-commit install ne l'a pas, et il est désactivé par git commit --no-verify. Par conséquent, le pré-commit est une commodité pour le développeur, et le véritable obstacle est la vérification dans CI.

Vérification unique de tout l'historique d'un référentiel existant (dans les versions 8.19 et supérieures les commandes sont appelées git et dir ; les anciens detect et protect sont conservés pour des raisons de compatibilité) :

gitleaks git --redact -v .

L'indicateur --redact masque les valeurs trouvées dans la sortie - sans lui, le rapport lui-même devient une fuite s'il est copié dans un ticket.

Validation en 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 }}

Pour les référentiels organisationnels, gitleaks-action nécessite une clé de licence (gratuite, disponible sur demande) dans la variable GITLEAKS_LICENSE. Une alternative sans clé consiste à exécuter le binaire lui-même ou l'image Docker de gitleaks à l'étape run.

Faites de cette tâche une vérification obligatoire dans les règles de protection des succursales. Ensuite, un secret divulgué localement s'arrêtera au PR, avant même d'atteindre la branche principale.

Faux positifs

Les appareils de test, les exemples de clés de la documentation et les hachages dans les fichiers de verrouillage ressemblent parfois à des secrets. Possibilités :

  • Le commentaire gitleaks:allow dans la ligne est une exception ciblée, visible dans la revue.
  • Fichier .gitleaksignore avec les empreintes digitales des conclusions spécifiques du rapport.
  • Posséder .gitleaks.toml, élargissant les règles standard et définissant des exceptions le long des chemins.

N'excluez pas des répertoires entiers comme config/ - c'est là que finissent les secrets.

Protection contre les poussées GitHub

GitHub intègre une analyse secrète avec blocage push pour les formats de jetons connus. Il est disponible gratuitement pour les référentiels publics et privés dans le cadre de la protection secrète GitHub payante. Il complète gitleaks : il fonctionne côté serveur et ne peut être manqué par un drapeau, mais il ne connaît que les formats des partenaires GitHub et ne voit aucun secret d'aucune sorte.

Comment éviter les fuites en principe

  • .env* dans .gitignore du premier commit, dans le référentiel il n'y a que .env.example avec des valeurs vides.
  • Clés avec des droits minimaux et séparées pour chaque environnement : la fuite d'une clé de test ne doit pas ouvrir la production.
  • Secrets en CI - via le magasin de secrets intégré, jamais en YAML.
  • Attention aux logs : les valeurs des variables d'environnement imprimées lors du débogage du build restent dans les logs CI.

Ce qu'il ne faut pas faire

  • Ne "cryptez" pas la clé base64 avant de valider. Les scanners ne le détecteront pas toujours, mais l'attaquant le décodera en une seconde.
  • Ne retardez pas la rotation jusqu'à ce qu'il soit clair si quelqu'un a utilisé la clé. La clarification prend des heures, la rotation prend quelques minutes.
  • Ne réécrivez pas silencieusement l'historique d'un fil de discussion partagé. Les collègues disposant de copies locales annuleront les anciens commits lors de la prochaine poussée ; acceptez et demandez de re-cloner le référentiel.

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

Ещё на vbcd4u.com