Vai al contenuto
Bexxo Assistenza

Assistenza PhishTrainer Segnalazioni

Inviare dati PhishTrainer ai vostri strumenti tramite webhook

Per gli amministratori PhishTrainer Aggiornato il 13 novembre 2026

Create un webhook in Impostazioni › Webhooks per inviare dati PhishTrainer a un’altra applicazione e verificate la firma degli invii.
In questa pagina
  1. A cosa serve un webhook
  2. Creare un webhook
  3. Formato degli invii
  4. Verificare la firma
  5. Risoluzione dei problemi

A cosa serve un webhook

Un webhook è un indirizzo web (URL) della vostra applicazione a cui PhishTrainer invia dati man mano che le campagne si svolgono, per esempio per alimentare un SIEM, uno strumento di ticketing o un canale del team.

La pagina Webhooks è riservata agli amministratori PhishTrainer.
Ricevere le email segnalate dai vostri collaboratoriRicevere le segnalazioni: caselle email e pulsanti di postaClassificare le email segnalate nel portaleSmistare e classificare le email sospette

Creare un webhook

Il webhook si crea in Impostazioni › Webhooks, con un nome di almeno 5 caratteri. Indicate l’indirizzo completo dell’applicazione che riceve i dati, in https://, ad esempio https://siem.vostro-dominio.ch/phishtrainer.

Il Secret è facoltativo, ma senza di esso gli invii non sono firmati e la vostra applicazione non può verificare che provengano da PhishTrainer. Inserite una lunga stringa casuale nota solo a PhishTrainer e alla vostra applicazione.

Solo i webhook con È attivo? attivato ricevono dati: verificatelo prima di salvare.

Per sospendere gli invii senza perdere la configurazione, disattivate È attivo? invece di eliminare il webhook: l’eliminazione è irreversibile.

Formato degli invii

Ogni invio è una richiesta HTTP POST il cui corpo è un documento JSON. La vostra applicazione deve rispondere con un codice HTTP inferiore a 400: un codice 400 o superiore, o nessuna risposta entro 10 secondi, conta come errore. I reindirizzamenti non vengono seguiti. Intestazioni inviate:

Intestazioni della richiesta

Verificare la firma

Se è indicato un secret, PhishTrainer aggiunge l’intestazione X-Gophish-Signature, nella forma sha256= seguito da una firma esadecimale. Questa firma è l’HMAC-SHA256 del corpo grezzo della richiesta, calcolato con il secret come chiave. Per verificare un invio, la vostra applicazione ricalcola questo HMAC sul corpo ricevuto, tale e quale, prima di qualsiasi decodifica JSON, e lo confronta con il valore dell’intestazione. Una richiesta senza intestazione o con una firma diversa va respinta.

Confrontate le firme con una funzione a tempo costante (ad esempio hash_equals in PHP, hmac.compare_digest in Python) e non registrate mai il secret nei log.

Risoluzione dei problemi

Messaggio o sintomoCosa fare
Webhook: nessun dato ricevutoVerificate che È attivo? sia attivato, che l’URL sia raggiungibile da Internet e che la vostra applicazione risponda con un codice inferiore a 400 entro 10 secondi, senza reindirizzamento.
Un invio resta poco chiaro? Scrivete a info@bexxo.ch indicando il nome del webhook e il comportamento osservato.

Non avete trovato la risposta? Contattarci