Webhooks

Configure les webhooks dans Paramètres → Intégrations → Webhook. Chaque catégorie d’événement est envoyée sous forme de POST vers ton endpoint :

POST https://ton-app.exemple/monsys
Content-Type: application/json
X-Monsys-Signature: hmac-sha256(<secret>, corps)

{
  "événement":     "alert.created",
  "id_tenant": "...",
  "id_agent":  "...",
  "alerte": {
    "id":        "...",
    "sevérité":  "critique",
    "catégorie":  "honey pot",
    "titre":     "Honey pot déclenché : /root/.ssh/id_rsa.monsys-backup",
    "créé_le": "2026-05-09T12:42:18Z"
  }
}

Vérification

import hmac, hashlib

def vérifier(secret: bytes, corps: bytes, signature: str) -> bool:
    mac = hmac.new(secret, corps, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, signature)

Types d’événements

Événement	Lorsque
alerte.created	Une alerte est créée
alerte.resolue	Une alerte est résolue
agent.online	Agent en ligne arrivé
agent.offline	Silence du cœur ≥ 90 s
honey pot.tripped	Canard activé
CVE.match.new	Nouveau CVE-match (CVSS ≥ 7.0)
token.urgence.émis	Token émis (audit)