Skip to content
Cloudflare Docs

Office 365 directory integration

Email Security (formerly Area 1) can integrate with Office 365 to retrieve user and group information. This can be used to enforce the Business Email Compromise configuration to prevent user impersonation.

1. Authorize Email Security with Office 365 for Directory Access

You need to authorize Email Security to make connections into your Office 365 tenant ↗ to retrieve your directory details. The account used to authorize will require the Privileged authentication admin and Privileged role admin roles.

How does the authorization work?

The authorization process grants Email Security access to the Azure environment with the least applicable privileges required to function. The Enterprise Application that Email Security registers is not tied to any administrator account. Inside of the Azure Active Directory admin center you can review the permissions granted to the application in the Enterprise Application section.

When assigning user roles in the Office 365 console, you will find these roles in User permissions > Roles configuration > Identity admin roles.

A list of permissions for Email Security

  1. Log in to the Email Security (formerly Area 1) dashboard ↗, and select Settings (the gear icon).

  2. Go to Directories, and select Add Directory to start the authorization process.

    Go to Directories in the dashboard of Email Security, and then select Add Directory to start the authorization process

  3. In the Add Directory configuration panel, enter the following details:

    • Directory Type: Open the drop-down menu and select Office 365.
    • Directory Name: Enter a string that represents the directory. This value will be referenced in the Business Email Compromise List configuration section. For example, Office 365.
    • Sync Frequency: Update the value to your preference.

    Select Authorize when you are done.

    Add the appropriate details to the configuration panel

  4. The Email Security dashboard will redirect you to a Microsoft login page. Select or enter the appropriate account to initiate the authentication process.

    Select the appropriate Microsoft account to continue

  5. Once authenticated, the system will show a dialog box with a list of the requested permissions. Select Accept to authorize the change.

    Accept the permissions to continue

  6. Upon authorization, you will be automatically redirected back to the Add Directory configuration panel. Select Save to complete the authorization process.

    Select Save to complete the authorization process

  7. Once saved, your newly configured directory will appear in the configured directories table.

    Your directory will appear in the configured directories table

2. Configure the Business Email Compromise list

Now that Email Security (formerly Area 1) has been authorized to access and retrieve directory information, you will need to configure the Business Email Compromise list.

  1. Log in to the Email Security (formerly Area 1) dashboard ↗, and select Settings (the gear icon).

  2. Go to Email Configuration > Enhanced Detections > Business Email Compromise.

    Access Business Email Compromise in Email Security (formerly Area 1) dashboard to start setting up this feature

  3. Open the drop-down menu and select the directory you have created in the previous step 3.

    Select the directory you have created in the previous step 3

  4. If the initial directory synchronization has completed, the page will refresh and list groups and users. If you do not see any information, wait a few minutes as the system completes processing the initial synchronization.

    The screen should refresh and show a list of users and groups

  5. Select the arrow next to a group to expand it and show its members.

    Select the arrow to expand it and show a list of its members

  6. To protect an entire group, select the three-dots button next to it, and then select Protect. When you protect a group, all of its members will be automatically protected. The protection markers will turn green to indicate that protection is active.

    You can protect an entire group of users. The protection markers will turn green to show that protection is active

  7. You can also protect individual users. Select the three-dots button next to each user you want to protect, and then select Protect.

3. Configure secondary email address (if required)

When the Business Email Compromise list is configured, Email Security (formerly Area 1) will enforce the proper match of the sender’s display name and email address. Any variation from this strict requirement will raise a detection event. The reason of detection will be Protected Name <NAME> should not appear as <non-configured email address>.

In some instances, you may want to allow your protected users to send emails from an alternate email address (like their personal email address). To configure this alternate address, you will have to add it to their directory entry.

  1. Log in to the Email Security (formerly Area 1) dashboard ↗, and select Settings (the gear icon).

  2. Go to Email Configuration > Enhanced Detections > Business Email Compromise.

  3. Search for the user you want to allow an alternate email address.

  4. Select the three-dots button > Edit.

    Select edit to add alternate email addresses to your user

  5. In Secondary Emails add the additional email addresses. Place each entry on a new line.

    Add each new email address to the Secondary Emails field. Place each address on a separate line

  6. Select Save to finish.

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings