Vai al contenuto
Bexxo Assistenza

Assistenza PhishTrainer: segnalazioni

Configurare le segnalazioni, smistarle e collegare webhook

Per gli amministratori PhishTrainer Aggiornato il 13 novembre 2026

Guida per amministratori: scegliete da dove arrivano le email segnalate dai vostri collaboratori, classificatele in PhishTrainer e trasmettete gli eventi ai vostri strumenti tramite webhook.
In questa pagina
  1. A cosa servono le segnalazioni
  2. Fonti di segnalazione
  3. Fonte: casella email (IMAP)
  4. Fonte: casella Microsoft 365 (Graph)
  5. Fonti: pulsanti di segnalazione nella posta
  6. Seguire e gestire le fonti
  7. Smistare le segnalazioni
  8. Webhook
  9. Risoluzione dei problemi

A cosa servono le segnalazioni

I vostri collaboratori ricevono email dubbie: phishing reale, spam o simulazioni PhishTrainer. La segnalazione permette loro di trasmettere queste email al vostro team di sicurezza, che le ritrova in PhishTrainer.

  • Ricezione: una o più fonti portano le email segnalate in PhishTrainer (menu Impostazioni, pagina Ricezione delle segnalazioni).
  • Smistamento: la pagina Email sospette raggruppa le email segnalate; le classificate una per una (phishing, spam, innocua…). Le simulazioni PhishTrainer vengono riconosciute e associate alla loro campagna.
  • Integrazione: i webhook (menu Impostazioni, pagina Webhooks) inviano dati PhishTrainer a un’altra applicazione, ad esempio un SIEM o uno strumento di ticketing.
Le pagine Ricezione delle segnalazioni e Webhooks sono riservate agli amministratori PhishTrainer. La pagina Email sospette è aperta agli amministratori e ai supervisori.

Fonti di segnalazione

Una fonte descrive il percorso di un’email segnalata fino a PhishTrainer. Esistono due famiglie, presentate nella finestra Aggiungere una fonte di segnalazione:

  • PhishTrainer legge una casella email: i vostri collaboratori inoltrano l’email sospetta a un indirizzo dedicato (ad esempio segnalazione@vostro-dominio.ch), che PhishTrainer legge a intervalli regolari;
  • Un pulsante «Segnala» nella posta: un componente aggiuntivo inserisce un pulsante nella posta; l’email arriva direttamente a PhishTrainer, senza casella intermedia.
FontePer chiCosa vi serve
Casella email (IMAP)Casella di segnalazione presso qualsiasi fornitoreL’indirizzo del server IMAP, un nome utente e una password
Casella Microsoft 365Casella di segnalazione Microsoft 365, letta tramite Microsoft Graph senza password della casella; funziona con il pulsante «Segnala» integrato in OutlookUn amministratore Microsoft 365, per preparare la casella una sola volta
Outlook per Windows (VSTO)Outlook classico installato sulle postazioni WindowsInstallare un file MSI su ogni postazione, a mano o tramite distribuzione
Outlook Microsoft 365Outlook sul web, nuovo Outlook, Outlook mobileUn amministratore Microsoft 365, per distribuire il componente aggiuntivo
Gmail (Google Workspace)Le caselle Gmail della vostra organizzazioneUn amministratore Google Workspace, per installare il modulo

Potete configurare più fonti e combinarle, ad esempio una casella di segnalazione e un componente aggiuntivo Outlook. Ciascuna si attiva in modo indipendente.

Aggiungere una fonte

  1. Nell’extranet aprite il menu Impostazioni, poi la pagina Ricezione delle segnalazioni.
  2. Nella scheda Le mie fonti di ricezione, fate clic su Aggiungi una fonte.
  3. Scegliete il tipo di fonte. Si apre il modulo corrispondente, con un promemoria di ciò che vi serve.
  4. Compilate il modulo (vedere le sezioni seguenti), poi fate clic su Salva.
Se la vostra organizzazione usa la cifratura lato client, la configurazione delle fonti IMAP e Microsoft 365 viene cifrata nel vostro browser, ed è l’agente Bexxo Protected della vostra organizzazione a leggere la casella e a eseguire il test di connessione. La cassaforte deve essere sbloccata nel vostro browser per leggere o modificare queste fonti.
Come funziona la cifratura lato clientCrittografia lato client

