Aller au contenu

Cheatsheet · OSINT · Pentest web

Détecter les secrets dans un dépôt Git avec Gitleaks et TruffleHog

Rechercher des secrets dans l’historique des dépôts Git d’un client avec Gitleaks, TruffleHog et git, puis traiter un constat : rotation et historique.

Par Steven Carrier Publié le

Site officiel : Gitleaks

Un secret commité (clé d’API, mot de passe, jeton, clé privée) reste lisible dans l’historique même après suppression du fichier. Cette fiche présente la détection sur des dépôts que le client possède ou qu’il vous a explicitement confiés : Gitleaks, TruffleHog et quelques commandes git de base. Cadrez la recherche (dépôts, organisations, branches) dans la checklist de cadrage d’un pentest ; côté OSINT, le sujet complète la méthodologie d’évaluation de l’exposition. Les exemples (cible.example, alice, depot-exemple) sont fictifs ; ORG_CLIENT et DEPOT_CLIENT sont à remplacer par l’organisation et le dépôt GitHub du client.

Principe et précautions

Ces outils lisent le contenu des dépôts, donc tout ce qu’ils trouvent est potentiellement un identifiant valide. Trois règles pour la mission :

  • travaillez sur un clone local, jamais en écrivant dans le dépôt du client ;
  • n’utilisez jamais un secret découvert pour vous connecter, sauf mention expresse dans la convention ;
  • ne recopiez pas les secrets en clair dans le rapport : citez le fichier, le commit et un fragment masqué.

Les versions des outils évoluent : confirmez les options avec gitleaks --help et trufflehog --help avant d’automatiser.

Gitleaks : analyser un dépôt

Les versions récentes de Gitleaks séparent les modes en sous-commandes : git (historique d’un dépôt) et dir (fichiers d’un répertoire, sans historique). L’ancienne commande gitleaks detect est dépréciée dans les versions récentes ; vérifiez avec gitleaks --help ce que propose votre version.

# Historique complet d'un dépôt cloné (tous les commits)
gitleaks git --verbose --redact depot-exemple

# Dépôt du répertoire courant
gitleaks git --redact .

# Fichiers d'un répertoire ou d'un fichier, sans lire l'historique Git
gitleaks dir --redact ./depot-exemple

# Rapport JSON pour le suivi, secrets masqués
gitleaks git --redact --report-format json --report-path rapport-gitleaks.json depot-exemple

--redact masque les secrets dans la sortie et le rapport : activez-le par défaut. --verbose affiche chaque constat (règle, fichier, commit, auteur, date). Gitleaks retourne un code de sortie non nul (1 par défaut) quand il trouve des secrets, ce qui sert en intégration continue ; --exit-code permet de le modifier.

# Limiter aux commits d'une plage (options passées à git log)
gitleaks git --redact --log-opts="--all --since=2026-01-01" depot-exemple

# Écarter les constats déjà triés (baseline issue d'un rapport précédent)
gitleaks git --redact --baseline-path rapport-precedent.json depot-exemple

# Configuration personnalisée (règles ajoutées, listes d'exceptions)
gitleaks git --redact --config gitleaks.toml depot-exemple

Gitleaks détecte à partir de motifs et d’entropie : attendez-vous à des faux positifs (exemples de documentation, jetons de test, identifiants publics) et à des faux négatifs (secrets sans format reconnaissable).

TruffleHog : dépôts, organisations et fichiers

TruffleHog analyse un dépôt Git, une organisation GitHub ou un système de fichiers, et peut vérifier si un secret détecté est encore valide.

# Dépôt local (historique complet)
trufflehog git file://./depot-exemple

# Un dépôt distant du client, accessible avec les droits fournis
trufflehog git https://git.cible.example/equipe/depot-exemple.git

# Une organisation ou un dépôt GitHub du client (jeton en lecture seule fourni par le client)
export GITHUB_TOKEN=...
trufflehog github --org=ORG_CLIENT
trufflehog github --repo=https://github.com/ORG_CLIENT/DEPOT_CLIENT

# Fichiers d'un répertoire
trufflehog filesystem ./depot-exemple

# Sortie JSON
trufflehog git file://./depot-exemple --json > rapport-trufflehog.json

Utilisez un jeton GitHub à portée minimale (lecture des dépôts) et révoquez-le en fin de mission.

Vérification des secrets : implication sur le consentement

