Skip to main content
Logo

Register Contensis with Azure AD

Overview

To be able to register Contensis CMS with Azure, you will first need to complete the following actions on Azure:

  1. Register a new application
    Register the Contensis CMS instance.

  2. Update the application manifest
    Allows group integration and adds the application id url.

  3. Update permissions
    Allows user integration.

  4. Obtain relevant federation data for the CMS 
    Obtaining credentials and discovery document data that is required to allow the Zengenti identity provider to federate with your registered Azure application.

Registering a new application

Go to the Azure portal and click ‘Azure Active Directory’ from the options in the left panel.

01

You will now be taken to the ‘Azure Active Directory Overview’ screen.

Click ‘App Registrations’ from the ‘Manage’ section.

02

You now have the option to add a new registration.

Click ‘+ New registration’ in the toolbar.

03

You’ll be presented with a form allowing you to enter initial application registration information.

Name
This is the display name for the registration in your Azure portal,  and can be anything of your choosing.

Supported Account Types
This defines the types of accounts the application grants permissions to.

Redirect URI
This is not optional and is a requirement for the Zengenti identity provider. It should be entered in the following format:

https://<your cms domain>/authenticate 

e.g. https://zengenti.contensis.com/authenticate

After completion, the form should look similar to the following:

04

Click ‘Register’. The application is now registered.

Update the application manifest

To allow the Zengenti identity provider to be able to identify itself, and process a user’s group membership, the application manifest must now be amended.

Click ‘Manifest’ from the application overview: 

05

Update the ‘groupMembershipClaims’ value to ‘SecurityGroup’ , then add the application id url in the form of ‘https://<your domain>/authenticate’, as shown below.

Click ‘Save’. 

06

A message will display confirming that the manifest has been updated successfully.

06b

Update permissions

The Zengenti identity provider must be able to request basic user information to allow registration of the user. To allow for this, the API permissions now require updating.

07

Click ‘API permissions’ and then click ‘+ Add a permission’.

08
Click ‘Microsoft Graph’ from the top. 

09

Now add the following permissions: 

  1. Delegated permissions

    • Directory.Read.All

    • User.Read

  2. Application permissions

    • Directory.Read.All

To add these, click on the relevant permission type and copy/paste the permission as listed above into the search field, then check the permission as shown below:

10

11

12

13

When the three permission options have been selected, click ‘Add permissions’.

This will take you back to the API permissions page, where a warning relating to changed permissions will be visible.

To allow the permissions to be available for the Zengenti identity provider, you must grant admin access. Click ‘Grant admin consent’ at the bottom of the page. 

14

A further warning will then display - click ‘Yes’.

15

A success message will display, together with details of the permissions granted.

16

Obtain relevant federation data for the CMS

The Zengenti identity provider requires the following information to federate with your Azure instance:

  • Metadata endpoint

  • Application id

  • Tenant id

  • Tenant name

  • Application key

Metadata endpoint

Go to “Azure Active Directory” > App Registrations

e.g. Home > Zengenti Ltd > App Registrations

Click ‘Endpoints’ in the top bar.

17

You will see a list of available application endpoints.

Copy the link for ‘Federation metadata document

18

Application id

Click ‘Overview’ in the application options pane and then copy the ‘Application (client) ID’ which will be required when configuring Contensis to use your Azure AD instance.

19

Tenant id

In the ‘Overview’ screen, copy the 'Directory (tenant) ID’ which will be required when configuring Contensis to use your Azure AD instance.

19

Tenant name

Select ‘Azure Active Directory’ from the panel on the left, and then ‘Custom Domain Names’. You can then copy the ‘Name’ listed as the ‘Primary’ - this is your tenant name and will be required when configuring Contensis to use your Azure AD instance.

20

Application key

In the application overview panel, click ‘Certificates & secrets’ and then click ‘+ New client secret’.

21

You will see a form for naming and choosing the lifespan of a key. Complete as appropriate for your requirements, then click ‘Add’.

22
You will now need to copy the key as directed before navigating away from this screen. Click the ‘Copy to clipboard’ icon. 

Important: Once you leave this screen or carry out any other action, you will no longer be able to retrieve this key value. 

23

You have now completed the registration of Contensis with Azure and are now ready to configure Contensis to use Azure AD