Microsoft Entra ID (Azure AD) SSO Integration

Overview

You can connect your Microsoft Entra ID to Cisco Identity Intelligence (CII) to enable SSO to your organization. Enable and control your organization members access to the CII platform easily, by following this guide to setting up CII as an app in your Microsoft Entra ID console.

Types of SSO Integrations Available

CII supports two methods of SSO integration with Microsoft Entra ID:

1. OIDC - this method provides a fast and simple App Registration flow for SSO to your CII tenant. Note that full RBAC group management within the CII tenant is not supported with Entra ID OIDC.

2. SAML - a SAML integration with CII for sign-on provides the ability to enable RBAC groups for full admin, help desk, and read-only roles. NOTE - the current cross-tenant integration with Duo Security and CII does NOT support the in-product provisioning of SAML authentication for your CII tenant. Use the OIDC SSO Method or contact your Duo / CII representative to discuss setting up SAML authentication with Microsoft.

This article provides instructions for both methods. In many cases, an CII tenant may start with OIDC-based SSO and migrate to SAML SSO to enable RBAC functionality, as mentioned above.

Prerequisites

To add the necessary configuration in Microsoft Entra ID you need:

• Microsoft Entra ID - Global Administrator or Service Administrator role https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-users-assign-role-azure-portal​

• Microsoft Entra ID Subscription - Owner role https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal-subscription-admin​

• Microsoft Entra ID resource provider enabled. In most existing tenants, this is already done, but if not, please see Appendix: Enable Azure AD resource provider

OIDC SSO Method

Set up and configure Oort App Registration in Microsoft Entra ID

You will need to create the app registration in your Entra ID tenant, assign the correct permissions, and add an API secret.

Add an app in your Microsoft Entra ID tenant

1. Go to Microsoft Entra ID → App registrations

1. Click on New registration

1. Fill in the details for the new app

• Enter an app Name

• In “Who can use this application or access this API?” Select: Accounts in this organizational directory only (<tenant name> – Single tenant)

• In “Redirect URI”:

  • select Platform: Web

  • Enter the redirect URI: US production tenants: https://login.oort.io/login/callback EU production tenants: ​https://login.eu.oort.io/login/callback AU production tenants: ​ https://login.au.oort.io/login/callback JP production tenants: ​ https://login.jp.oort.io/login/callback UK production tenants: ​ https://login.uk.oort.io/login/callback Canada production tenants: ​ https://login.ca.oort.io/login/callback Singapore production tenants: ​ https://login.sg.oort.io/login/callback

1. Click on Register

1. Copy and save the Application ID and save it for later use.

1. From the Entra ID overview page, copy the Tenant ID. The Entra ID OIDC Discovery URL takes the form of: https://login.microsoftonline.com/TENANT/v2.0/.well-known/openid-configuration where TENANT is your Tenant ID.

Add API Permissions

1. Go to API Permissions under your newly created Oort Integration app

2. Click on Add a permission

3. Click on Microsoft Graph

1. Click on Application Permissions

2. Search for “Directory.Read.All”

3. Check the box next to Directory.Read.All

1. Search for “User.Read.All”

2. Check the box next to “User.Read.All”

1. Once added to the list, click Add Permissions

2. Click on Grant admin consent for <tenant name>

1. Click Yes to accept admin consent.

Create API secret

1. Go to Certificates & Secrets under your Oort Integration app

2. Click on New client secret

3. Fill in the details for the secret and click Add

1. Save the Secret Value

• Click the copy icon to copy and save it somewhere

• Important: Once you leave this page you WILL NOT be able to get the key again and will have to delete and create a new one.

Enter SSO App Information in the Duo Admin Panel

If using Duo Security to provision your tenant from the Duo admin panel, continue the configuration in that console using the app ID, tenant ID, and app secret according to https://duo.com/docs/identity-security#provision-your-cisco-identity-intelligence-tenant.

IMPORTANT: Provision the Entra App to Users