Par défaut, TruffleHog tente de vérifier chaque secret détecté en l’envoyant au service concerné (par exemple une API de fournisseur cloud ou de messagerie) pour savoir s’il est valide. Cela change la nature de l’action :

  • vous émettez des requêtes d’authentification vers des services tiers, depuis votre adresse IP, avec un identifiant qui n’est pas le vôtre ;
  • ces tentatives apparaissent dans les journaux du fournisseur et peuvent déclencher des alertes chez le client ;
  • la convention d’audit et les conditions du service tiers peuvent ne pas autoriser cet usage.
# Aucune vérification : le secret n'est pas envoyé à des tiers (analyse purement locale)
trufflehog git file://./depot-exemple --no-verification

# Ne retenir que les secrets vérifiés comme valides (appelle les API tierces)
trufflehog git file://./depot-exemple --only-verified

Le choix est un point de la convention : prévoyez-le par écrit. Sans autorisation explicite du client pour la vérification, lancez avec --no-verification et laissez le client valider ou révoquer lui-même. Notez que --only-verified masque aussi les secrets non vérifiables : l’absence de résultat ne prouve donc pas l’absence de secret.

Compléter avec git

Quelques commandes suffisent pour contrôler un constat ou chercher un motif précis.

# Rechercher un motif dans tout l'historique (tous les commits)
git log --all -p -S'AKIA' --oneline

# Retrouver quand un fichier sensible a été ajouté ou supprimé
git log --all --diff-filter=AD --name-status -- '*.env' '*.pem' '*id_rsa*'

# Chercher un motif dans l'arborescence de tous les commits
git grep -n -i 'password' $(git rev-list --all) -- '*.yml' | head -50

# Qui a introduit la ligne, et quand
git blame -L 12,12 chemin/fichier.conf

git log -S renvoie les commits qui ajoutent ou retirent la chaîne ; git grep sur git rev-list --all peut être très long sur un gros dépôt, limitez-le par chemin. Cherchez aussi les noms de fichiers à risque : .env, *.pem, id_rsa, terraform.tfstate, *.kdbx, credentials.

Que faire d’un constat

  1. Qualifier : le secret est-il réel, encore actif, et que permet-il (périmètre des droits) ? Faites vérifier par le client plutôt que par vous.
  2. Révoquer et remplacer : la rotation du secret est la mesure qui compte. Supprimer le fichier du dépôt ou le dernier commit ne suffit pas.
  3. Rechercher l’usage : demandez au client de consulter les journaux du service concerné depuis la date du commit pour détecter un usage non légitime.
  4. Réécrire l’historique, si nécessaire : avec git filter-repo (recommandé aujourd’hui plutôt que git filter-branch), puis un push forcé et une invalidation des clones et des forks. C’est une opération lourde, jamais suffisante seule : les copies existantes et les caches du fournisseur d’hébergement peuvent conserver l’ancien contenu. Voir la documentation de l’hébergeur.
  5. Prévenir la récidive : hook de pré-commit, analyse en intégration continue, gestionnaire de secrets, fichiers de configuration ignorés (.gitignore).

Dans le rapport

  • Indiquez la règle déclenchée, le dépôt, le fichier, le commit, l’auteur et la date, sans le secret en clair.
  • Précisez si le secret a été vérifié, par qui et comment ; sinon, notez-le comme « non vérifié ».
  • Classez la gravité selon ce que le secret permet, pas selon sa seule présence : un jeton de test sans droits n’a pas le poids d’une clé d’administration de production.
  • Recommandez la rotation en premier, puis le nettoyage de l’historique et la prévention.

Sources

Ressources liées

  • Méthodologie · Pentest web · Pentest infra et AD · Cloud

    Cadrage d’un pentest

    Checklist de cadrage d’un test d’intrusion : périmètre, autorisations écrites, contacts d’urgence, comptes de test et gestion des données.

    Publié le

  • Outil · Pentest web · Pentest infra et AD

    Calculateur CVSS 3.1

    Calculez le score de base CVSS 3.1 d’une vulnérabilité, sa sévérité et son vecteur, ou collez un vecteur existant pour le relire. Calcul local.

    Publié le

  • Cheatsheet · Pentest web

    Cheatsheet Burp Suite

    Burp Suite pour un test web autorisé : proxy et certificat, périmètre, historique HTTP, Repeater, Intruder prudent, Decoder et export de preuves.

    Publié le

BEAROPS

Besoin d’une investigation OSINT ?

BEAROPS conduit des investigations OSINT de quelques jours à plusieurs semaines, à partir de sources ouvertes et dans un cadre légal.