How to Deploy the Microsoft Ribbon Reporter Add-In

How to Install the Microsoft Ribbon Phishing Reporter

1. Customize Phishing Reporter for your organization's needs

2. Go to Phishing Reporter > Manage and Download section and click “Connect Account”

Phishing Reporter Manage and Download — Connect Account.

1. Log in to your Microsoft 365 account using your admin credentials.

2. Once you log in, the Permissions requested pop-up window will display. Read the permissions, then click Accept.

Permissions requested pop-up — Accept to grant Graph API permissions.

1. Once you accept the permissions, the GRAPH Authorization Successful window will display.

Graph Authorization Successful window.

1. Click the Download icon below the Microsoft Ribbon Phishing Reporter option to download the PhishingReporterRibbon.xml file.

2. In a new tab of your browser, log in to your Microsoft 365 admin center.

Microsoft 365 admin center.

1. From the menu on the left side of the page, click Settings.

2. From the Settings drop-down menu, select Integrated apps.

Settings — Integrated apps menu.

1. Click Add-ins at the top-right corner of the page. The Add-ins page will open

Add-ins button on Integrated Apps page.

1. On the Add-ins page, click Deploy Add-In. The Deploy a new add-in pop-up window will open.

Deploy Add-In button.

1. In the pop-up window, click Next.

Deploy a new add-in pop-up — Next.

1. Click Upload custom apps.

Upload custom apps option.

1. Select the I have the manifest file (.xml) on this device option. Then, click Choose File and select the PhishingReporterRibbon.xml file that you downloaded in step 6.

Choose File to select PhishingReporterRibbon.xml.

1. Click Upload to install the Phishing Reporter. The Configure add-in pop-up window will open.

Configure add-in pop-up after upload.

1. From the pop-up window, select which users will have access to the Phishing Reporter and which method you would like to use to deploy the Phishing Reporter.

Deploy Phishing Reporter — select users and deployment method.

We recommend that you allow all users to access the Phishing Reporter. We also recommend that you use the Fixed deployment method.

1. Click Next, and additional app permissions will display.

2. Once you have read the permissions, click Save. The Deploy Phishing Reporter pop-up window will open.

Add-in successfully installed message.

The expected timeframe for the Phishing Reporter to deploy is 24 hours, but timeframes can vary. For more information about deploying add-ins, see Microsoft's Deploy add-ins in the Microsoft 365 admin center article.

1. Once the pop-up window displays a confirmation that the add-in successfully deployed, click Next. The Announce add-in pop-up window will open and display a message about announcement recommendations from Microsoft.

Announce add-in pop-up — Microsoft recommendation message.

After you install and deploy the Phishing Reporter, you might receive an email from your mail service provider that contains information you can use to help you announce the Phishing Reporter add-in to your users. Keepnet does not send the email about the Phishing Reporter’s intended usage and benefits.

1. Click Close to close the pop-up window.

Troubleshooting Microsoft Ribbon Phishing Reporter

We were unable to process this item. Please try again later.

"We were unable to process this item. Please try again later." message in the Ribbon Phishing Reporter in Outlook.

Troubleshooting — We were unable to process this item Ribbon error.

We were unable to process this item issue on Microsoft Ribbon Phishing Reporter

The suggested solution is to "Toggling on New Outlook"

Toggling on New Outlook

Tutorial Video

This video tutorial shows the documentation steps for deploying Microsoft Ribbon Phishing Reporter add-in on M365.