// 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
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 gnupgRésultat attendu : les commandes se terminent sans erreur ;
wgetetgnupgsont installés (ils servent à récupérer et convertir la clé du dépôt).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’optionsigned-bylimite 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.listLe mot
genericremplace 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.listcontient 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.repopointant vershttps://aquasecurity.github.io/trivy-repo/rpm/releases/$basearch/avecgpgcheck=1, puis l’installation parsudo yum -y install trivy.Installer Trivy.
sudo apt-get update sudo apt-get install -y trivy trivy --versionRésultat attendu :
apt-get updateaffiche une ligne de récupération pouraquasecurity.github.io/trivy-repo/deb genericsans avertissement de signature ;trivy --versionafficheVersion: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.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 showholdRésultat attendu :
apt-mark showholdaffichetrivy. Pour une mise à jour planifiée, on lèvera le blocage avecsudo apt-mark unhold trivyaprès avoir lu les notes de version.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 --versionRésultat attendu : des lignes
INFOindiquent le téléchargement de la base de vulnérabilités depuis un registre OCI (mirror.gcr.io/aquasec/trivy-dbpar 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 partrivy --help).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.15Ré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.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.15Ré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
genericdanstrivy.list, puis relancersudo 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 cheminsigned-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_PROXYpour la session, ou faire ouvrir l’accès aux registresmirror.gcr.ioetghcr.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.