// travaux pratiques · Administration sécurité
TP06 - Intégrer Trivy dans un pipeline CI
- TP 6 / 6
- 6 étapes
- ≈ 60 min
- Accès libre
Objectif : transformer les analyses des TP précédents en contrôle automatique : politique commune dans trivy.yaml, exceptions datées dans .trivyignore, script de pipeline qui bloque une livraison dangereuse, serveur Trivy centralisé et intégration dans une forge en épinglant les versions.
Contexte
Une analyse lancée à la main dépend de la mémoire et de la disponibilité de quelqu’un. Intégrée à la chaîne d’intégration continue, elle devient une règle : aucune image avec une vulnérabilité critique corrigeable ne part en production sans décision explicite. Encore faut-il que la règle soit acceptée par les équipes, donc que le bruit soit maîtrisé et que les exceptions soient possibles mais tracées. Dans une petite structure, un seul pipeline et un fichier de politique suffisent ; dans un grand groupe, la même politique est partagée par des centaines de dépôts et un serveur Trivy évite que chaque tâche télécharge la base.
À la fin de ce TP, vous saurez écrire une politique d’analyse, gérer des exceptions qui expirent, faire échouer un pipeline à bon escient, mettre en place le mode client/serveur et appliquer les leçons de l’incident de mars 2026.
Prérequis : TP01 à TP05 réalisés (répertoires ~/lab-trivy/app, ~/lab-trivy/iac et ~/sbom) ; openssl installé.
Durée estimée : 60 minutes.
Actions à réaliser
Écrire la politique commune. Le fichier
trivy.yamlreprend les options de la ligne de commande, regroupées par thème ; il est lu automatiquement dans le répertoire courant ou désigné par--config.cd ~/lab-trivy/app cat > trivy.yaml <<'EOF' severity: - HIGH - CRITICAL exit-code: 1 scan: scanners: - vuln - secret - misconfig vulnerability: ignore-unfixed: true EOF trivy fs . echo $?Résultat attendu : l’analyse applique les trois scanners et les filtres sans aucune option sur la ligne de commande ; le code de sortie est
0puisque le projet a été corrigé au TP03. En cas de doute sur le nom d’une clé, l’option--generate-default-configproduit un fichier de référence complet.Provoquer un échec puis documenter une exception. Réintroduisez une dépendance vulnérable pour vérifier que la politique bloque.
echo "requests==2.19.0" >> requirements.txt trivy fs . echo $?Résultat attendu : le rapport liste au moins une vulnérabilité
HIGHouCRITICALde requests et le code de sortie vaut1. Supposons qu’une contrainte métier empêche la mise à jour pendant deux mois : on documente l’exception, datée, dans.trivyignore, en reprenant l’identifiant affiché.cat > .trivyignore <<'EOF' # requests 2.19 conservé jusqu'à la migration de l'API (ticket SEC-142), validé par le RSSI CVE-2018-18074 exp:2027-01-31 EOF trivy fs --show-suppressed . echo $?Résultat attendu : la vulnérabilité ignorée apparaît dans une section des éléments supprimés ; si toutes les lignes bloquantes sont couvertes, le code de sortie redevient
0. S’il reste d’autres identifiants, ajoutez-les de la même façon ou, mieux, corrigez la dépendance. Le 1er février 2027, l’exception expirera et le pipeline échouera de nouveau.Écrire le script de pipeline. Le script enchaîne une passe informative, une passe bloquante, l’audit du Dockerfile et la production du SBOM.
set -earrête le script à la première commande en échec.cat > ~/lab-trivy/ci-trivy.sh <<'EOF' #!/bin/sh set -e cd ~/lab-trivy/app echo "== Passe informative" trivy fs --exit-code 0 --severity MEDIUM,HIGH,CRITICAL --scanners vuln . echo "== Passe bloquante (politique trivy.yaml)" trivy fs . echo "== Audit du Dockerfile" trivy config --exit-code 1 --severity HIGH,CRITICAL ~/lab-trivy/iac echo "== SBOM de la livraison" mkdir -p ~/sbom/app/1.0.1 trivy fs --format cyclonedx --output ~/sbom/app/1.0.1/app.cdx.json . echo "Contrôles réussis" EOF chmod +x ~/lab-trivy/ci-trivy.sh ~/lab-trivy/ci-trivy.shRésultat attendu : les quatre sections s’affichent et le script se termine par « Contrôles réussis ». Retirez la ligne de
.trivyignoreet relancez : le script s’arrête après la passe bloquante, sans produire le SBOM, exactement comme un pipeline refusant la livraison.Centraliser la base avec le mode client/serveur. Le serveur détient la base et traite les vulnérabilités ; un jeton empêche son usage par des clients non autorisés.
export TRIVY_TOKEN=$(openssl rand -hex 24) trivy server --listen 127.0.0.1:4954 --token "$TRIVY_TOKEN" & sleep 5 trivy fs --server http://127.0.0.1:4954 --token "$TRIVY_TOKEN" --scanners vuln ~/lab-trivy/app trivy fs --server http://127.0.0.1:4954 --token mauvais --scanners vuln ~/lab-trivy/appRésultat attendu : la première analyse produit le même rapport qu’en local ; la seconde échoue avec une erreur d’authentification. Arrêtez ensuite le serveur avec
kill %1. En production, le serveur écoute sur une interface interne, derrière un proxy TLS, et le jeton est fourni aux pipelines comme variable protégée.Intégrer l’analyse dans une forge en épinglant les versions. Exemple de tâche GitLab CI qui exécute Trivy dans son image officielle. L’image est désignée par son empreinte, relevée après vérification de sa signature avec cosign, et non par une étiquette.
trivy_scan: stage: test image: name: aquasec/trivy@sha256:<empreinte-vérifiée> entrypoint: [""] script: - trivy fs --config trivy.yaml .Sur GitHub, l’action officielle s’épingle de la même manière sur l’empreinte complète d’un commit :
uses: aquasecurity/trivy-action@<empreinte-de-commit-de-40-caractères>, avec la version en commentaire. Résultat attendu : une tâche qui échoue lorsque la politique est violée et dont l’outil ne peut pas changer à votre insu.Réanalyser chaque nuit les inventaires archivés. Les vulnérabilités publiées après une livraison n’apparaissent dans aucun pipeline ; la réanalyse des SBOM les fait remonter.
for f in ~/sbom/*/*/*.cdx.json; do echo "== $f" trivy sbom --severity CRITICAL --ignore-unfixed "$f" doneRésultat attendu : un rapport par inventaire ; l’image ancienne du TP05 affiche des vulnérabilités critiques, la version 1.0.1 de l’application aucune. Planifiée avec cron ou un minuteur systemd, cette boucle devient une alerte quotidienne.
Vérification
Le TP est réussi si ci-trivy.sh se termine avec le code 0 lorsque l’exception est présente et avec un code non nul lorsqu’elle est retirée, si le SBOM ~/sbom/app/1.0.1/app.cdx.json est produit par l’exécution réussie et non par l’exécution en échec (supprimez-le avant le second essai pour le constater), si le serveur refuse le mauvais jeton, et si votre exemple de tâche CI ne contient aucune étiquette modifiable.
Problèmes fréquents
- L’exception n’est pas prise en compte. Cause :
.trivyignoreabsent du répertoire d’exécution, identifiant mal recopié, ou date d’expiration déjà passée. Correction : lancer depuis la racine du projet ou passer--ignorefile, recopier l’identifiant exact du rapport, vérifier la date. - « connection refused » côté client. Cause : serveur pas encore prêt (il charge la base) ou adresse d’écoute différente. Correction : attendre quelques secondes, vérifier l’adresse avec
ss -ltnp. - Le pipeline échoue de façon aléatoire au téléchargement de la base. Cause : limitation de débit du registre public lorsque de nombreuses tâches démarrent en même temps. Correction : mode client/serveur, miroir interne de la base (
--db-repository), ou cache partagé entre tâches. - Le pipeline ne bloque jamais. Cause :
exit-codeabsent de la configuration ou fichiertrivy.yamlnon lu. Correction : vérifier le code de sortie avececho $?et passer explicitement--config trivy.yaml.
Bonnes pratiques et sécurité
- Épingler l’image de Trivy et les actions de CI sur une empreinte, vérifier la signature avant chaque changement de version : c’est la principale recommandation de l’avis CVE-2026-33634.
- Ne donner à la tâche d’analyse que les droits nécessaires : lecture du code et du registre, aucun secret de déploiement.
- Faire relire les ajouts à
.trivyignorecomme du code, avec une date d’expiration et une référence de ticket obligatoires. - Commencer en mode informatif, mesurer, puis bloquer : une politique trop stricte dès le premier jour pousse les équipes à la contourner.
- Conserver les rapports et les SBOM de chaque livraison : ils constituent la preuve des contrôles réalisés en cas d’audit.
Questions de contrôle
1. Que se passe-t-il le lendemain de la date indiquée par exp: dans .trivyignore ?
Voir la réponse
L’exception cesse de s’appliquer : la vulnérabilité réapparaît dans le rapport et, avec exit-code: 1, le pipeline échoue de nouveau.
2. Pourquoi épingler l’image Trivy par empreinte plutôt que par étiquette ?
Voir la réponse
Une étiquette peut être déplacée vers un autre contenu, comme lors de l’incident de mars 2026 ; une empreinte désigne un contenu unique et immuable.
3. Dans le mode client/serveur, où s’exécute la recherche de secrets ?
Voir la réponse
Sur le client : le serveur ne traite que les vulnérabilités et les licences, si bien que le code source n’a pas à lui être envoyé.
Pour aller plus loin
Pour structurer les étapes de construction, de test et de déploiement autour de ces contrôles, suivez le cours Introduction à la chaîne CI/CD. Trivy couvre l’analyse statique ; pour tester l’application web une fois déployée en préproduction, ajoutez un scanner dynamique comme ZAP. Sur un grand parc, exportez les résultats au format SARIF ou JSON vers votre outil de suivi pour piloter les délais de correction par équipe.
Le laboratoire peut maintenant être supprimé (rm -rf ~/lab-trivy, puis trivy clean --all pour vider le cache) ; conservez ~/sbom si vous souhaitez poursuivre l’exercice de réanalyse.
// 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.