Fonte: casella email (IMAP)

Create prima, presso il vostro fornitore di posta, una casella dedicata alle segnalazioni. Scegliete poi Casella email (IMAP) e compilate i campi. I campi contrassegnati da un asterisco sono obbligatori.

CampoValore da inserire
Nome della fonte:Nome libero, per riconoscere la fonte nell’elenco.
Server IMAP:Indirizzo del server IMAP del vostro fornitore, ad esempio imap.esempio.ch.
Porta IMAP:Numero tra 1 e 65535: di norma 993 per TLS diretto, 143 per STARTTLS.
Cifratura:TLS diretto (di norma porta 993) o STARTTLS (di norma porta 143). La connessione è sempre cifrata prima dell’invio di nome utente e password; se il server non consente STARTTLS, il prelievo non riesce. Non esiste una modalità senza cifratura.
Utente: e Password:Credenziali dell’account della casella di segnalazione. In modifica, lasciate vuota la password per conservare quella attuale.
Cartella:Cartella da leggere. Valore proposto: INBOX (posta in arrivo).
Frequenza di prelievo (minuti):Intervallo tra due prelievi, in minuti interi: almeno 60 (valore proposto).
Dopo il prelievo:Cosa fa PhishTrainer del messaggio nella casella una volta prelevato: Lascia invariato (predefinito), Segna come letto, Segna come non letto o Elimina il messaggio.
Prelievo attivatoInterruttore: la casella viene letta solo se è attivo.
Ignora gli errori di certificatoDa lasciare disattivato, salvo un server interno con un certificato che sapete non riconosciuto.
Ignorare gli errori di certificato elimina la verifica dell’identità del server: la connessione resta cifrata, ma un terzo potrebbe spacciarsi per il vostro server. Meglio correggere il certificato.

Testare, poi salvare

  1. Fate clic su Testa la connessione in fondo alla finestra. In caso di successo, PhishTrainer indica il numero di email non lette nella cartella.
  2. Fate clic su Salva. La fonte compare in Le mie fonti di ricezione.

Cosa dire ai collaboratori

Comunicate l’indirizzo della casella di segnalazione. Chiedete di inoltrare l’email sospetta come allegato quando la posta lo consente: PhishTrainer analizza così l’email originale tale e quale. Un inoltro classico (nel corpo del messaggio) è accettato, ma il mittente originale viene ritrovato solo se resta leggibile nel blocco di inoltro.

Fonte: casella Microsoft 365 (Graph)

PhishTrainer legge una casella Exchange Online tramite Microsoft Graph, con un’applicazione registrata nel vostro Microsoft Entra, senza password della casella. L’applicazione ha accesso solo a questa casella, in lettura. Abbinata al pulsante «Segnala» integrato in Outlook, questa fonte riceve le email che i vostri collaboratori segnalano con quel pulsante.

Due metodi di preparazione

Scegliete Casella Microsoft 365. La finestra mostra a sinistra la procedura (Preparare Microsoft 365) e a destra i campi da compilare. Sono proposti due metodi: A mano (consigliato), in cui eseguite ogni impostazione nei portali Microsoft, oppure Con lo script, uno script PowerShell che esegue le impostazioni per voi. La finestra descrive ogni passo; ecco come si susseguono.

Metodo «A mano»

  1. Pulsante «Segnala» di Outlook: nel portale Microsoft Defender dichiarate la casella di segnalazione come casella SecOps (recapito avanzato), poi inviatevi i messaggi segnalati (impostazioni segnalate dall’utente).
  2. Creare l’applicazione in Entra: in Registrazioni app create un’applicazione chiamata «PhishTrainer - Reporting» (solo account di questa directory, nessuna autorizzazione API), poi un segreto client. Riportate l’ID tenant, l’ID applicazione, il segreto e la sua data di scadenza nei campi a destra.
  3. Autorizzare l’applicazione a leggere la casella, e solo quella: copiate l’ID oggetto dell’applicazione da Applicazioni aziendali (non quello delle registrazioni app) nel campo ID oggetto (applicazione aziendale), fate clic su Preparare i comandi, poi eseguite i comandi mostrati in PowerShell 7 con un account Amministratore di Exchange. L’ultimo comando deve rispondere «InScope : True».
  4. Fate clic su Salva, poi su Testa la connessione.

