# Antivirus

> Faites analyser par ClamAV les fichiers que vos utilisateurs envoient, et n'acceptez que ceux déclarés sains.

Le module Antivirus analyse les fichiers que votre [wakapp](/v1.0/glossaire#wakapp) reçoit de ses utilisateurs : pièces jointes, justificatifs, imports. Votre serveur envoie le fichier à l'API publique de Wakastart, le moteur ClamAV l'examine en tâche de fond, puis vous recevez le verdict `CLEAN` ou `INFECTED`.

Vous n'installez rien, vous ne mettez à jour aucune base de signatures : Wakastart exploite le moteur et le tient à jour. Chaque analyse consomme un [crédit](/v1.0/glossaire#crédit).

## Comment ça marche

```mermaid
sequenceDiagram
  autonumber
  participant U as Utilisateur
  participant S as Serveur de votre wakapp
  participant A as API Wakastart<br/>/api/antivirus/scans
  participant C as ClamAV<br/>(file d'attente)
  U->>S: Téléverse un fichier
  S->>A: POST /api/antivirus/scans (multipart)
  A-->>S: 201 · id du scan, statut PENDING
  A->>C: Analyse en tâche de fond
  C-->>A: CLEAN ou INFECTED
  alt Webhook configuré
    A->>S: POST callbackUrl, signé HMAC-SHA256
  else Interrogation
    S->>A: GET /api/antivirus/scans/{id}/status
  end
  S-->>U: Fichier accepté ou refusé
```

1. Votre serveur conserve le fichier reçu et l'envoie à `POST /api/antivirus/scans`. La réponse arrive tout de suite, avec l'identifiant du scan au statut `PENDING`.
2. Wakastart place le fichier en file d'attente, puis ClamAV l'analyse. Le statut passe à `SCANNING`, puis à `CLEAN` ou `INFECTED`.
3. Vous obtenez le verdict par un [webhook](/v1.0/glossaire#webhook) signé, ou en interrogeant l'API.
4. Un fichier infecté est isolé en quarantaine chez Wakastart. Votre serveur libère sa propre copie seulement si le verdict est `CLEAN`.

Le [cycle de vie d'une analyse](/v1.0/antivirus/cycle-de-vie-d-une-analyse) détaille chaque statut et les nouvelles tentatives automatiques.

## Choisissez votre approche

::::cards{cols=2}
:::card{title="Webhook" href="/v1.0/antivirus/recevoir-le-resultat-par-webhook" icon="Webhook"}
Wakastart appelle votre URL dès que le verdict est connu. Recommandé en production : aucune requête inutile, réaction immédiate.
:::
:::card{title="Interrogation" href="/v1.0/antivirus/suivre-une-analyse" icon="RefreshCw"}
Votre serveur demande le statut à intervalles réguliers. Adapté aux scripts, aux traitements par lot et aux serveurs qui ne peuvent pas recevoir d'appels entrants.
:::
::::

Les deux approches se combinent : un webhook pour réagir vite, une interrogation de rattrapage pour les analyses terminées en erreur, qui ne déclenchent pas de webhook.

## Commencer

::::cards{cols=3}
:::card{title="Démarrage rapide" href="/v1.0/antivirus/demarrage-rapide" icon="Rocket"}
Analyser un premier fichier en cURL en cinq minutes.
:::
:::card{title="Autoriser votre serveur" href="/v1.0/antivirus/autoriser-votre-serveur" icon="KeyRound"}
Obtenir une clé API dotée des bons droits et vérifier vos crédits.
:::
:::card{title="Envoyer un fichier" href="/v1.0/antivirus/envoyer-un-fichier" icon="Upload"}
Soumettre un fichier, régler sa priorité et son webhook.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Analyse asynchrone" href="/v1.0/antivirus/cycle-de-vie-d-une-analyse" icon="Timer"}
Une réponse immédiate, un verdict en quelques secondes, trois tentatives en cas d'incident technique.
:::
:::card{title="Webhook signé" href="/v1.0/antivirus/recevoir-le-resultat-par-webhook" icon="ShieldCheck"}
Chaque notification porte une signature HMAC-SHA256 que vous vérifiez avec votre secret.
:::
:::card{title="Quarantaine" href="/v1.0/antivirus/quarantaine-et-politique" icon="Lock"}
Les fichiers infectés sont isolés et ne vous sont jamais renvoyés.
:::
:::card{title="Priorités" href="/v1.0/antivirus/envoyer-un-fichier" icon="ListOrdered"}
Faites passer un fichier urgent devant les autres dans la file d'attente.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Crédits" href="/v1.0/credits" icon="Coins"}
Suivre et recharger le solde consommé par les analyses.
:::
:::card{title="Clés API" href="/v1.0/cles-api" icon="KeyRound"}
Authentifier les appels de votre serveur.
:::
:::card{title="Données de santé (HDS)" href="/v1.0/hds" icon="HeartPulse"}
Stocker des documents de santé chiffrés et tracés.
:::
::::

## Ressources

- [Référence de l'antivirus](/v1.0/antivirus/reference) : objet scan, statuts, webhook, erreurs, limites.
- [Référence API — Antivirus](/v1.0/reference-api/antivirus) : endpoints détaillés.
- [Limites et quotas](/v1.0/limites) : limites de débit de l'API publique.
- [Résoudre les problèmes d'analyse](/v1.0/antivirus/depannage).
