Accueil » Formations » Administration sécurité » Analyse de vulnérabilités et SBOM avec Trivy » TP03 – Analyser un projet : dépendances et secrets

TP03 – Analyser un projet : dépendances et secrets

← Analyse de vulnérabilités et SBOM avec Trivy

// travaux pratiques · Administration sécurité

TP03 - Analyser un projet : dépendances et secrets

  • TP 3 / 6
  • 6 étapes
  • ≈ 45 min
  • Accès libre

Objectif : analyser le répertoire d’un projet applicatif avant toute construction d’image, détecter des dépendances vulnérables et un secret oublié, ajouter une règle de détection propre à l’organisation, puis corriger et vérifier.

Contexte

Plus une vulnérabilité est détectée tôt, moins elle coûte : modifier une ligne de requirements.txt dans une demande de fusion prend une minute, alors que la même correction sur une application en production impose une reconstruction, des tests et une fenêtre de déploiement. Le même raisonnement vaut pour les secrets : un jeton d’accès poussé dans un dépôt partagé doit être considéré comme compromis. Dans une petite équipe, l’analyse se lance à la main sur le poste de développement ; dans une grande organisation, elle s’exécute sur chaque demande de fusion et les règles de secrets incluent les formats de jetons internes.

À la fin de ce TP, vous saurez analyser un projet avec trivy fs, interpréter les sections par fichier, écrire une règle de secret personnalisée et conduire la correction jusqu’à un rapport propre.

Prérequis : TP01 réalisé ; un éditeur de texte sur la machine de laboratoire.

Durée estimée : 45 minutes.

Actions à réaliser

  1. Créer un projet de démonstration. On simule une application Python dont les dépendances n’ont pas été mises à jour depuis plusieurs années. Les versions doivent être épinglées avec == pour que Trivy les identifie précisément.

    mkdir -p ~/lab-trivy/app/config
    cd ~/lab-trivy/app
    cat > requirements.txt <<'EOF'
    Django==3.2.0
    requests==2.19.0
    PyYAML==5.3
    EOF

    Résultat attendu : le fichier requirements.txt contient les trois lignes.

  2. Analyser les dépendances.

    trivy fs --scanners vuln .

    Résultat attendu : une section requirements.txt (pip) listant plusieurs vulnérabilités pour Django, requests et PyYAML, avec pour chacune la version corrigée. Notez la version minimale qui corrige toutes les lignes de chaque paquet : c’est la cible de mise à jour.

  3. Simuler un secret oublié. On ajoute un fichier de configuration contenant un jeton au format d’un jeton personnel GitHub. La valeur est fictive : n’utilisez jamais un vrai jeton dans un exercice.

    cat > config/settings.env <<'EOF'
    APP_ENV=production
    GITHUB_TOKEN=ghp_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
    EOF
    trivy fs --scanners secret .

    Le scanner de secrets est actif par défaut pour fs ; on le sélectionne seul ici pour isoler le résultat. Résultat attendu : une section config/settings.env (secrets) avec une ligne identifiant un jeton GitHub, sa gravité, et l’extrait de la ligne où la valeur est masquée par des astérisques.

  4. Ajouter une règle propre à l’organisation. Supposons que vos applications internes utilisent des jetons de la forme AZT- suivie de 32 caractères hexadécimaux. On décrit ce format dans trivy-secret.yaml, fichier lu automatiquement s’il se trouve dans le répertoire courant.

    cat > trivy-secret.yaml <<'EOF'
    rules:
      - id: jeton-interne-azt
        category: Interne
        title: Jeton d'API interne
        severity: HIGH
        keywords:
          - AZT-
        regex: AZT-[0-9a-f]{32}
    EOF
    echo "INTERNAL_API_TOKEN=AZT-0123456789abcdef0123456789abcdef" >> config/settings.env
    trivy fs --scanners secret .

    Le champ keywords sert de pré-filtre : seuls les fichiers contenant ce mot sont soumis à l’expression régulière, ce qui accélère l’analyse. Les règles intégrées restent actives. Résultat attendu : deux constats dans config/settings.env, le jeton GitHub et le jeton interne avec le titre « Jeton d’API interne ».

  5. Corriger les dépendances. Remplacez dans requirements.txt chaque version par une version au moins égale à la plus haute « Fixed Version » relevée à l’étape 2 (en pratique, la dernière version de la branche supportée), puis relancez l’analyse en ne gardant que l’essentiel.

    trivy fs --scanners vuln --severity HIGH,CRITICAL --ignore-unfixed .

    Résultat attendu : plus aucune ligne HIGH ou CRITICAL corrigeable pour les trois paquets. S’il en reste, la version choisie est encore trop ancienne pour l’une des vulnérabilités.

  6. Traiter les secrets. Dans un cas réel, l’ordre est : révoquer le jeton chez le fournisseur, en émettre un nouveau, le ranger dans un coffre ou une variable protégée du pipeline, puis retirer la valeur du fichier. Ici, remplacez les deux valeurs par des références à des variables d’environnement.

    sed -i 's/^GITHUB_TOKEN=.*/GITHUB_TOKEN=$GITHUB_TOKEN/; s/^INTERNAL_API_TOKEN=.*/INTERNAL_API_TOKEN=$INTERNAL_API_TOKEN/' config/settings.env
    trivy fs --scanners secret .

    Résultat attendu : le fichier ne contient plus que des références de variables et le rapport n’affiche plus aucune section de secrets.

