Accueil » Formations » Administration sécurité » Analyse de vulnérabilités et SBOM avec Trivy » TP01 – Préparer le laboratoire et installer Trivy

TP01 – Préparer le laboratoire et installer Trivy

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

// travaux pratiques · Administration sécurité

TP01 - Préparer le laboratoire et installer Trivy

  • TP 1 / 6
  • 7 étapes
  • ≈ 30 min
  • Accès libre

Objectif : préparer une machine de laboratoire, y installer Trivy depuis le dépôt officiel signé, télécharger ses bases de données et réaliser une première analyse pour valider l’ensemble.

Contexte

Avant d’analyser quoi que ce soit, il faut un outil installé proprement : depuis une source officielle, avec une signature vérifiée, dans une version connue. Ce point est souvent bâclé (« un curl et c’est parti ») alors qu’un scanner de sécurité voit passer des images, du code source et parfois des secrets. Dans une petite structure, la machine de laboratoire deviendra souvent le poste d’administration qui lancera les analyses ; dans un grand groupe, elle sert de banc d’essai pour valider une version avant de la déployer dans les pipelines et sur le serveur central.

À la fin de ce TP, vous disposerez d’une machine Debian ou Ubuntu équipée de Trivy, vous saurez où se trouvent ses bases et comment les mettre à jour, et vous aurez vérifié que l’outil fonctionne de bout en bout.

Prérequis : une machine virtuelle Debian 12 ou 13, ou Ubuntu 24.04 LTS, avec 2 vCPU, 4 Go de mémoire, 20 Go de disque libre et un accès Internet sortant en HTTPS ; un compte disposant de sudo. Les commandes sont données pour Debian et Ubuntu ; la variante RHEL est indiquée à l’étape 2.

Durée estimée : 30 minutes.

Actions à réaliser

  1. Mettre la machine à jour. On part d’un système à jour pour éviter que des erreurs de paquets ne se mélangent aux erreurs d’installation de Trivy.

    sudo apt-get update
    sudo apt-get -y upgrade
    sudo apt-get install -y wget gnupg

    Résultat attendu : les commandes se terminent sans erreur ; wget et gnupg sont installés (ils servent à récupérer et convertir la clé du dépôt).

  2. Déclarer le dépôt officiel et sa clé. La clé publique du dépôt est convertie au format binaire et rangée dans /usr/share/keyrings ; l’option signed-by limite son usage à ce seul dépôt, ce qui évite qu’une clé tierce puisse signer des paquets pour toute la machine.

    wget -qO - https://aquasecurity.github.io/trivy-repo/deb/public.key | gpg --dearmor | sudo tee /usr/share/keyrings/trivy.gpg > /dev/null
    echo "deb [signed-by=/usr/share/keyrings/trivy.gpg] https://aquasecurity.github.io/trivy-repo/deb generic main" | sudo tee -a /etc/apt/sources.list.d/trivy.list

    Le mot generic remplace le nom de code de la distribution : le même dépôt sert toutes les versions de Debian et d’Ubuntu. Résultat attendu : le fichier /etc/apt/sources.list.d/trivy.list contient une seule ligne identique à celle de la commande. Sur RHEL, Rocky ou AlmaLinux, la documentation officielle décrit un fichier /etc/yum.repos.d/trivy.repo pointant vers https://aquasecurity.github.io/trivy-repo/rpm/releases/$basearch/ avec gpgcheck=1, puis l’installation par sudo yum -y install trivy.

  3. Installer Trivy.

    sudo apt-get update
    sudo apt-get install -y trivy
    trivy --version

    Résultat attendu : apt-get update affiche une ligne de récupération pour aquasecurity.github.io/trivy-repo/deb generic sans avertissement de signature ; trivy --version affiche Version: suivi du numéro installé (branche 0.76 en novembre 2026). Notez ce numéro : c’est la version que vous validerez pour la suite.

  4. Figer la version. En production, une mise à jour automatique de l’outil peut changer les résultats ou, comme en mars 2026, introduire une version compromise. On bloque donc le paquet et on le mettra à jour volontairement.

    sudo apt-mark hold trivy
    apt-mark showhold

    Résultat attendu : apt-mark showhold affiche trivy. Pour une mise à jour planifiée, on lèvera le blocage avec sudo apt-mark unhold trivy après avoir lu les notes de version.

  5. Télécharger les bases. Trivy télécharge sa base de vulnérabilités au premier scan ; on peut le faire à l’avance, ce qui sert aussi à préparer une machine qui sera ensuite déconnectée.

    trivy image --download-db-only
    trivy --version

    Résultat attendu : des lignes INFO indiquent le téléchargement de la base de vulnérabilités depuis un registre OCI (mirror.gcr.io/aquasec/trivy-db par défaut) ; la seconde commande affiche désormais, en plus de la version du binaire, les informations de la base : version du schéma et dates de mise à jour. La base est stockée dans le répertoire de cache de l’utilisateur (option --cache-dir, dont la valeur par défaut est indiquée par trivy --help).

  6. Lancer une première analyse. On analyse une image publique ancienne, choisie précisément parce qu’elle contient des vulnérabilités connues. Trivy la récupère directement dans le registre : Docker n’est pas nécessaire.

    trivy image --severity CRITICAL alpine:3.15

    Résultat attendu : un en-tête indiquant la cible (l’image et sa distribution Alpine 3.15), un total par gravité limité ici à CRITICAL, puis un tableau listant bibliothèque, identifiant, gravité, statut, version installée et version corrigée. Selon la date, Trivy peut aussi signaler que cette version d’Alpine n’est plus prise en charge par la distribution.

  7. Tester le fonctionnement hors ligne. On relance la même analyse sans mise à jour des bases, comme sur une machine isolée.

    trivy image --skip-db-update --severity CRITICAL alpine:3.15

    Résultat attendu : le même tableau, obtenu plus vite, sans ligne de téléchargement de la base. L’image est en revanche toujours récupérée depuis le registre : sur un réseau réellement isolé, elle devra provenir d’un registre interne.

