Secret par utilisateur
Un whsec_* est généré à la création pour vérifier les livraisons.
API et outils
Webhooks vers vos URL HTTPS
Déclarez des URL HTTPS pour recevoir huit événements de la plateforme. Gérez-les depuis le tableau de bord ou l’API REST /user/webhooks.
Aucune carte bancaire requise · Clé API gratuite
Événements
11 types d’événements, un POST HTTPS chacun.
| Événement | Déclenché quand | Champs clés |
|---|---|---|
| threat.detected | Un rapport ou une recherche aboutit à un verdict malveillant ou à haut risque. | entity, riskScore, dataTrust, evidence, caseUrl |
| monitor.alert | Un domaine ou une IP sous surveillance change de statut ou lève une nouvelle alerte. | alertId, entity, severity, recommendedAction, dataTrust |
| report.created | Un nouveau rapport de menace est enregistré. | reportId, entity, entityType, createdAt |
| usage.warning | La consommation approche d’une limite de l’offre. | usageType, current, limit, plan |
| cve.finding.created | Une CVE touche un composant de votre stack surveillée : priorité, preuve, composants avec leur version, versions concernées et correctif. | findingId, cveId, severity, epssScore, kev, perimeter |
| cve.finding.status_changed | Une alerte change de statut, par un membre ou fermée à la lecture de la version corrigée. | findingId, cveId, status, previousStatus, updatedAt, perimeter |
| case.updated | Le statut, la priorité ou la chronologie des preuves d’un cas change. | caseId, status, priority, evidenceCount |
| dataset.stale | Un jeu de données dépasse son seuil de fraîcheur ou devient indisponible. | datasetKey, status, ageHours, lastSuccessAt |
| cve.finding.escalated | Une CVE de votre stack a un nouvel élément : ajout au catalogue KEV de la CISA, exploitation signalée, preuve de concept publiée ou correctif disponible. | findingId, cveId, priority, previousPriority, changes, components |
| cve.exploited | Une CVE devient exploitée (KEV de la CISA, autre catalogue d’exploitation, SSVC « active » de la CISA). Envoyé seulement aux abonnements qui nomment cet événement. | cveId, commonName, exploitationStatus, firstSeenAt, sources, inYourStack |
| cve.digest | Le résumé quotidien ou du lundi de ce qui est nouveau ou modifié dans votre stack surveillée. | kind, periodStart, periodEnd, counts, items |
API REST
Gérez vos webhooks sous /user/webhooks.
| Route | Action |
|---|---|
| POST /user/webhooks | Créer un webhook ; un secret whsec_ est généré |
| GET /user/webhooks | Lister vos webhooks |
| GET /user/webhooks/:id | Lire un webhook, failure_count compris |
| PATCH /user/webhooks/:id | Modifier un webhook |
| DELETE /user/webhooks/:id | Supprimer un webhook |
| GET /user/webhooks/events | Lister les types d’événements et leurs champs |
curl -X POST "https://api.ismalicious.com/user/webhooks" \
-H "X-API-KEY: YOUR_BASE64_CREDENTIALS" \
-H "Content-Type: application/json" \
-d '{"name":"Production","url":"https://hooks.example.com/ism","events":["threat.detected","monitor.alert"]}'- Types d’événements
- 11
- Webhooks en Basic
- 2
- Webhooks en Pro et Enterprise
- 10
- URL de livraison uniquement
- HTTPS
Fonctionnalités
L’essentiel en un coup d’œil.
Limites par offre
2 webhooks en Basic, 10 en Pro et Enterprise.
Même authentification
X-API-KEY en Base64 ou session connectée.
Applications
Cas d’usage à évaluer en premier.
Automatisation
Déclenchez vos workflows internes quand une menace ou une alerte survient.
SIEM
Transférez des événements structurés vers votre point d’ingestion.
Infrastructure as code
Provisionnez vos webhooks par API depuis Terraform ou vos scripts.
FAQ
Questions fréquentes.
S’agit-il de webhooks entrants façon Stripe ?
Non — /webhook/stripe est distinct (Stripe uniquement). Les webhooks utilisateur sont vos URL, que nous appelons en POST.
Ces routes figurent-elles dans OpenAPI ?
openapi.json documente GET /user/webhooks/events. Les autres routes sont listées sur cette page.
Comment suivre les livraisons en échec ?
Chaque webhook conserve un failure_count, renvoyé par GET /user/webhooks.
Explorer
Outils associés et pages utiles.
Testez avec vos propres indicateurs.
L’offre gratuite inclut les recherches sur le site sans plafond mensuel et 250 requêtes API par mois. Vérifiez les sources et les limites, puis connectez l’API.
Aucune carte bancaire requise · Clé API gratuite