Microsoft Entra ID (Azure AD) SSO Integration

06/06/2024

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: For CII US production tenants: https://login.oort.io/login/callback For CII EU production tenants: ​https://login.eu.oort.io/login/callback For CII AU production tenants: ​ https://login.au.oort.io/login/callback For CII JP production tenants: ​ https://login.jp.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.

Provide Client ID and Client Secret to Oort Success & Support Team

As part of this process, Oort Customer Success or Support team will guide you in securely transmitting the App Registration data below so that the configurations can be finished on the Oort authentication platform.

• Client ID

• API Secret

• Azure tenant external FQDN or primary domain (e.g. company.com or company.onmicrosoft.com)

Make the Azure App Visible to End Users

Oort strongly recommends you make the Azure SSO app visible to your Oort users, so that they have quick access to the Oort console from their Azure My Apps page.

1. Navigate Enterprise Applications

1. Find Oort's 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

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

   
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 Make the Azure App Visible to End Users

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.