Assistenza PhishTrainer: segnalazioni
Configurare le segnalazioni, smistarle e collegare webhook
In questa pagina
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.
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.
| Fonte | Per chi | Cosa vi serve |
|---|---|---|
| Casella email (IMAP) | Casella di segnalazione presso qualsiasi fornitore | L’indirizzo del server IMAP, un nome utente e una password |
| Casella Microsoft 365 | Casella di segnalazione Microsoft 365, letta tramite Microsoft Graph senza password della casella; funziona con il pulsante «Segnala» integrato in Outlook | Un amministratore Microsoft 365, per preparare la casella una sola volta |
| Outlook per Windows (VSTO) | Outlook classico installato sulle postazioni Windows | Installare un file MSI su ogni postazione, a mano o tramite distribuzione |
| Outlook Microsoft 365 | Outlook sul web, nuovo Outlook, Outlook mobile | Un amministratore Microsoft 365, per distribuire il componente aggiuntivo |
| Gmail (Google Workspace) | Le caselle Gmail della vostra organizzazione | Un 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
- Nell’extranet aprite il menu Impostazioni, poi la pagina Ricezione delle segnalazioni.
- Nella scheda Le mie fonti di ricezione, fate clic su Aggiungi una fonte.
- Scegliete il tipo di fonte. Si apre il modulo corrispondente, con un promemoria di ciò che vi serve.
- Compilate il modulo (vedere le sezioni seguenti), poi fate clic su Salva.
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.
| Campo | Valore 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 attivato | Interruttore: la casella viene letta solo se è attivo. |
| Ignora gli errori di certificato | Da lasciare disattivato, salvo un server interno con un certificato che sapete non riconosciuto. |
Testare, poi salvare
- Fate clic su Testa la connessione in fondo alla finestra. In caso di successo, PhishTrainer indica il numero di email non lette nella cartella.
- 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»
- 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).
- 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.
- 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».
- Fate clic su Salva, poi su Testa la connessione.
Metodo «Con lo script»
- Inserite l’indirizzo della casella di segnalazione nel campo Casella di segnalazione.
- 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.
- Fate clic su Genera il comando, copiatelo ed eseguitelo. Aggiungete
-Simulationper vedere cosa farebbe lo script senza modificare nulla. - 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. - 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
| Campo | Valore |
|---|---|
| Nome della fonte: | Nome libero, per riconoscere la fonte nell’elenco. |
| Casella di segnalazione | Indirizzo della casella Exchange Online che riceve le segnalazioni (l’indirizzo principale, se ne ha più d’uno). Valore dello script: Reporting mailbox. |
| ID tenant | GUID 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 segreto | Il «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 attivato | Come 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.
-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:
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:
| Azione | Effetto |
|---|---|
| Modifica | Riapre il modulo. Password e segreti salvati non vengono mai rimostrati: lasciate vuoto il campo per conservarli. |
| Disattiva | Interrompe il prelievo, o la ricezione per un componente aggiuntivo, senza cancellare la configurazione. |
| Attiva | Riprende il prelievo o la ricezione. |
| Elimina | Interrompe 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
- Nell’elenco, fate clic sull’icona del risultato voluto in fondo alla riga, oppure aprite il dettaglio.
- Nel dettaglio, scegliete il risultato dopo Classifica questa email come:.
- La classificazione vale per tutte le segnalazioni di questa email. Potete cambiarla in seguito: vale l’ultima classificazione.
| Risultato | Quando usarlo |
|---|---|
| Phishing | Un tentativo di phishing reale. |
| Spam | Posta indesiderata senza intento fraudolento accertato. |
| Innocuo | Un’email legittima, segnalata per prudenza. |
| Indeterminato | Impossibile decidere con gli elementi disponibili. |
| Simulazione PhishTrainer | Proposto 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.
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
- Aprite il menu Impostazioni, poi Webhooks.
- Fate clic su Aggiungi nuovo Webhook.
- Nome: nome libero, almeno 5 caratteri.
- URL: indirizzo completo dell’applicazione che riceve i dati, ad esempio
https://siem.vostro-dominio.ch/phishtrainer. Usate un indirizzohttps://. - Secret: facoltativo, ma consigliato. Inserite una lunga stringa casuale nota solo a PhishTrainer e alla vostra applicazione: serve a firmare gli invii.
- 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:
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.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 sintomo | Cosa 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 IMAP | La 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 Microsoft | L’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 sospette | Verificate 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 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