Skip to main content
As soon as you activate this feature, the Isolate button appears in the detail view of every email.
Prerequisites

Configure Entra ID

  1. Go to Entra ID PortalOverview → copy the Tenant ID and keep it for future use. Your AAD Tenant ID
  2. In the menu left, go to App registrations → select All applications → copy the Application (client) ID and keep it for future use. Application (client) ID
  3. Open the xorlab app → Certificates & secretsAdd a certificate or secret in the list in the main view: Application certificates and secrets
  4. Click New client secret: New client secret
  5. Enter a description for the client secret and set the expiration time in the Add a client secret pane that shows up on the right. Click Add.
    Expiration reminderPlease make sure to set a reminder for the secret expiration date, since there is no warning message or other information from M365 on the expiring secret.
  6. Copy the Value of the secret and keep it for future use. This value is displayed only once. If you forget to copy the value or lose it, just delete this secret and create a new one. Secret value
  7. Select API permissions from the left pane and click Add a permission: Adding an API permission for your app
    Default permissionThere can be a default User.Read permission already added to your app. It can be left there.
  8. Choose Microsoft Graph: Selecting Microsoft Graph API
  9. Click Application permissions: Application permissions
  10. Available permissions grouped in categories are displayed. Use the search field to filter the permissions:
    • Filter for mail and check the box next to Mail.ReadWrite Selecting mail permissions
    • Filter for user.read and check the box next to User.Read.All Selecting user permissions
  11. Click Add permissions. On the main API Permissions page, you should see the three new permissions granted. Click the Grant admin consent for… button above the list to apply the permissions change. New permissions for your app

Configure xorlab

  1. In xorlab, open the Admin view in the upper right. If you have more than one tenant, select the one you want to activate case isolation for in the dropdown.
  2. Open Integrations, and add the Tenant ID, Application (client) ID and Client Secret value from before to the Credentials section and save it. M365 credentials
  3. Go back to the Expert Editor and open the file shared/guarded_tenants.yml.
  4. Enable case isolation for the corresponding tenant by adding these two lines:
    shared/guarded_tenants.yml
  5. Click Publish. Within about one minute, case isolation will be active for that tenant.

Next steps