Aide PhishTrainer Signalements
Envoyer des données PhishTrainer à vos outils par webhook
Sur cette page
À quoi sert un webhook
Un webhook est une adresse web (URL) de votre application à laquelle PhishTrainer envoie des données au fil de vos campagnes, par exemple pour alimenter un SIEM, un outil de tickets ou un canal d’équipe.
Créer un webhook
Le webhook se crée dans Paramètres › Webhooks, avec un nom d’au moins 5 caractères. Donnez l’adresse complète de l’application réceptrice, en https://, par exemple https://siem.votre-domaine.ch/phishtrainer.
Le Secret est facultatif, mais sans lui les envois ne sont pas signés et votre application ne peut pas vérifier qu’ils viennent de PhishTrainer. Saisissez une longue chaîne aléatoire, connue seulement de PhishTrainer et de votre application.
Seuls les webhooks dont Est actif ? est activé reçoivent des données : vérifiez-le avant d’enregistrer.
Pour suspendre les envois sans perdre la configuration, désactivez Est actif ? plutôt que de supprimer le webhook : la suppression est irréversible.
Format des envois
Chaque envoi est une requête HTTP POST dont le corps est un document JSON. Votre application doit répondre par un code HTTP inférieur à 400 : un code 400 ou plus, ou une absence de réponse dans les 10 secondes, compte comme un échec. Les redirections ne sont pas suivies. En-têtes envoyés :
Vérifier la signature
Si un secret est renseigné, PhishTrainer ajoute l’en-tête X-Gophish-Signature, de la forme sha256= suivi d’une signature hexadécimale. Cette signature est le HMAC-SHA256 du corps brut de la requête, calculé avec le secret comme clé. Pour vérifier un envoi, votre application recalcule ce HMAC sur le corps reçu, tel quel, avant tout décodage JSON, et le compare à la valeur de l’en-tête. Une requête sans en-tête ou avec une signature différente doit être rejetée.
hash_equals en PHP, hmac.compare_digest en Python) et ne journalisez jamais le secret.Dépannage
| Message ou symptôme | Que faire |
|---|---|
| Webhook : aucune donnée reçue | Vérifiez que Est actif ? est activé, que l’URL est joignable depuis Internet et que votre application répond par un code inférieur à 400 en moins de 10 secondes, sans redirection. |
Vous n’avez pas trouvé la réponse ? Nous contacter