Documentation Index

Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt

Use this file to discover all available pages before exploring further.

Configuring the Microsoft Entra ID Protection Connector for Sign-In Anomaly Data

Prev Next

Microsoft Entra ID Protection helps organizations detect identity-based risks for their Entra ID tenant. This article explains how to configure a connector for Microsoft Entra ID Protection to integrate data about sign-in anomalies with Cato events and the Cloud Activities Dashboard.

For more about viewing sign-in anomalies on the Cloud Activity Dashboard, see Using the Cloud Activity Dashboard.

Note:

Microsoft recently changed the name of Azure AD to Entra ID. All mentions of Azure AD in Cato documentation refer to Entra ID.

Overview of the Microsoft Connectors

To configure Cato's Microsoft Entra ID Protection connector to fetch sign-in anomaly data, first you need to configure the Microsoft 365 connector as the parent app to give read permissions for the Entra ID Protection connector. The parent app only has permissions to manage the Microsoft connectors. After configuring the Microsoft 365 connector, you can configure an Entra ID Protection connector to retrieve the sign-in data.

If you want to import sign-in data from different sub-organizations within your organization, create a separate Microsoft 365 connector for each relevant Entra ID tenant, and then configure an Entra ID Protection connector for each tenant.

Prerequisites

  • A Microsoft 365 E5 license or better, or a standalone Entra ID P2 plan is required.

  • The Microsoft 365 connector requires an admin with the global admin role to give permissions to Cato's Entra ID Protection connector.

Required Permissions for the Microsoft Entra ID Protection Connector

To let the Entra ID Protection connector retrieve the sign-in data for your account, the connector gives Cato the following permissions and actions with Microsoft 365:

  • Connect to the Microsoft APIs and read all Microsoft Entra ID Protection data for an organization.

  • Sign in and read the user profile.

Configuring the Microsoft Connectors

To configure the Entra ID integration, you need to:

  1. Create the MS Tenant Integration (if you do not have this already configured)

  2. Create the API connector in the CMA

Step 1: Configuring the MS Tenant Integration

First, configure the MS Tenant integration as the parent connector. This connector can be used for all Microsoft integrations. If you have already created the parent connector, go to step 2.

To create the Microsoft 365 parent connector:

  1. From the navigation menu, select Resources > Integrations and click the Integrated APIs tab.

  2. Click New. The New Connector panel opens.

  3. In the New Connector panel, select the Microsoft 365 (New Tenant) app.

    New_Microsoft_365_Connector.png

  4. Click Authorize and Save.

    A new browser tab opens to the Microsoft 365 app.

  5. In the new browser tab, authenticate to the Microsoft 365 app:

    1. Select the Microsoft account for the Microsoft 365 app.

    2. Enter the password for the app and approve it.

    3. Accept the permissions to let Cato access the Microsoft 365 app.

    4. The screen shows that you have successfully applied the permissions for the app.

      Success_Connector_Permissions.png

      You can close the browser tab and return to the Cato Management Application.

  6. The Microsoft 365 SaaS application is added to the Integrated Apps tab.

Step 2: Configuring the Microsoft Entra ID Protection Connector

After you have created the MS Tenant integration, you can create the Entra ID connector.  

Note:

When you create an API connector for a Microsoft 365 app, the connector creates an authentication certificate that is valid for 3 months, and renews the certificate 7 days before expiration.

To configure the Entra ID Protection connector:

  1. From the navigation menu, select Resources > Integrations and click the Integrated APIs tab.

  2. Click New. The New Connector panel opens.

  3. From the Saas Application drop-down menu, select Microsoft Entra ID.

  4. Select Sign In Anomalies Protection.

  5. In the Auth drop-down, choose Consent Microsoft

  6. Add a Name and Description for the connector.

  7. In the Parent ID drop-down, select the Microsoft Primary Tenant that was created in Step 1.

  8. Click Save.

    The CMA connects to the vendor

  9. Click Authorize.

    A Microsoft permissions screen will appear.

  10. Review the requested permissions and click Accept.

    The app is visible on the Integrated Apps table with a Connected status.

Understanding the Connector Status

The Status column on the Connectors Settings page shows the status of the connection between the Microsoft app and your Cato account. These are the explanations of the statuses:

  • Connected - Your account is connected to the app and it is working correctly.

  • Pending user consent - Permissions have not been granted to let Cato access the Microsoft 365 app. To resolve this issue, refresh the browser. If Status changes to Connected, the issue is resolved, if Status doesn't change, delete and recreate the connector.

  • Error - There is a connectivity, permissions, or other issue with the Microsoft connector. Delete and recreate the connector.

Cato Event Fields for Entra ID Protection Sign-In Anomalies

These are the relevant fields for Entra ID Protection sign-in anomaly events of sub-type Identity Alert:

  • Alert ID: Identification number for the alert in Entra ID Protection

  • Classification: Classification of the alert according to Entra ID Protection

  • Status: The alert status in Entra ID Protection

  • Event Message: A detailed description of the anomaly

  • Title: Name of the anomaly