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 Ribbon Button 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. For non-Huntress phishing emails, you can also forward the message directly to Microsoft at phish@office365[.]microsoft[.]com.
The Microsoft Outlook Report a Phish Ribbon Button add-in lets Huntress Managed Security Awareness Training users report suspected phishing messages. Huntress simulated phishing reports are recorded in the SAT portal. Other messages are sent to the reporting address configured in the administrator portal.
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 this add-in with the following Outlook clients:
- New Outlook for Windows.
- Outlook on the web.
You must have a licensed Microsoft 365 account to use this add-in.
For other Outlook clients, including Classic Outlook, use the Reading Task Pane 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.
Install the Ribbon Button 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 required permissions, and select Accept.
-
After authorization succeeds, confirm that the Authorization Complete page appears.
-
Return to Settings > Phishing. In the Integrated Ribbon Button section, select + View Details.
-
Select Download installation manifest to download the
HuntressLabsRAPManifestRB.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
HuntressLabsRAPManifestRB.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 ribbon.
Reporting a message with this add-in deletes the message from the user's mailbox.
When a user selects the ribbon button, Outlook prompts them 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.
Other Messages
If the message is not a Huntress simulated phishing email, the user receives a confirmation 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 I have the manifest file (.xml) on this device and select Choose File.
- Select the updated manifest file and select Update. Updates may take up to 72 hours to reach users.
- If prompted, return to Settings > Phishing in the SAT admin portal and reauthorize the required permissions.
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 add-in.
- In the confirmation window, select Remove.
- Refresh the Integrated Apps page and confirm that the add-in was removed.
- To reinstall the add-in, follow the steps in Install the Ribbon Button 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.