Agent IA et API
Faillo se connecte à votre agent IA de code. L'agent lit le rapport de sécurité de votre site, corrige les failles dans le code, puis relance un scan pour vérifier que tout est réglé. Une API REST donne le même accès à vos propres outils.
1. Créer une clé API
Dans Paramètres, rubrique « Agent IA », donnez un nom à la clé puis créez-la. Elle ne s'affiche qu'une fois : copiez-la tout de suite. Vous pouvez la supprimer à tout moment, l'agent perd alors l'accès.
2. Ajouter Faillo à votre agent IA
Faillo est un serveur MCP (Model Context Protocol) accessible en HTTP. Ajoutez cette configuration dans les réglages MCP de votre agent IA :
{
"mcpServers": {
"faillo": {
"type": "http",
"url": "https://faillo.akolads.com/mcp",
"headers": {
"Authorization": "Bearer fl_votre_cle"
}
}
}
}
3. Demander la correction
Par exemple :
Corrige les failles de sécurité de mon-site.fr signalées par Faillo, puis relance un scan pour vérifier.
L'agent utilise ces outils :
| Outil | Ce qu'il fait |
|---|---|
lister_sites | Liste les sites du compte Faillo avec leur dernière note de sécurité, le nombre de failles par gravité et les droits (rapport acheté, suivi mensuel). |
rapport_securite | Rapport du dernier scan d'un site, en Markdown avec les consignes de correction : chaque faille avec sa gravité, la preuve trouvée et le correctif (scan complet), ou la note et les catégories (scan gratuit). |
lancer_scan | Relance un scan du site pour vérifier les corrections, une fois celles-ci en ligne. Les scans sont limités (quotas de l'offre) : à n'utiliser qu'après avoir déployé des corrections. |
signaler_corrections | Envoie à Faillo le résultat du travail sur les failles du dernier scan complet : pour chaque faille (identifiant du rapport, ex. no-csp), son statut et ce qui a été fait. Signalez aussi les faux positifs et les correctifs impossibles à appliquer, avec la raison. N'y mettez ni code, ni mot de passe, ni clé. |
etat_scan | État du dernier scan d'un site : en attente, en cours, terminé (avec la note et les failles par gravité) ou en échec. |
Ce que l'agent peut voir et faire
- Les mêmes informations que vous sur le site : après un scan gratuit, la note et les catégories ; après l'achat du rapport complet, chaque faille avec sa preuve et son correctif.
- Les scans lancés par l'agent comptent dans vos quotas : un scan gratuit par jour, deux scans de vérification avec le rapport complet, un par semaine avec le suivi mensuel.
- L'agent peut envoyer son retour sur chaque faille du rapport complet (corrigée, à faire à la main, dépend de l'hébergeur, faux positif, impossible). Ces retours servent à améliorer Faillo, et les failles déclarées corrigées sont vérifiées au scan complet suivant.
- L'agent ne peut ni acheter, ni supprimer, ni modifier quoi que ce soit d'autre dans votre compte.
API REST
Toutes les requêtes portent l'en-tête Authorization: Bearer fl_votre_cle. Le site se désigne par son adresse (mon-site.fr) ou son identifiant. Limite : 120 requêtes par minute.
| Requête | Réponse |
|---|---|
GET /api/v1/sites | Vos sites, leur dernière note et leurs failles par gravité |
GET /api/v1/sites/mon-site.fr/rapport | Le rapport du dernier scan en JSON |
GET /api/v1/sites/mon-site.fr/rapport.md | Le même rapport en Markdown, avec les consignes de correction pour une IA |
POST /api/v1/sites/mon-site.fr/scans | Lance un scan de vérification (selon vos quotas) |
GET /api/v1/sites/mon-site.fr/scan | L'état du dernier scan |
POST /api/v1/sites/mon-site.fr/retours | Retours sur les failles du dernier scan complet : {"retours": [{"id": "no-csp", "statut": "corrigee", "action": "...", "remarque": "..."}]} |
Exemple :
curl -H "Authorization: Bearer fl_votre_cle" https://faillo.akolads.com/api/v1/sites/mon-site.fr/rapport.md
En cas d'erreur (clé invalide, site introuvable, quota atteint), la réponse contient un champ erreur qui explique quoi faire.
Sécurité
Seule une empreinte de votre clé est enregistrée : Faillo ne peut pas vous la renvoyer. Ne la placez jamais dans le code d'un site ni dans un dépôt partagé ; gardez-la dans les réglages de votre agent IA ou de vos outils.