NINJIO ALERT: Setup NINJIO XML Button (for IT Pros)

This article covers how to configure NINJIO's Phish Report button to work with the simulated phishing reporting platform.

Document Updated for XML v2.0.

Prerequisite notes on Microsoft behavior:
Microsoft 365 add-in changes can take up to 72 hours to fully propagate.
If the button still has not updated, the user may need to sign out and back into M365 and restart Outlook.
 

Part A - (Optional) Remove a legacy button
Removes an existing legacy button to prevent duplicate report button deployments.

1. Go to M365 Admin Center – Integrated Apps
2. Click the existing legacy button to remove
3. Click "Remove app", then check “Yes, I’m sure…", then “Remove”, then “Done”

Part B - Enable the NINJIO button
Sets up the platform and prepares the deployment XML file.

(Existing deployments: Please check with support@ninjio.com, prior to proceeding)

1. Go to NINJIO Platform
2. Navigate to "Phish Reporting", then "Reporting settings"
3. Toggle on "Enable reporting button"
4. Click "Download manifest" (expect file: Reporting_Button_App_Manifest.xml)

Part C - Deploy NINJIO button
Deploys the NINJIO ALERT Button to selected users through the Microsoft 365 Integrated Apps workflow.

1. Go to M365 Admin Center – Integrated Apps
2. Click "Upload custom apps"
3. For “App type”: Select “Office Add-in", then “Upload manifest file (.xml) from device”, then “Choose File”
4. Select the downloaded manifest file, then click “Next”
5. For “Assign users”: You can choose to deploy to "Entire organization" or by "Specific users/groups", then click “Next”
6. Click “Accept permissions”, then proceed through next several screens to authenticate as Global Administrator. When “Permissions requested” screen shows, click “Accept”
7. Click "Next", then "Finish deployment", then “Done”