Team: Huntress Managed Security Awareness Training (SAT)
Product: Microsoft Outlook Report a Phish add-in
Environment: SAT admin portal and Microsoft 365 admin center
Summary: Install the Microsoft Outlook Report a Phish Reading Task Pane add-in to let users report suspected phishing messages. Huntress simulated phishing reports are recorded in the SAT portal, while other messages are sent to the configured reporting address.
The add-in does not block email addresses. To send reported messages to another email address, use the Forward Reported Phishing Attempts feature.
The Microsoft Outlook Report a Phish Reading Task Pane add-in lets users report suspected phishing messages. Depending on the message type, the add-in records the report in the SAT portal or sends the message to the configured reporting address.
In This Article
- Requirements
- Install the Add-In
- Verify the Add-In
- Update the Add-In
- Remove and Reinstall the Add-In
- Troubleshoot the Add-In
Requirements
You can use the add-in with the following Outlook clients:
- Classic Outlook
- New Outlook on Windows or macOS
- Outlook on the web
- Outlook mobile on iOS or Android
For New Outlook and Outlook on the web, you can also use the Report a Phish Ribbon Button add-in.
Make sure your Outlook client is up to date. Outlook versions that are past Microsoft's support lifecycle are not supported by the add-in.
Before you begin, make sure you can access the Huntress Managed Security Awareness Training admin portal and the Microsoft 365 admin center. Use an account that can authorize the required Microsoft permissions.
Install the Add-In
Authorize the add-in in the SAT admin portal, download the organization-specific manifest, and deploy the manifest in the Microsoft 365 admin center.
Authorize the Add-In
- Sign in to the Huntress Managed Security Awareness Training admin portal at
mycurricula.com. If you are an MSP, select the customer organization where you want to add the integration. - Go to Settings > Phishing.
-
In the Report a Phish Button Add-in for Outlook section, locate the installation details for the available Report a Phish add-ins.
- Select Accept Microsoft Permissions. A Microsoft permissions request page opens in a new browser tab.
-
Sign in with your Microsoft 365 administrator account, review the requested permissions, and select Accept.
-
After authorization succeeds, confirm that the Authorization Complete page appears.
-
Return to Settings > Phishing. In the Reading Pane Button section, select + View Details.
-
Select Download installation manifest to download the
HuntressLabsRAPManifestTPB.xmlfile. The portal generates a manifest unique to your organization. If you are an MSP, open each customer organization and download the correct manifest for that organization.
Deploy the Manifest in Microsoft 365
-
Sign in to the Microsoft 365 admin center and go to Integrated Apps. Select Upload custom apps.
-
In the Deploy New App pane, set App type to Office Add-in with an XML manifest. Under Choose how to upload app, select Upload manifest file (.xml) from device. Select Choose File, select
HuntressLabsRAPManifestTPB.xml, and confirm that Manifest file validated appears. Then select Next. - On the Add users page, select the users or groups who should receive the add-in. We recommend creating and deploying to specific users or groups rather than All users.
- On the Accept permissions requests page, review the app's permissions and capabilities. Select Accept permissions and complete the sign-in flow if prompted.
-
Review the selected app and assigned users, then select Finish deployment. Deployment may take a moment to complete.
Verify the Add-In
After deployment, open an email in Outlook and confirm that the Report a Phish button appears in the reading task pane.
When a user selects the reading task pane button, Outlook prompts the user to confirm that the message is phishing rather than spam.
The add-in displays one of the following results:
Huntress Simulated Phishing Message
If the message is a Huntress simulated phishing email, the user receives a confirmation message and the report is recorded in the SAT portal.
The reported message also displays a notification confirming the report.
Other Phishing Messages
If the message is not a Huntress simulated phishing email, the add-in displays a confirmation and sends the message to the configured reporting address.
The reported message also displays a notification confirming that the message was reported.
Update the Add-In
New features may require you to download and deploy an updated manifest. Updated manifests are available in the Huntress Managed Security Awareness Training admin portal as they are released.
- Sign in to the Huntress Managed Security Awareness Training admin portal and download the updated manifest for the add-in.
- Sign in to the Microsoft 365 admin center and go to Integrated Apps.
- Select the Report a Phish add-in to open its configuration window.
- Select Update add-in.
- In the Update Report a Phish window, select Upload manifest file (.xml) from device and select Choose File.
- Select the updated manifest file and select Next.
- Ensure the permissions are accepted, and select Update.
Remove and Reinstall the Add-In
Remove the existing add-in before deploying the manifest again.
- Sign in to the Microsoft 365 admin center and go to Integrated Apps.
- Select the Report a Phish add-in to open its configuration window.
- Select Remove app.
- Tick Yes, I'm sure I want to remove the app and associated data, and select Remove.
- To reinstall the add-in, follow the steps in Install the Add-In.
Troubleshoot the Add-In
If you see the error below, update the browser component used by Outlook on the affected device, then try again.