Metodo «Con lo script»

  1. Inserite l’indirizzo della casella di segnalazione nel campo Casella di segnalazione.
  2. Scaricate lo script e sbloccatelo con il comando mostrato. Funziona in PowerShell 7.2 o successivo, su una postazione di lavoro connessa a Internet, non su un server Active Directory.
  3. Fate clic su Genera il comando, copiatelo ed eseguitelo. Aggiungete -Simulation per vedere cosa farebbe lo script senza modificare nulla.
  4. Accedete con un account amministratore Microsoft 365 (Amministratore di Exchange e Amministratore applicazioni, oppure Amministratore globale). Lo script mostra cosa farà e attende la vostra conferma: rispondete yes.
  5. Riportate nei campi a destra i cinque valori mostrati alla fine. Il segreto è mostrato una sola volta. Fate poi clic su Salva, quindi su Testa la connessione.

Campi della fonte

CampoValore
Nome della fonte:Nome libero, per riconoscere la fonte nell’elenco.
Casella di segnalazioneIndirizzo della casella Exchange Online che riceve le segnalazioni (l’indirizzo principale, se ne ha più d’uno). Valore dello script: Reporting mailbox.
ID tenantGUID mostrato in Entra nella pagina dell’applicazione, «ID directory (tenant)». Valore dello script: Tenant ID.
ID applicazione (client)GUID mostrato nella stessa pagina. Valore dello script: Application (client) ID.
Segreto e Scadenza del segretoIl «Valore» del segreto client (non il suo ID) e la sua data di scadenza, nel futuro. In modifica, lasciate vuoto il segreto per conservare quello attuale. Valori dello script: Secret e Secret expiry.
Cartella da leggere:In Impostazioni di lettura: Posta in arrivo (predefinito) o Altra cartella (nome):. Le email lette restano nella casella.
Frequenza di prelievo (minuti): e Prelievo attivatoCome per una fonte IMAP: almeno 60 minuti.

Dopo il salvataggio

I diritti Exchange impiegano da 30 minuti a 2 ore per applicarsi: un test rifiutato subito dopo il salvataggio è normale, riprovate più tardi. Il test non legge alcun messaggio; indica se la casella è vuota o contiene messaggi da prelevare.

Il segreto client scade (Microsoft raccomanda al massimo 24 mesi). Prima della scadenza, create un nuovo segreto (con lo script: rilanciate lo stesso comando aggiungendo -RenewSecret), poi inserite il nuovo segreto e la sua data nella fonte. Altrimenti il prelievo si interrompe. Per rimuovere tutto dal vostro Microsoft 365, rilanciate lo script con -Remove -ReportingMailbox seguito dall’indirizzo della casella.

Fonti: pulsanti di segnalazione nella posta

I tre componenti aggiuntivi (Outlook per Windows (VSTO), Outlook Microsoft 365, Gmail (Google Workspace)) si aggiungono allo stesso modo: scegliete il tipo, compilate Nome della fonte:, verificate che Ricezione attivata sia attivo e salvate. La fonte mostra poi un codice di attivazione e le schede Impostazioni, Installazione, Messaggio ai collaboratori, oltre a Dispositivi registrati (VSTO) o Collegamenti e utenti (Microsoft 365, Gmail). L’opzione Elimina l'email dopo la segnalazione sposta l’email segnalata negli elementi eliminati del collaboratore, da dove resta recuperabile.

La distribuzione di ciascun componente ha la sua guida:

Outlook classico su WindowsComponente aggiuntivo Outlook per Windows: guida per l’amministratoreOutlook sul web, nuovo Outlook, Outlook mobileComponente aggiuntivo Outlook Microsoft 365: guida per l’amministratoreGmail e Google WorkspaceComponente aggiuntivo Gmail: guida per l’amministratore

