Ctrlk
BlogSupport
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Cortex AgentiX

Set up Microsoft Entra ID as the Identity Provider Using SAML 2.0

Configure Microsoft Entra ID SAML 2.0 SSO for Cortex AgentiX with group claims, mappings, and authentication testing.

This topic provides specific instructions for using Microsoft Entra ID (formerly Azure AD) to authenticate your Cortex AgentiX users. As Microsoft Entra ID is a third-party software, specific procedures, and screenshots may change without notice. We encourage you to also review the Microsoft Entra ID documentation.

To configure SAML SSO in Cortex AgentiX, you must be a user who can access the Cortex AgentiX tenant and have either the Account Admin or Instance Administrator role assigned.

The following video is a step-by-step guide configuring SSO for Microsoft Entra ID: Microsoft Entra ID SSO.

Task 1. Configure Microsoft Entra ID Security Groups

Within Microsoft Entra ID, assign users to security groups that match the user groups they will belong to in Cortex AgentiX. Users can be assigned to multiple Microsoft Entra ID groups and receive permissions associated with multiple user groups in Cortex AgentiX. Use an identifying word or phrase, such as Cortex AgentiX, within the group names. For example, Cortex AgentiX Analysts. This allows you to send only relevant group information to Cortex AgentiX, based on a filter you will set in the group attribute statement.

Task 2. Copy Single SSO and Audience URI Values from Cortex AgentiX

  1. By default, SSO is disabled in Cortex AgentiX.

  2. Expand the SSO Integration settings.

  3. Copy and save the values for Single Sign-On URL and Audience URI (SP Entity ID).

    Both values are needed to configure your IdP settings.

    Important

    When copying the Single Sign-On URL value, remove idp/saml and leave the trailing /.

    For example, if the Single Sign-On URL is https://clientname.panproduct.region.paloaltonetworks.com/idp/saml, just copy https://clientname.panproduct.region.paloaltonetworks.com/.

  4. You cannot save the enabled SSO Integration at this time, as it requires values from your IdP.

Task 3. Configure Cortex AgentiX Application in Microsoft Entra ID

  1. From within Microsoft Entra ID, create a Cortex AgentiX application and Edit the Basic SAML Configuration.

  2. Paste the Single sign-on URL and the Audience URI (SP Entity ID) that you copied from the Cortex AgentiX SSO settings. The Single sign-on URL from Cortex AgentiX should be pasted in the Reply URL and the Sign on URL fields. The Audience URI (SP Entity ID) value from Cortex AgentiX should be pasted in the Identifier (Entity ID) and Relay State fields. This allows users to log in to Cortex AgentiX directly from Microsoft Entra ID.

  3. In the SAML Certificates section, click Edit and verify that Microsoft Entra ID is configured to sign both the response and the assertion.

  4. To have Microsoft Entra ID send group membership for the user in the SAML token, you must + Add a group claim in the Attributes & Claims section. Send the Security groups, using the source attribute Group ID. Use the word or phrase you selected when configuring Microsoft Entra ID security groups (such as Cortex AgentiX) to create a filter. Customize the name of the group claim as memberOf.

  5. In addition to group membership, verify that there are also claims for:

    • Email address

    • First Name

    • Last Name

Task 4. Copy Login URL, Microsoft Entra ID Identifier, and Attribute Claims

  1. In Microsoft Entra ID, from the Single sign-on page, in the Set up Cortex AgentiX Production section, copy the values for the Login URL and Microsoft Entra ID Identifier. You need these values to configure the SSO Integration in Cortex AgentiX.

  2. Edit Attributes & Claims and copy the values in the Claim name column. The claim name is case sensitive. You need these values to configure the SSO Integration in Cortex AgentiX.

    Note

    The default attributes shown on the main single sign-on page in Microsoft Entra ID are not the values you need. You must click Edit next to Attributes and Claims to view and copy the actual values.

Task 5. Download the Certificate

From the SAML Certificates section in Microsoft Entra ID, Download the Certificate (Base64). You need the contents of this file to configure the Cortex AgentiX SSO Integration.

Task 6. Copy the Source IDs for Microsoft Entra ID Security Groups

The claim for the membership attribute that is sent to Cortex AgentiX uses the Object Id of the group. The Object Id is different from the Microsoft Entra ID security group name. You can find the Object Id for each of your Microsoft Entra ID security groups by navigating to Users and groups in Microsoft Entra ID, clicking on the group name, and viewing the Object id. Create a list of the group names and corresponding Object Ids for every Microsoft Entra ID security group you want to map to a Cortex AgentiX user group.

Task 7. Configure the Cortex AgentiX SSO Integration

  1. By default, SSO is disabled in Cortex AgentiX.

  2. Expand the SSO Integration settings.

  3. Use the following table to complete the SSO Integration settings, based on the values you saved from Microsoft Entra ID.

    Microsoft Entra ID
    Cortex AgentiX Field

    Login URL

    IdP SSO URL

    Microsoft Entra ID Identifier

    IdP Issuer ID

    Contents of the downloaded certificate file.

    X.509 Certificate

  4. In the IdP Attributes Mapping section, enter the attribute claim names from Microsoft Entra ID. The names are case sensitive and must match exactly.

    Note

    The attribute claim name must exactly match the value sent by your IdP. In some cases, this may be the full attribute name/namespace, depending on the configuration of our IdP

  5. (Optional) Under Advanced Settings, select the checkboxes for ADFS and Compress encode URL (ADFS). In some circumstances, these fields may be required by your Microsoft Entra ID configuration.

  6. Save your settings.

Task 8. Map SAML Group Memberships to Cortex AgentiX User Groups

  1. Right-click a user group and select Edit Group.

  2. In the SAML Group Mapping field add the Microsoft Entra ID group(s) Object Ids that should be associated with this user group. Multiple Object Ids should be separated with a comma. The Microsoft Entra ID group Object Id must match the exact value sent in the token.

  3. Save your settings.

  4. Repeat for each user group.

Task 9. Test SSO Login

  1. Go to the Cortex AgentiX tenant URL and Sign-In with SSO.

    Note

    When using SAML 2.0, users are required to authenticate by logging in directly at the tenant URL. They cannot log in via Cortex Gateway.

  2. After authentication to Microsoft Entra ID, you are redirected again to the Cortex AgentiX tenant.

  3. When logged in, validate that you have been assigned the proper roles.

    To view your role and any role assigned to a user group you are a member of, click your name in the bottom left-hand corner, and click About.

PreviousSet up Okta as the Identity Provider Using SAML 2.0
NextEngines

Last updated

Was this helpful?