Autoriser votre serveur à lancer des analyses
Préparez une clé API rattachée à votre application, dotée des droits antivirus, et vérifiez que le client dispose de crédits.
- Accès requis
- Droits « Lancer un scan antivirus » et « Voir le module antivirus »
- Durée
- 10 min
L'API antivirus vérifie trois choses à chaque appel : l'identité de l'appelant, ses droits applicatifs et le solde de crédits de son client. Ce guide prépare les trois, une fois pour toutes, avant votre premier envoi.
Avant de commencer
- Votre application existe sur Wakastart. Elle est créée par Wakastart ; contactez-nous pour en ouvrir une.
- Vous pouvez créer des clés API et gérer les profils de votre client. Voir Clés API et Droits et profils.
Choisir le mode d'authentification
L'API publique accepte deux façons de s'authentifier pour l'antivirus :
| Mode | En-tête | Quand l'utiliser |
|---|---|---|
| Clé API | x-api-key: sk_… | Votre serveur envoie les fichiers en son nom propre. Recommandé. |
| Jeton de l'utilisateur | Authorization: Bearer <jeton> | Votre serveur relaie la demande d'un utilisateur connecté, avec le jeton Keycloak émis pour votre application. |
Dans les deux cas, l'appel doit porter un client et une application. Une clé API sans application rattachée est refusée par l'antivirus.
Donner les droits antivirus
Deux droits applicatifs gouvernent l'antivirus :
| Droit affiché | Code | Permet |
|---|---|---|
| Lancer un scan antivirus | antivirus.scan | Envoyer un fichier : POST /api/antivirus/scans |
| Voir le module antivirus | antivirus.read | Lire le statut et le détail d'un scan |
- Dans la console, ouvrez le profil que portera la clé API (ou l'utilisateur).
- Ajoutez les droits Lancer un scan antivirus et Voir le module antivirus.
- Enregistrez le profil.
Résultat : toute clé ou tout utilisateur portant ce profil peut envoyer des fichiers et suivre leurs analyses.
Créer la clé API
- Créez une clé API rattachée à votre client et à votre application, avec le profil préparé à l'étape précédente. La procédure complète est dans Clés API.
- Copiez la valeur
sk_…affichée : elle n'est montrée qu'une fois. - Rangez-la dans le gestionnaire de secrets de votre serveur, jamais dans le code ni dans une application mobile ou un navigateur.
Vérifier le solde de crédits
Chaque analyse consomme 1 crédit sur le solde du client rattaché à la clé. Consultez ce solde et rechargez-le si besoin depuis Crédits. Sans crédit, l'envoi est refusé avec une erreur 402.
Vérifier le résultat
Envoyez un petit fichier de test :
curl -X POST "https://api.wakastart.app/api/antivirus/scans" \
-H "x-api-key: sk_test_exemple" \
-F "file=@test.txt"Une réponse 201 avec "status": "PENDING" confirme que l'authentification, les droits et les crédits sont en place. Les autres réponses sont expliquées dans le dépannage :
401: la clé est absente ou invalide ;403avecDroit applicatif requis : antivirus.scan: le profil de la clé n'a pas le droit ;402: le solde de crédits est vide.