Assistenza PhishTrainer Segnalazioni
Inviare dati PhishTrainer ai vostri strumenti tramite webhook
In questa pagina
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.
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:
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.
hash_equals in PHP, hmac.compare_digest in Python) e non registrate mai il secret nei log.Risoluzione dei problemi
| Messaggio o sintomo | Cosa fare |
|---|---|
| Webhook: nessun dato ricevuto | Verificate 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. |
Non avete trovato la risposta? Contattarci