Skip to content
Submit a Ticket
  • There are no suggestions because the search field is empty.

Microsoft Report Button - Activating the integration with Nimblr

A brief guide on how to connect your Microsoft Report Button to Nimblr


Connecting your Microsoft Report Button to Nimblr will allow your administrators to track and display in your portal which users are in fact reporting the Nimblr Phishing Simulations or not.

Create a new shared mailbox

  1. Go to: https://admin.cloud.microsoft/?#/SharedMailbox and create a new shared mailbox

  2. Go to: https://security.microsoft.com/ and go to the “Email & Collaboration” > “User reported settings”

  3. Set “Send reported messages to:” > “Microsoft and my reporting” mailbox

  4. Select the shared mailbox you just created.

Create and configure a New App Registration

  1. Sign in to Microsoft Entra

  2. Go to the Applications tab: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredA pps/ApplicationsListBlade/

  3. Navigate to: All applications > New registration

  4. Create a new app registration

  5. Go to API permissions and click: Add a permission

  6. Select Microsoft Graph and then choose: Application permissions

  7. Select Mail.Read and Save

  8. Grant Admin consent for this permission

  9. Go to Certificates and secrets and create a new secret

  10. Copy the Value (Not the secret ID) and paste it in a text document for later

  11. Go to Overview and copy: Application (client) ID and Directory (tenant) ID in the same document as the Client secret

 

Configure in the Nimblr Portal

  1. Go to Settings tab > Report Button >

  2. Fill in the following credentials: Application (client) ID, Directory (tenant) ID and Client secret

  3. Select the mailbox you created in step 1.

  4. Now it's Done!

Limiting the permissions (Optional)

  • Open up PowerShell

Run the following command to sign in:

  • Connect-ExchangeOnline -UserPrincipalName

Create a new distribution group:

  • New-DistributionGroup-Name "API-Access-Group-V2 Security" -Members -Type Security

Add the policy:

  • New-ApplicationAccessPolicy-AppId "" PolicyScopeGroupId " @" AccessRight RestrictAccess -Description "Restrict app to shared mailbox only"

Allow up to 48 hours for the policy to take effect. 

If you have any further questions, feedback or requests just reach out to us at:                                                    support@nimblrsecurity.com
                                                                   Or
                                                        Submit a Ticket