SecuProbe
SYSTÈMES OPÉRATIONNELS — Tous les modules de sécurité actifs
Développeurs

SecuProbe pour les développeurs

Automatisez les tests de sécurité avec une API REST, une action GitHub, des webhooks et des scans planifiés. Cette page donne la vue d'ensemble ; la référence de l'API détaille chaque point d'entrée.

API REST

Lancez des scans, lisez leur état et listez les failles avec leur gravité et leur guide de correction. JSON sur HTTPS, authentification Bearer.

Lire la référence de l'API

CI/CD

Analysez chaque déploiement avec l'action GitHub officielle, ou appelez l'API depuis tout autre pipeline, et faites échouer le build sur une faille critique.

Configurer l'action GitHub

Webhooks

Recevez un événement sur votre adresse à la fin d'un scan. Servez-vous-en pour ouvrir des tickets, prévenir un canal ou alimenter votre propre tableau de bord.

Voir toutes les intégrations

Démarrage rapide

  1. Créez un compte et ajoutez le domaine à tester. Vérifiez sa propriété par un enregistrement DNS ou un fichier pour activer les tests actifs.
  2. Générez une clé d'API dans les paramètres du tableau de bord. Ne choisissez que les périmètres nécessaires : scans:create pour lancer des scans, scans:read pour lire les résultats.
  3. Lancez un scan avec une requête POST. La réponse contient l'identifiant du scan et l'URL à interroger.
  4. Lisez le résultat quand l'état est completed : le SecuScore, le nombre de failles par gravité et le lien vers le rapport complet.

Lancer un scan

curl -X POST https://secuprobe.io/api/v1/scans \
  -H "Authorization: Bearer sp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-domain.com" }'

Clés d'API et limites

Les clés d'API commencent par sp_live_ et ne sont affichées qu'une fois, à leur création. SecuProbe ne stocke qu'une empreinte de la clé : une clé perdue ne peut pas être retrouvée, il faut la révoquer et en créer une autre. Gardez les clés hors du dépôt de code et stockez-les comme secrets dans votre CI.

Les requêtes sont limitées en fréquence par clé et par minute. Chaque réponse contient les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset ; une requête au-delà de la limite reçoit un statut 429. L'accès à l'API est compris dans les offres Pro et Enterprise.

Ce que l'API fait et ne fait pas

L'API suit la même règle que le tableau de bord : les tests de sécurité actifs ne s'exécutent que sur les domaines dont vous avez vérifié la propriété. Cette règle protège les tiers et empêche qu'une clé d'API serve à tester un site que vous ne contrôlez pas.

Besoin d'aide ? Contactez l'assistance ou gérez vos clés d'API.