Skip to content
Bexxo Help

Help PhishTrainer Reports

Receive reports: mailboxes and mail client buttons

For administrators PhishTrainer Updated on 13 November 2026

A source decides how the emails your staff report reach PhishTrainer. It is set up under Settings › Receiving reports, a page reserved for PhishTrainer administrators.
On this page
  1. Choosing a source
  2. Source: mailbox (IMAP)
  3. Source: Microsoft 365 mailbox (Graph)
  4. Monitor and manage sources
  5. Troubleshooting

Choosing a source

Reported emails reach Suspicious emails through a reporting mailbox, to which staff forward the email, or through a “Report” button in their mail client. Several sources can work together.

  • Mailbox (IMAP): with any provider, using a username and a password.
  • Microsoft 365 mailbox: read through Microsoft Graph without a password, it receives the emails from the “Report” button built into Outlook. A Microsoft 365 administrator prepares it once.
  • Outlook for Windows (VSTO), Outlook Microsoft 365 and Gmail (Google Workspace) add-ins: an administrator deploys them; the saved source provides the activation code.

With the Delete the email after reporting option, the reported email moves to the employee’s deleted items, from where it can still be recovered. Each add-in has its own deployment guide:

Classic Outlook on WindowsOutlook add-in for Windows: administrator guideOutlook on the web, new Outlook, Outlook mobileMicrosoft 365 Outlook add-in: administrator guideGmail and Google WorkspaceGmail add-on: administrator guide

Source: mailbox (IMAP)

First create a mailbox dedicated to reports. Points to check:

  • There is no unencrypted mode, and the port must match the mode: usually 993 for Direct TLS, 143 for STARTTLS.
  • The interval between two collections is at least 60 minutes: a reported email only appears at the next collection.
  • By default, the collected message stays as it is in the mailbox; the After collection: setting lets you mark it or delete it.
Only turn on Ignore certificate errors for an internal server whose certificate is not trusted: the server’s identity is no longer checked and a third party could pose as it. Fix the certificate instead.

What to tell your staff

Give them the mailbox address and ask them to forward the suspicious email as an attachment when possible: PhishTrainer then analyzes the original email as it is. In a regular forward, the original sender is only found if it remains readable in the forwarded block.

Source: Microsoft 365 mailbox (Graph)

An application registered in your Microsoft Entra reads this mailbox, and only this one. Two methods: Manually (recommended) in the Microsoft portals, or With the script, a PowerShell script that makes the settings for you.

“Manually” method

  1. Outlook “Report” button: in the Microsoft Defender portal, declare the mailbox as a SecOps mailbox (advanced delivery) and send reported messages to it (user reported settings).
  2. Entra application: under App registrations, create “PhishTrainer - Reporting” (accounts in this directory only, no API permission) and a client secret. Copy into the source the mailbox’s primary address, the tenant ID, the application ID, the secret “Value” (not its ID) and its expiry.
  3. Access limited to the mailbox: copy the object ID taken from Enterprise applications (not from App registrations) into Object ID (enterprise application), click Prepare the commands and run them in PowerShell 7 with an Exchange Administrator account. The last one must answer “InScope : True”.

“With the script” method

  1. Enter the mailbox’s primary address, then download and unblock the script. Run the generated command in PowerShell 7.2 or later, on an internet-connected workstation, not on an Active Directory server. -Simulation shows what the script would do without changing anything.
  2. Sign in as Exchange Administrator and Application Administrator, or as Global Administrator, then confirm with yes.
  3. Copy into the source the five values displayed at the end: the secret is only shown once.
The client secret expires (Microsoft recommends 24 months at most) and collection then stops. Before it does, create a new secret (script: same command with -RenewSecret) and enter it, with its date, in the source. To remove everything from your Microsoft 365: script with -Remove -ReportingMailbox followed by the mailbox address.

Monitor and manage sources

If reports stop arriving, look at the source’s last collection and latest error in My receiving sources. Disable keeps the configuration, Delete erases it permanently. To keep a saved password or secret, leave its field empty.

If your organization encrypts its data, the configuration of IMAP and Microsoft 365 sources is encrypted in your browser and your Bexxo Protected agent reads the mailbox. The vault must be unlocked to edit these sources; if the test answers “No agent answered in time”, check that the agent is running and connected.
Install and monitor the Bexxo Protected agentInstall the Bexxo Protected agentHow client-side encryption worksClient-side encryptionNext: classify the emails receivedTriage and classify suspicious emails

Troubleshooting

Message or symptomWhat to do
Warning “saved without encryption” on an IMAP sourceThe source is no longer collected. Open it, choose an encryption mode, test the connection, then save.
“Unable to read the mailbox” or “The folder to read cannot be found”Check the exact name of the folder to read. For Microsoft 365, if several folders have this name, rename one.
Microsoft 365 test refused, “Permissions are still propagating” or “Microsoft denies access to the reporting mailbox”Just after saving, wait up to 2 hours. If the refusal persists, run the script again, which checks and corrects the permissions, or check the Exchange commands from step 3 of the manual method.
A message is still unclear? Write to info@bexxo.ch with the source name and the message shown.

Didn’t find the answer? Contact us