We strongly recommends you do two things in the Enterprise App object that was created in parallel to the new SSO app registration:

1. Set assignment required to YES (the default is NO, making the app open to all tenant end users)

2. Set app visible to YES, so that they have quick access to the CII console from their Entra ID My Apps page.

Instructions

1. Navigate Enterprise Applications

1. Find the CII SSO app in the list and click it.

2. In the app’s page, click Properties in the Menu

3. Select Yes for Assignment required and for Visible to users

4. Click Save

1. Navigate to the Users and Groups tab of the enterprise app. Assign the appropriate individual users and/or groups that should have access. (Group usage is recommended)

SAML SSO Method

This method uses SAML, which enables the provider (Microsoft Entra ID) to pass group information that will be used in the Role-based Access (RBAC) and Tenant Access Logs configuration for your tenant.

NOTE FOR DUO CUSTOMERS - the current cross-tenant integration with Duo Security and CII does NOT support the in-product provisioning of SAML authentication for your CII tenant. Use the OIDC SSO Method or contact your Duo / CII representative to discuss setting up SAML authentication with Microsoft.

Create a New SAML SSO App

1. Within Microsoft Entra ID Enterprise Apps blade, click Create your own application and provide a name as shown. Then click Create and the bottom of the slide-out.

   
2. From this page, click Set up single sign on

   
3. Click SAML

   
4. Click the Edit button for the Basic SAML Configuration section

   
5. At this point, the values entered will differ depending on the deployment location of your CII tenant, such as US, EU, AU, CA, UK, SG or JP environments. Please discuss with your Cisco technical representative to ensure the right configuration. US Production Identifier (Entity ID): urn:auth0:oort:<companyname>-saml Production Reply URL: https://login.oort.io/login/callback EU Identifier (Entity ID): urn:auth0:oort-eu:<companyname>-saml Production Reply URL: https://login.eu.oort.io/login/callback AU Identifier (Entity ID): urn:auth0:oort-au:<companyname>-saml Production Reply URL: https://login.au.oort.io/login/callback JP Identifier (Entity ID): urn:auth0:oort-jp:<companyname>-saml Production Reply URL: https://login.jp.oort.io/login/callback UK Identifier (Entity ID): urn:auth0:oort-uk:<companyname>-saml Production Reply URL: https://login.uk.oort.io/login/callback CA Identifier (Entity ID): urn:auth0:oort-ca:<companyname>-saml Production Reply URL: https://login.ca.oort.io/login/callback SG Identifier (Entity ID): urn:auth0:oort-sg:<companyname>-saml Production Reply URL: https://login.sg.oort.io/login/callback

   
6. Save the config.

7. Click Edit for section 2 - Attributes & Claims

8. Click Add new claim

9. Configure the claim as shown below: Name: groups Namespace: http://oort.io In the Claim conditions section, add a row for each RBAC of the three groups that you've created for Oort roles in your Microsoft Entra ID tenant. If you haven't created them yet, do that now and populate them with the appropriate users. User type: Any Scoped group: Select one for each row Source: Transformation Values: Transformation: IfNotEmpty() Attribute name (Input): user.userprincipalname Attribute name (Output): <name of group specified for this condition, case sensitive>

   

   
10. Click enter and then save this configuration after adding a row for all three groups.

11. In section 3, Download the Base64 Certificate

12. In section 4, copy the Login URL value.

13. Provide both the downloaded certificate and the URL to your Oort representative.

14. See the section Microsoft Entra ID (Azure AD) SSO Integration

Appendix: Enable Microsoft Entra ID resource provider

Enable AzureAD resource provider under your license.

1. Go to Home → Subscriptions

1. Click your subscription (the relevant subscription)

1. Click Resource Providers in the menu

2. Search for Microsoft.AzureActiveDirectory and select it.

3. If the Status says NotRegistered

4. Click on the Register button to register the Microsoft AzureAD resource provider.