Activer le webhook et envoyer des événements
Obtenez l'URL et le secret de signature du webhook et configurez votre système pour qu'il envoie ses événements à la plateforme.
Sur cette page
Le webhook est l'adresse à laquelle votre système envoie ses événements. Chaque intégration a la sienne, ainsi qu'un Secret de signature avec lequel votre système signe chaque envoi. La plateforme n'accepte ainsi que les événements qui proviennent réellement de votre système.
Avant de commencer
Vous devez avoir le rôle Administrateur.
L'intégration doit exister. Si vous l'avez créée avec Recevoir des événements par webhook coché, le webhook est déjà actif et vous avez vu le secret à l'enregistrement.
Vous avez besoin d'une personne capable de configurer le système externe pour qu'il envoie des requêtes signées.
Activer le webhook
Ouvrez Paramètres → Intégrations.
Sur la carte de l'intégration, le champ Webhook indique Désactivé. Cliquez sur Webhook.
La fenêtre Webhook activé s'ouvre. Il n'y a pas de confirmation préalable : un clic sur le bouton génère l'URL et le secret.
Copier l'URL et le secret
La fenêtre Webhook activé affiche l'avis Copiez le secret maintenant : il n'est affiché qu'une seule fois.
À côté de URL du webhook, cliquez sur Copier.
À côté de Secret de signature, cliquez sur Copier.
Collez-les dans la configuration de votre système ou enregistrez-les dans votre gestionnaire de secrets.
Cliquez sur Je l'ai copié, fermer. Dans Avez-vous copié le secret ?, confirmez avec Oui, fermer. Si vous fermez la fenêtre d'une autre manière, cette confirmation est également demandée.
La plateforme stocke le secret chiffré et ne peut plus l'afficher. Si vous le perdez, vous devrez Renouveler ou désactiver le webhook et configurer de nouveau le système.
Comment votre système doit envoyer les événements
La même fenêtre contient les instructions dans Comment envoyer des événements et des exemples prêts à copier dans les onglets curl et Node.js (bouton Copier l'exemple). En résumé :
Envoyez une requête POST avec un corps JSON à l'URL du webhook.
Ajoutez l'en-tête
X-Argunis-Timestampavec l'heure actuelle en secondes Unix.Ajoutez l'en-tête
X-Argunis-Signature: sha256=<firma>, où la signature est le HMAC-SHA256 en hexadécimal, calculé avec le secret, detimestamp + "." + cuerpo(le corps exact que vous envoyez).Les signatures invalides ou décalées de plus de 5 minutes par rapport à l'heure du serveur sont rejetées. Vous pouvez envoyer un événement ou une liste d'événements (un tableau JSON).
Chaque événement indique son type (type : alerta, incidente, activo ou vulnerabilidad) et sa gravité (severity : baja, media, alta ou critica), ainsi qu'un identifiant, un titre, la date de survenue et l'actif touché :
{
"type": "alerta",
"id": "alert-1234",
"title": "Múltiples intentos fallidos de RDP",
"severity": "alta",
"occurredAt": "2026-09-29T14:05:00Z",
"asset": {
"externalId": "agent-017",
"name": "srv-files",
"hostname": "srv-files.empresa.local",
"ip": "10.0.4.30",
"os": "Windows Server 2022"
}
}Envoyez toujours l'id de l'événement dans votre système. Si le même événement arrive deux fois (à cause d'une nouvelle tentative), la plateforme le reconnaît grâce à cet identifiant et ne le duplique pas.
Assurez-vous que l'horloge du système émetteur est synchronisée. Avec plus de 5 minutes d'écart, la plateforme rejette l'envoi même si la signature est correcte.
Ensuite
Chaque événement accepté apparaît dans l'onglet Événements reçus et la carte met à jour Dernier événement. Selon le type :
Les alertes, incidents, vulnérabilités et autres événements arrivent avec le statut Nouveau, pour que quelqu'un les examine. Un
typedifférent des quatre types connus est enregistré comme Autre, et une gravité différente des quatre gravités connues est ignorée.Les actifs arrivent toujours avec le statut Examiné. Si l'option Actifs pour l'inventaire est cochée dans l'intégration, l'actif est enregistré comme actif découvert (ou lié à celui que vous avez déjà avec le même nom d'équipement ou la même IP). Examinez les nouveaux actifs dans l'onglet Découverts de Entreprise → Actifs pour les intégrer à l'inventaire. Voir Intégrer ou écarter des actifs découverts.
Si l'événement contient un actif qui existe déjà dans votre inventaire (par nom d'équipement ou IP), il y est lié.
Si l'intégration a Incident automatique, les alertes et incidents de gravité critique ouvrent immédiatement un incident.
Si l'intégration est En pause, le webhook n'accepte pas d'événements.
Si les événements n'arrivent pas
Demandez à la personne qui configure le système externe de vérifier la réponse reçue lors de l'envoi :
Réponse | Ce qu'elle signifie |
|---|---|
202 | L'envoi a été accepté. Si vous ne le voyez pas, vérifiez les filtres de Événements reçus. |
401, « Firma inválida o vencida. » (signature invalide ou expirée) | Le secret n'est pas le bon, la signature n'a pas été calculée sur le corps exact envoyé ou l'horloge du système est décalée de plus de 5 minutes. |
404 | L'URL n'existe pas : le webhook a été renouvelé ou désactivé, ou l'intégration est En pause. |
429 | Trop d'envois depuis la même adresse (plus de 120 par minute). Regroupez plusieurs événements dans une liste. |