Fichiers et antivirus¶
Tout fichier déposé dans l'instance (ticket PUT /f/up/…, opération core.file.put, pièce jointe d'un hub MCP) est
analysé avant d'être enregistré. Un fichier infecté, ou qui n'a pas pu être analysé, est refusé : le dépôt échoue et
rien n'est conservé.
L'antivirus livré avec l'instance¶
Le compose du produit démarre deux services :
| Service | Rôle | Réseau |
|---|---|---|
clamav |
Le moteur d'analyse (clamd), seul à écouter sur le port 3310 | scan (interne : aucune sortie, joignable de web et gateway uniquement) |
freshclam |
Met à jour les signatures toutes les 2 heures | egress (seul à sortir sur Internet), n'écoute rien |
Les signatures vivent dans le volume clamav-db, écrit par freshclam et relu par clamav (toutes les dix minutes).
Ce volume est reconstructible : il n'est pas à sauvegarder. L'image est celle de l'infrastructure nway, à version fixe.
Comptez environ 1 Go de mémoire pour clamav.
Au tout premier démarrage les signatures embarquées dans l'image servent tout de suite ; freshclam les met à jour ensuite.
Tant que clamav n'est pas prêt, les dépôts sont refusés (« antivirus indisponible ») : le démarrage de l'instance, lui,
n'attend pas.
Le réglage files.clamav¶
C'est une liste d'adresses hôte:port de scanners clamd. Défaut : ["clamav:3310"].
- Tous les scanners listés doivent répondre « OK » : c'est cumulatif (deux moteurs valent mieux qu'un).
- Un scanner injoignable, trop lent ou qui répond autre chose refuse le fichier (échec fermé, erreur
scan_unavailable, HTTP 503). - Un fichier détecté est refusé avec l'erreur
infected(HTTP 422). - Une liste vide désactive l'analyse (non recommandé ; les fichiers sont alors marqués « non analysés »).
- Une simple chaîne
hôte:portest toujours acceptée (anciens réglages) ; elle est convertie en liste au démarrage.
Changer de moteur, par exemple pour utiliser un clamd que vous gérez déjà :
docker exec -i web harness-admin op core.config.set --json '{"key":"files.clamav","value":["clamd-central:3310"]}'
Ajouter un second moteur : ["clamav:3310","clamd-central:3310"]. Le service doit alors être joignable depuis web et
gateway (réseau Docker partagé).
Vérifier que ça marche¶
Déposez le fichier d'essai EICAR (une chaîne inoffensive que tous les antivirus détectent, voir eicar.org) : le dépôt doit
échouer avec « fichier refusé par l'antivirus ». Puis arrêtez clamav : un dépôt normal doit échouer avec « antivirus
indisponible ». Dans les deux cas, aucun fichier n'est conservé.
Instances de test¶
La pile de test hermétique n'a aucune sortie vers Internet : freshclam ne peut pas y télécharger de signatures, c'est
pourquoi ClamAV y est optionnel (profil compose clamav). Dans ce cas, réglez files.clamav sur [] ou démarrez un
clamd factice.