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.
  2. In the menu left, go to App registrations → select All applications → copy the Application (client) ID and keep it for future use.
  3. Open the xorlab app → Certificates & secretsAdd a certificate or secret in the list in the main view:
  4. Click 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.
  7. Select API permissions from the left pane and click Add a permission:
    Default permissionThere can be a default User.Read permission already added to your app. It can be left there.
  8. Choose Microsoft Graph:
  9. Click 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
    • Filter for user.read and check the box next to User.Read.All
  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.

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.
  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