Vérification

Le TP est réussi si trivy fs --scanners vuln,secret --severity HIGH,CRITICAL --ignore-unfixed . ne renvoie plus de constat, si config/settings.env ne contient plus de valeur de jeton, et si vous savez expliquer pourquoi le jeton interne a été détecté (règle de trivy-secret.yaml).

Problèmes fréquents

  • Aucune vulnérabilité trouvée dans requirements.txt. Cause : versions non épinglées (>= ou absence de version), que Trivy ne peut pas résoudre sans fichier de verrouillage. Correction : épingler avec == ou analyser un fichier généré par pip freeze.
  • La règle interne ne déclenche pas. Cause : trivy-secret.yaml absent du répertoire courant, erreur d’indentation YAML, ou mot-clé différent de la valeur. Correction : lancer depuis le répertoire du projet ou passer le fichier avec --secret-config, et valider l’indentation.
  • Un faux positif dans la documentation ou les tests. Cause : un exemple de jeton dans un fichier Markdown ou un jeu de test. Correction : exclure le chemin avec --skip-dirs ou --skip-files, ou documenter l’identifiant de règle dans .trivyignore (TP06).
  • Analyse lente sur un gros projet. Cause : parcours de répertoires volumineux (node_modules, artefacts de construction). Correction : les exclure avec --skip-dirs.

Bonnes pratiques et sécurité

  • Un secret détecté est un secret compromis : révoquez-le avant de le retirer du code, car il reste dans l’historique Git et peut avoir été copié.
  • Gardez les secrets dans un coffre (Vault, gestionnaire de secrets du cloud ou de la forge) et injectez-les au moment de l’exécution ; ajoutez les fichiers .env au .gitignore.
  • Versionnez trivy-secret.yaml dans un dépôt commun pour que toutes les équipes détectent les formats de jetons internes.
  • Épinglez les dépendances et générez des fichiers de verrouillage : ils rendent l’analyse exacte et les constructions reproductibles.

Questions de contrôle

1. Pourquoi Trivy ne signale-t-il rien pour une dépendance déclarée requests>=2.0 ?

Voir la réponse

Parce que la version installée n’est pas déterminée : sans version précise ni fichier de verrouillage, Trivy ne peut pas la comparer aux avis.

2. À quoi sert le champ keywords d’une règle de secret ?

Voir la réponse

À présélectionner les fichiers contenant le mot-clé avant d’appliquer l’expression régulière, ce qui accélère l’analyse et limite les faux positifs.

3. Que faire en premier lorsqu’un jeton réel est détecté dans un dépôt ?

Voir la réponse

Le révoquer et en émettre un nouveau ; supprimer la ligne ne suffit pas, la valeur reste dans l’historique.

Pour aller plus loin

Sur une forge auto-hébergée comme Forgejo, la même commande peut s’exécuter à chaque demande de fusion. Notez que Trivy analyse l’état des fichiers d’un commit et non tout l’historique : pour retrouver un secret supprimé depuis, il faut un outil dédié à l’historique Git. Les bases de Git sont rappelées dans le cours Git : les fondamentaux du contrôle de version.

Conservez le répertoire ~/lab-trivy/app : il sera réutilisé dans les TP05 et TP06.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut