Steps to Configure Azure AD as External IDP for Cymmetri

Setting up Cymmetri Service Provider for External Identity Provider Configuration

Login into the Cymmetri Administration Console for the below configuration

Note: The user interface may differ but the configuration options will remain the same.

1. Navigate to Service Provider.
2. Click on “Add New”.

3. Enter Cymmetri as Service Provider Name and the description, select Email as Name ID Policy dropdown and save the details. Your Service provider is created at this step, download the metadata(xml file) of the same.
4. Navigate to External IDP in Identity Provider.

5. Select Azure-IDP.

Configure Azure AD for Creating Identity provider configuration

6. Now Login to Azure portal and select Azure Active Directory.
7. Navigate to Enterprise applications and select New application.
8. Create your own application and enter the name of the application.
9. Set up Single Sign On after creating the application using SAML.
10. Click on Edit basic SAML configuration.

11. Add Identifier (Entity ID) and Assertion Consumer Service URL from the xml file downloaded in step 3 (For Azure, Sign on and ACS URL is the same) and save the configuration.

12. Download the Certificate (Base64) from SAML Certificates.

Continue configuration of Identity Provider In Cymmetri Administration Console

13. Copy Azure AD Identifier from Set up, navigate to azure-idp in Cymmetri and paste it in Entity ID. Similarly, copy login URL and paste it in Single Sign On Service URL in Cymmetri.

14. Replace the text "<host-name>" as the URL of the Cymmetri deployment (e.g., https://aktestidp.ux.cymmetri.in) "aktestidp.ux.cymmetri.in" in the destination field - "https://<hostName>/spsamlsrvc/samlSP/SingleSignOnService" as "https://aktestidp.ux.cymmetri.in/spsamlsrvc/samlSP/SingleSignOnService".

15. Open the Base64 certificate downloaded in step 12, copy it and then paste it in x509Certifcate field in Cymmetri.

16. Select the created service provider in the Service provider Id field dropdown and save the changes.
17. Navigate to Auth Rules in Cymmetri and select Add New
18. Add Name and description and Select Identity Provider as Azure (External IDP) and mark the status as Active.

19. Click on Add Condition.
20. If you wish to set this Azure External Identity provider for users having email address ending with "@unotechsoft.com" then you may select condition as LoginPattern > Regular Expression and its value as (.)*(@unotechsoft.com)+$; and save the details.

Assigning user to application in Azure Administration Console for allowing users to use Azure as External Identity provider

21. Navigate to Enterprise applications and select the application you created in step 8.

22. Go to Users and groups and select Add user/group and add the user.

Configuring JIT provisioning in Cymmetri Administration Console

24. If JIT provisioning needs to be enabled for Azure AD as external Identity provider, we may set it up using the steps below.

25. Navigate to JIT in external identity provider and enable JIT Configuration.

26. The following fields are mandatory in Cymmetri - firstName, lastName, login, userType, displayName, and email.

27. For Azure JIT configuration, the following mapping needs to be done -

    1. First Name -

       1. Application Field - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname

       2. Cymmetri Field - firstName

    2. Last Name -

       1. Application Field - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

       2. Cymmetri Field - lastName

    3. Login (Username) -

       1. Application Field - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name

       2. Cymmetri Field - login

    4. User Type -

       1. Application Field - any string

       2. Cymmetri Field - userType

       3. Default Value - <will be one of Employee, Vendor, Consultant>

    5. Display Name -

       1. Application Field - http://schemas.microsoft.com/identity/claims/displayname

       2. Cymmetri Field - displayName

    6. Email Address -

       1. Application Field - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name

       2. Cymmetri Field - email

          

In Azure Administration Console

30. Login to cymmetri using Azure Email Address
31. The user will be redirected to the Azure portal to enter the Azure credentials.
32. Once the credentials have been entered properly in Azure portal, the user will be redirected back to Cymmetri and will be logged in successfully.