Help PhishTrainer Reports
Receive reports: mailboxes and mail client buttons
On this page
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:
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
993for Direct TLS,143for STARTTLS. - The interval between two collections is at least
60minutes: 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.
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
- 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).
- 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.
- 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
- 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.
-Simulationshows what the script would do without changing anything. - Sign in as Exchange Administrator and Application Administrator, or as Global Administrator, then confirm with
yes. - Copy into the source the five values displayed at the end: the secret is only shown once.
-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.
Troubleshooting
| Message or symptom | What to do |
|---|---|
| Warning “saved without encryption” on an IMAP source | The 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. |
Didn’t find the answer? Contact us