Microsoft 365

You can integrate your Microsoft 365 environment with the Incident Responder product to start an investigation on users' email accounts by following the steps below.You must use an account with global administrator permission.

New Application

  • Select App Registration on the Microsoft Azure portal.

  • Click +New registration.

  • In the Register an application section, enter the name of the new application (required field).

  • Select supported accounts from the Accounts in this organizational directory only option (auth secure login only - single-tenant).

  • Select Public client/native (mobile & desktop) from the dropdown menu to enter a Redirect URL.

  • Click Register. (Leave the myapp://auth field section blank).

  • The new application will now appear in the list of app registrations; click on the name of the new application.

  • Under Essentials, you will see the following displayed:

    • Application (client) ID

    • Directory (tenant) ID

  • Please take note of these as you will need this information later to set up the new configuration.

Now you are ready to proceed to the next step: the application secret key.

Application Secret Key

An application secret key must be created for the new registration.

  • Under Manage from the left-side menu, select Certificates & Secrets.

  • Select Client secrets.

  • Select +New client secret.

  • Enter the description and expiration date and click Add.

  • Make sure to save the secret key value before you move on to the final step.

Application Permissions

The last step is to add application permissions.

  • Select Manage > API Permissions and click +Add permission.

  • Click Microsoft Graph and a new window called Request API permissions will appear.

  • Click Application permissions and then choose Application Permission and in the Select permissions field, find and select the following required permissions:

    • Directory.Read.All

    • Mail.ReadWrite

    • MailboxSettings.ReadWrite

    • User.Read.All (under User)

  • Click Add permissions.

  • Click Grant admin consent for (user).

You can find more information about these permissions at “About Permissions”.

Test the Email Server Integration

You can test the integration on the platform to make sure that it is working. Go to Incident Responder > Mail Configurations on the left sidebar menu of the dashboard and then click + NEW and choose the mail provider - in this case, Office 365.

Complete the following fields in the Microsoft Office 365 configuration table. The integration details are:


Name of the configuration

Application (client) ID

Application ID information is provided on the azure portal under the Overview menu.

Application Secret

Application Secret information is provided on the azure portal under the Overview menu.

Directory (tenant) ID

Directory ID information is provided on the azure portal under the Manage > Certificates & secrets menu.

Test Email Address

An active email address to be used for testing purposes

Domain Selection

Authorized domain(s) to start investigations on

Test Connection

Perform a test of the configuration

If the test was successful, the new email server integration will be shown in the list of mail configurations.

If an X appears, it indicates there was a problem and the email server integration failed; please wait a few minutes (5-10+min) for O365 to successfully complete the integration, and then if not work still, please review the instructions.

About Permissions

Directory.Read.All (Get user list)

This permission allows the app to read data in your organization's directory, such as users, groups, and apps. Note: Users may consent to applications that require this permission if the application is registered with their organization’s tenant.

The platform uses this permission to retrieve the client's user list when an investigation is initiated and then to access the email addresses. For example, when a user finds a suspicious email, the platform can scan all users in the list retrieved.

Mail.ReadWrite (Get users mails)

This permission allows the app to create, read, update, and delete email in user mailboxes. It does not include permission to send mail. The platform uses this permission to scan and filter users' emails. For example, when the “From” filter is selected as a parameter to be used in an investigation, this authorization enables the creation of a list of the emails that meet this criterion. It is also used to send a warning message to users. This permission also allows the platform to scan the contents of the emails to find and match the designated investigation parameters. For example, specific filters such as regex, keywords, etc.

MailboxSettings.ReadWrite (Warning action)

This permission allows the app to create, read, update, and delete the user's mailbox settings. It does not include permission to send mail directly, but allows the app to create rules that can forward or redirect messages. The platform uses this permission to mark emails that will receive a warning message.

User.Read.All (Get user data)

This permission allows the app to read the full set of profile properties, reports, and managers of other users in your organization on behalf of the signed-in user. The platform uses this permission to read and filter user information during the scanning process. If user-related filters, such as specific users, are selected as scan criteria, the user information may need to be read. For example, an organization may elect to initiate an investigation of employees in a particular department.


Q: Is it possible to run a suspicious email investigation on the platform 24/7?

A: Yes. The platform’s flexibility allows you to start an investigation at any time and specify how long it is to run, or to create a continuous, automatic search for harmful e-mails. Server-based integration with your email service provides the most comprehensive protection.

Q: Is it possible to start investigations and delete harmful emails without Office 365 and Exchange EWS integration?

A: Yes. The Phishing Reporter plug-in can be used to conduct investigations and mitigation. However, the user must have Outlook open and the plug-in active. Email server integration eliminates this limitation.

Last updated

Copyright © Keepnet Labs LTD. All rights reserved.