Nella scheda secondaria Webhook delle Impostazioni di PhishER, puoi creare dei webhook per collegare la tua piattaforma PhishER ad altre piattaforme che utilizzi. Un webhook, noto anche come API push HTTP, è un modo in cui un’applicazione può fornire informazioni in tempo reale a un’altra applicazione. Quando i messaggi vengono attivati da azioni specifiche di PhishER, i webhook ti permettono di inviare i dati dei messaggi a un’altra applicazione.

Dopo aver integrato i webhook nella tua piattaforma PhishER, puoi creare un’azione PhishER e selezionare l’opzione Invia a Webhook (Send to Webhook). Questa opzione permette a PhishER di inviare al webhook della tua organizzazione i messaggi segnalati che sono interessati da quell’azione. Dopo che l’azione è stata attivata, puoi fare clic su un messaggio correlato nella tua Posta in arrivo (Inbox) di PhishER e vedere a quale webhook è stato inviato il messaggio.

Creare un nuovo webhook

Per collegare un nuovo webhook alla tua piattaforma PhishER, effettua le seguenti operazioni:

1. Accedi alla piattaforma PhishER.
2. Vai su Impostazioni (Settings) > Webhook.
3. Fai clic sul pulsante Nuovo Webhook (New Webhook) nell’angolo in alto a destra della pagina per aprire la finestra pop-up Aggiungi impostazioni webhook (Add Webhook Settings).
4. Nella finestra pop-up Aggiungi impostazioni webhook (Add Webhook Settings) visualizzata, configura le impostazioni del webhook. Per saperne di più su queste impostazioni, consulta la schermata e l’elenco qui sotto:
   1. Nome (Name): in questo campo inserisci un nome personalizzato per il tuo webhook.
   2. URL: in questo campo inserisci l’URL che stai cercando di richiamare. Per un elenco di servizi di riscrittura e abbreviazione degli URL compatibili con PhishER, consulta il nostro articolo Domande frequenti su PhishER.
   3. Autorizzazione (Authorization): nel menu a discesa, seleziona uno dei seguenti protocolli: Nessuna autorizzazione (No Auth), Chiave API (API Key), Bearer Token o Autorizzazione di base (Basic Auth).
   4. Dati disponibili (Available Data): seleziona uno o più tipi di dati che desideri inviare al webhook.
      Nota: il tipo di dati Indirizzi invia tutti gli indirizzi e-mail nel payload del webhook, compresi gli indirizzi e-mail nei campi Da, A, CC, Rispondi a e Segnalato da.
   5. Dati personalizzati (Custom Data): per aggiungere dati personalizzati al payload del tuo webhook, fai clic sull’icona a forma di segno più. Compila quindi i campi chiave (key) e valore (value). Ad esempio, se la tua applicazione richiede "{ "System" : "PhishER"}" nel payload per ricevere i dati, puoi inserire "System" e "PhishER".
   6. Intestazioni personalizzate (Custom Headers): per aggiungere un’intestazione personalizzata, fai clic sull’icona a forma di segno più. Compila quindi i campi chiave (key) e valore (value). Ad esempio, se il tuo firewall richiede l’intestazione ""{ "Header" : "PhishER" }" per consentire il passaggio dei dati, puoi inserire "Header" e "PhishER".
   7. Tag messaggio (Message Tags): in questa sezione puoi selezionare le caselle Riuscito (Success) o Non riuscito (Failure) se desideri che PhishER ti assegni un tag quando il webhook viene utilizzato per inviare i dati. Inserisci quindi il nome del tag nel campo accanto alla casella selezionata. 
   
5. Fai clic su Crea (Create).

Gestire i webhook

Nella scheda secondaria Webhook delle Impostazioni (Settings) di PhishER, puoi collegare e gestire i tuoi webhook. Per aggiornare un webhook, fai clic sul rispettivo nome per aprire la finestra pop-up Aggiornamento impostazioni webhook (Update Webhook Settings). Quindi, aggiorna le informazioni del webhook.

Per maggiori informazioni sulla scheda secondaria Webhook, vedi la schermata e l’elenco di seguito:

1. Nuovo Webhook (New Webhook): puoi fare clic su questo pulsante per aggiungere un nuovo webhook. Per maggiori informazioni sull’aggiunta di un nuovo webhook, consulta la sezione secondaria corrispondente di questo articolo.
2. Nome (Name): questa colonna mostra il nome del webhook.
3. URL: questa colonna mostra l’URL che il webhook richiamerà.
4. Dati selezionati (Selected Data): questa colonna mostra i tipi di dati che desideri inviare al webhook.
5. Tag riuscito (Success Tag): in questa colonna viene visualizzato il tag che PhishER assegna a un messaggio se il webhook ha inviato correttamente i dati e ha ricevuto un URL di callback.
6. Tag non riuscito (Failure Tag): in questa colonna viene visualizzato il tag che PhishER assegna a un messaggio se il webhook non è riuscito a inviare dati e a ricevere un URL di callback.
7. Azioni (Actions): in questa colonna vengono visualizzate le azioni disponibili per l’esecuzione di una voce webhook. Puoi fare clic sull’icona del cestino per eliminare la voce.