Seguire e gestire le fonti

Ogni fonte dell’elenco Le mie fonti di ricezione porta un badge Attivata o Disattivata. Le fonti che leggono una casella mostrano Ultimo prelievo: e l’ultimo errore, se presente; i componenti aggiuntivi mostrano Ultima segnalazione ricevuta:. Azioni disponibili:

AzioneEffetto
ModificaRiapre il modulo. Password e segreti salvati non vengono mai rimostrati: lasciate vuoto il campo per conservarli.
DisattivaInterrompe il prelievo, o la ricezione per un componente aggiuntivo, senza cancellare la configurazione.
AttivaRiprende il prelievo o la ricezione.
EliminaInterrompe la fonte e ne cancella la configurazione. L’azione è definitiva.

Smistare le segnalazioni

Aprite Email sospette nel menu PhishTrainer, oppure fate clic su Visualizza le email sospette dalla pagina delle fonti. Un’email segnalata da più collaboratori compare una sola volta: classificarla la classifica per tutti.

Panoramica

La scheda Panoramica indica, per il Periodo delle statistiche scelto (da 7 giorni a 12 mesi): il numero di Email segnalate, quelle Da analizzare, la quota di Simulazioni PhishTrainer, la ripartizione per Risultato dell'analisi e per tipo segnalato (Segnalate come), oltre ai Domini da analizzare e ai Domini classificati come phishing o spam. Un clic su un dominio filtra l’elenco sulle sue email.

Elenco delle email

Le schede filtrano per risultato: Tutto, Da analizzare, Phishing, Spam, Innocue, Indeterminate, Simulazioni PhishTrainer. Altri filtri: Dominio mittente, Segnalate come (phishing o spam, secondo quanto dichiarato dal collaboratore), Interazioni dichiarate e Periodo. Ordina per propone Più recenti, Da analizzare da più tempo e Più segnalate. Le email da analizzare sono evidenziate.

Dettaglio di un’email

Fate clic su una riga per aprire Dettaglio dell'email: mittente, oggetto, date della prima e dell’ultima segnalazione, tipo, risultato, Ultima classificazione (chi e quando), poi Collaboratori che l'hanno ricevuta, Corpo del messaggio, Indicatori (URL, domini, mittente, indirizzi IP, impronte degli allegati) e Allegati (nome, tipo, dimensione, SHA-256). Il corpo è mostrato in un riquadro isolato; gli allegati non si possono scaricare.

Classificare un’email

  1. Nell’elenco, fate clic sull’icona del risultato voluto in fondo alla riga, oppure aprite il dettaglio.
  2. Nel dettaglio, scegliete il risultato dopo Classifica questa email come:.
  3. La classificazione vale per tutte le segnalazioni di questa email. Potete cambiarla in seguito: vale l’ultima classificazione.
RisultatoQuando usarlo
PhishingUn tentativo di phishing reale.
SpamPosta indesiderata senza intento fraudolento accertato.
InnocuoUn’email legittima, segnalata per prudenza.
IndeterminatoImpossibile decidere con gli elementi disponibili.
Simulazione PhishTrainerProposto solo nel dettaglio: per correggere una simulazione che PhishTrainer non ha riconosciuto.

Ogni segnalazione ha uno stato: Da analizzare, In analisi o Classificata. Un’email senza classificazione è mostrata come Da analizzare.

Simulazioni PhishTrainer

Quando un collaboratore segnala un’email di simulazione, PhishTrainer la riconosce e la classifica automaticamente (Ultima classificazione: Automatica). Il link vedi i risultati della campagna apre la campagna interessata. La dicitura Simulazione PhishTrainer non associata indica una simulazione riconosciuta ma senza campagna ritrovata.

Interazioni dichiarate

Con alcuni componenti aggiuntivi, il collaboratore indica cosa ha fatto con l’email: link cliccato, allegato aperto, credenziali inserite, risposta o chiamata. Il badge Ha interagito segnala credenziali inserite o un allegato aperto; Interazione dichiarata segnala un link cliccato, una risposta o una chiamata. Per il prelievo da una casella la domanda non viene posta (Non richiesto). Il filtro Con interazione a rischio isola queste email.

