Aller au contenu

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:port est 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.