Aller au contenu

Liste de contrôle avant la mise en production

Les points à vérifier avant d'ouvrir le téléversement de fichiers analysés par l'antivirus Wakastart à vos utilisateurs.

GuideDéveloppeur
Durée
15 min
Voir en Markdown

Passez cette liste en revue avant d'ouvrir à vos utilisateurs un téléversement protégé par l'antivirus. Chaque point correspond à une erreur constatée en intégration.

Accès et crédits

  • La clé API de production est rattachée au bon client et à l'application de production.
  • Son profil porte Lancer un scan antivirus et Voir le module antivirus, et rien de plus.
  • La clé est rangée dans le gestionnaire de secrets du serveur, jamais dans un front, une application mobile ou un dépôt Git.
  • Le solde de crédits du client couvre le volume attendu (1 crédit par fichier envoyé, quel que soit le verdict), avec une marge pour les pics. Voir Crédits.

Fichiers

  • Votre front et votre serveur refusent les fichiers de plus de 50 Mo avant de les envoyer.
  • Votre serveur garde sa copie du fichier jusqu'au verdict : Wakastart ne la renvoie pas.
  • Un fichier n'est servi à personne tant que son statut n'est pas CLEAN.
  • Un fichier INFECTED est supprimé de votre stockage et l'utilisateur en est informé.
  • Si vous avez besoin de restreindre les types ou extensions acceptés, une politique d'analyse a été demandée à Wakastart. Voir Quarantaine et politique.

Webhook

  • callbackUrl est en HTTPS, sur un hôte public.
  • callbackSecret est envoyé à chaque scan (64 caractères au plus) ; sans lui, aucun webhook n'arrive.
  • Le récepteur vérifie X-Webhook-Signature sur le corps brut avec une comparaison à temps constant.
  • Le récepteur traite chaque scanId une seule fois et répond 2xx en moins de 10 secondes.

Rattrapage et erreurs

  • Une tâche périodique interroge les scans restés sans verdict après quelques minutes : un scan en ERROR ne déclenche pas de webhook.
  • Les réponses 402 (crédits épuisés) et 503 (service momentanément indisponible) sont journalisées et alertent votre équipe.
  • Les envois respectent les limites de débit de l'API publique (10 requêtes par seconde, 100 par minute, 1 000 par heure et par IP), avec une file côté serveur pour les imports en masse.
  • Les imports en masse utilisent une priorité plus basse (6 à 10) que les téléversements interactifs.

Voir aussi