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. 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 Inbox (Posta in arrivo) 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 Settings (Impostazioni) > Webhook.
3. Fai clic sul pulsante Nuovo Webhook nell’angolo in alto a destra della pagina per aprire la finestra pop-up Aggiungi impostazioni webhook.
4. Nella finestra pop-up Aggiungi impostazioni webhook visualizzata, configura le impostazioni del webhook. Per saperne di più su queste impostazioni, consulta la schermata e l’elenco qui sotto:
   1. Nome: 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: nel menu a discesa, seleziona uno dei seguenti protocolli: Nessuna autorizzazione, Chiave API, Bearer Token o Autorizzazione di base.
   4. Dati disponibili: 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: per aggiungere dati personalizzati al payload del tuo webhook, fai clic sull’icona a forma di segno più. Compila quindi i campi chiave e valore. Ad esempio, se la tua applicazione richiede "{ "System" : "PhishER"}" nel payload per ricevere i dati, puoi inserire "System" e "PhishER".
   6. Intestazione personalizzata: per aggiungere un’intestazione personalizzata, fai clic sull’icona a forma di segno più. Compila quindi i campi chiave e valore. 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: in questa sezione puoi selezionare le caselle Riuscito o Non riuscito 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.

Gestire i webhook

Nella scheda secondaria Webhook delle Impostazioni 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. Quindi, aggiorna le informazioni del webhook.

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

1. Nuovo 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: questa colonna mostra il nome del webhook.
3. URL: questa colonna mostra l’URL che il webhook richiamerà.
4. Dati selezionati: questa colonna mostra i tipi di dati che desideri inviare al webhook.
5. Tag riuscito: 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: 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: in questa colonna vengono visualizzate le azioni disponibili per l’esecuzione di una voce webhook. Puoi fare clic sull’icona cestino per eliminare la voce.