Un’interazione a rischio (credenziali inserite, allegato aperto) richiede una reazione rapida: reimpostate la password interessata e verificate la postazione. In questo caso gli amministratori PhishTrainer ricevono anche un avviso via email.
Il contenuto di un’email segnalata viene eliminato dopo 90 giorni (Contenuto eliminato dopo 90 giorni.). Le informazioni di smistamento (mittente, indicatori, risultato) restano consultabili.

Webhook

Un webhook è un indirizzo web (URL) della vostra applicazione a cui PhishTrainer invia dati man mano che le campagne si svolgono. Serve ad alimentare un SIEM, uno strumento di ticketing o un canale di chat del team, senza consultare a mano l’extranet.

Creare un webhook

  1. Aprite il menu Impostazioni, poi Webhooks.
  2. Fate clic su Aggiungi nuovo Webhook.
  3. Nome: nome libero, almeno 5 caratteri.
  4. URL: indirizzo completo dell’applicazione che riceve i dati, ad esempio https://siem.vostro-dominio.ch/phishtrainer. Usate un indirizzo https://.
  5. Secret: facoltativo, ma consigliato. Inserite una lunga stringa casuale nota solo a PhishTrainer e alla vostra applicazione: serve a firmare gli invii.
  6. Attivate È attivo? (i dati vengono inviati solo ai webhook attivi), poi fate clic su Salva il Webhook.

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.

Modificare o eliminare

L’elenco mostra titolo, URL e stato di ogni webhook. I pulsanti Modifica questo Webhook e Elimina questo Webhook agiscono sulla riga. L’eliminazione è irreversibile. Per sospendere gli invii senza perdere la configurazione, disattivate È attivo?.

Risoluzione dei problemi

Messaggio o sintomoCosa fare
«Connessione alla casella impossibile» (IMAP)Verificate server, porta, cifratura e credenziali. La porta deve corrispondere alla modalità: di norma 993 per TLS diretto, 143 per STARTTLS.
«Lettura della casella impossibile» o «La cartella da leggere non è stata trovata»Verificate il nome esatto della cartella da leggere. Per Microsoft 365, se più cartelle hanno questo nome, rinominatene una.
Avviso «salvata senza cifratura» su una fonte IMAPLa fonte non viene più letta. Apritela, scegliete una modalità di cifratura, testate la connessione, poi salvate.
Test Microsoft 365 rifiutato subito dopo il salvataggio, o «Diritti in fase di propagazione»Normale: i diritti Exchange impiegano fino a 2 ore per applicarsi. Riprovate più tardi.
«Microsoft nega l'accesso alla casella di segnalazione»Rilanciate lo script, che verifica e corregge i diritti, oppure verificate i comandi Exchange del passo 3 del metodo a mano.
«Il segreto dell'applicazione è scaduto» o «Microsoft ha rifiutato la connessione dell'applicazione»Verificate tenant, applicazione e segreto. Se necessario, create un nuovo segreto (script con -RenewSecret) e inseritelo, con la sua data di scadenza, nella fonte.
Avviso: l’applicazione dispone di autorizzazioni MicrosoftL’applicazione non deve avere alcuna autorizzazione API. Rimuovetele in Entra, poi rilanciate lo script.
«Nessun agente ha risposto in tempo» (organizzazione cifrata)Verificate che l’agente Bexxo Protected della vostra organizzazione sia avviato e connesso, poi rilanciate il test.
Un’email segnalata non compare in Email sospetteVerificate che la fonte sia Attivata e controllate Ultimo prelievo: e l’ultimo errore. Una casella viene letta solo alla frequenza scelta (almeno 60 minuti).
Segnalatore indicato come «Segnalatore non riconosciuto»L’indirizzo che ha trasmesso l’email non corrisponde ad alcun destinatario PhishTrainer della vostra organizzazione. Verificate l’elenco dei destinatari.
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 messaggio resta poco chiaro? Scrivete a info@bexxo.ch indicando il nome della fonte e il messaggio mostrato.

Non avete trovato la risposta? Contattarci