Vérification

Le TP est réussi si : trivy --version affiche la version du binaire et celle de la base ; apt-mark showhold liste trivy ; l’analyse de alpine:3.15 produit un tableau ; la commande apt-cache policy trivy montre que le paquet provient bien de aquasecurity.github.io/trivy-repo.

Problèmes fréquents

  • « The repository … does not have a Release file ». Cause : la ligne du dépôt utilise le nom de code de la distribution (méthode de tutoriels anciens), absent du dépôt pour les versions récentes. Correction : remplacer le nom de code par generic dans trivy.list, puis relancer sudo apt-get update.
  • « NO_PUBKEY » ou « signatures were invalid ». Cause : la clé n’a pas été écrite dans /usr/share/keyrings/trivy.gpg (commande coupée, faute dans le chemin signed-by). Correction : vérifier que le fichier existe et n’est pas vide, relancer la commande de l’étape 2.
  • Échec du téléchargement de la base derrière un proxy. Symptôme : erreur réseau ou délai dépassé à l’étape 5. Cause : le trafic HTTPS sortant passe par un proxy non déclaré. Correction : exporter HTTPS_PROXY pour la session, ou faire ouvrir l’accès aux registres mirror.gcr.io et ghcr.io.
  • Erreur de quota (code 429) sur le registre. Cause : de nombreuses machines derrière la même adresse IP téléchargent la base. Correction : réessayer plus tard, ou, à l’échelle d’un parc, héberger la base dans un registre interne et la désigner avec --db-repository.

Bonnes pratiques et sécurité

  • Lancer Trivy avec un compte non privilégié : l’analyse d’une image distante ou d’un projet ne nécessite pas les droits root.
  • Installer uniquement depuis les sources officielles (dépôt signé, Homebrew, images signées) et vérifier les signatures avec cosign lorsqu’on télécharge une archive ou une image.
  • Bloquer la version (apt-mark hold) et la faire évoluer selon un processus documenté : lecture des notes de version, test sur cette machine, puis déploiement.
  • Considérer le répertoire de cache et les rapports comme sensibles : ils décrivent précisément les faiblesses de vos systèmes.

Questions de contrôle

1. Pourquoi l’option signed-by est-elle préférable à l’ajout de la clé dans le trousseau global ?

Voir la réponse

Parce qu’elle limite la confiance accordée à la clé au seul dépôt Trivy : la clé ne peut pas valider des paquets provenant d’autres sources.

2. Que fait trivy image --download-db-only ?

Voir la réponse

Elle télécharge ou met à jour la base de vulnérabilités dans le cache, sans analyser d’image ; c’est utile pour préparer une machine avant de la déconnecter.

3. Pourquoi figer la version de Trivy plutôt que de la laisser se mettre à jour automatiquement ?

Voir la réponse

Pour maîtriser les changements de comportement et ne pas installer automatiquement une version défectueuse ou compromise ; la mise à jour devient une décision tracée.

Pour aller plus loin

Pour comprendre la place de Trivy parmi les autres outils de sécurité open source, lisez l’article de présentation de Trivy sur le blog. Sur un grand parc, la même installation se décrit en code, par exemple avec un rôle Ansible qui déclare le dépôt, installe une version précise et la bloque.

Conservez cette machine et son cache : tous les TP suivants l’utilisent.

// 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