How to Obtain Azure AD Integration Key
Introduction
Azure Active Directory (Azure AD) stands as Microsoft's cloud-based identity and access management service, providing a robust framework for organisations to secure and manage user identities and access to applications. Serving as a comprehensive solution, Azure AD enables the creation and administration of user accounts, groups, and devices, fostering efficient identity management. Its Single Sign-On (SSO) capabilities streamline user access to various applications with a unified set of credentials, enhancing user experience and security. Additionally, Azure AD facilitates multi-factor authentication and supports a diverse ecosystem of applications, both Microsoft and third-party, making it a fundamental component for organisations seeking a centralised and secure approach to identity and access management in the cloud. An Azure Active Directory connector can be configured in SigningHub Admin by providing two integration keys, i.e. Client ID and Client Secret.
How it works?
Create an Azure AD App in Azure Active Directory.
Create an Azure AD connector in SigningHub Admin.
Create an Azure AD authentication profile in SigningHub Admin.
Create an Azure AD App in Azure Active Directory
Sign in to the Azure portal using your Azure Active Directory administrator account.
Select "Azure Active Directory" from the left tab.
Click on the "Enterprise Applications" from the left panel.
Click on the "New application" button.
Click on the "Create your own application" button.
Enter the name for the app, select an option for your app via the radio button, and click on the "Create" button.
Select the "Supported account types". Under the "Redirect URl", select "Web" and enter "https://web.signinghub.com/OAuth/AzureADCallBack". Click on the "Register" button.
Click on the "Enterprise applications | All applications" button.
Search and open the created app.
You will be taken to the app overview screen. Select "Properties" from the left tab.
From the properties screen, click on the "application registration" hyperlink.
Select "API permissions" from the left tab.
From the "API permissions" screen, click on "Add a permission" button.
From the "Request API permissions" tab, click on "Microsoft Graph".
Click on "Delegated Permissions".
Search for and select "Directory".
Select the "Directory.Read.All" permission, and click on the "Add permissions" button.
Select “Certificates & secrets” from the left tab. Create a new client secret by clicking on the “New client secret” button. Save the client secret for use in the SigningHub connector.
Get the ClientID, directory ID and endpoints from “Overview”.
To add a user, go to “Azure AD” from “Overview”.
Click on the “Assign users and groups” button.
Then click on the “Add user/group” button.
Create an Azure Active Directory Connector, using information from steps 14 and 15.
Create an Azure AD connector
Access the SigningHub Admin portal.
Click the 'Configurations' option from the navigation panel.
Click the 'Connectors' option.
Click the
icon from the grid header.
The 'Add' connector screen will appear to add the connector details. It comprises of two sections, i.e. Basic Information and Details. Specify the basic information and click the
button to provide the respective connector details.
Click the "Create" button. A new connector will be saved and displayed in the list.
Basic Information
Fields
Description
Name
Specify a unique name for this connector, i.e. My Azure Active Directory. This connector will be used in the configuration of Authentication Profiles.
Provider
Select the provider for this connector, i.e. "Azure Active Directory".
Purpose
This field will display the purpose of the selected provider above, i.e. the purpose of "Azure Active Directory" is "Authentication".
Active
Tick this check box to make this connector active. Inactive connectors cannot be configured in the Authentication Profiles.
Details
Fields
Description
Logo
Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo that will be displayed on the login screen.
Client ID
Specify the registered client ID that has been provided by Azure Active Directory during account configuration, e.g. "d6920aa5-258b-a520-b0gh-870503xv8b4d". SigningHub will use this ID to communicate with the Azure Active Directory server.
Client Secret
Specify the client secret that has been provided by Azure Active Directory during account configuration, e.g. "hniZYHqPEcKy6H25-LjzSX0Q".
Account Type
Specify whether the account type is Single Tenant or Multi Tenant. A single tenant account allows the accounts within the same organisational directory only to use the application. While a multi tenant account allows all the organisational directories to use the application.
Create an Azure Active Directory authentication profile
Click the 'Configurations' option from the navigation panel.
Click the 'Authentication Profiles' option.
The 'Authentication Profiles' page is displayed for you to make the necessary changes.
Click the
icon from the grid header.
The 'Add' authentication profile screen will appear to add the authentication profile details. It comprises of two sections, i.e. Basic Information and Details. Specify the basic information and click the
button to provide the respective authentication profile details.
Click the 'Create' button. A new authentication profile will be saved and displayed in the list. See the table below for field descriptions.
Authentication Profile
Fields
Description
Name
Specify a unique name for this authentication profile, i.e. Azure AD Authentication. This name will be displayed at the login screen of SigningHub Desktop Web.
Description
Specify any description related to this authentication profile for your record.
Method
Select the authentication method (i.e.Azure Active Directory Authentication) for this profile.
Connector
This field will appear to select the related connector, when you select any third-party authentication method above. Select the Azure Active Directory connector. Click to view the details of the selected connector.
Details
If you select the "Azure Active Directory Authentication" method, the "Details" fields will appear, in addition to the "Connector" field, to specify the "Allowed Groups" information.
The "Allowed Groups" field refers to the (comma-separated) authorised security groups in your Azure Active Directory (i.e. Sales, Marketing, Accounts, etc.) that are used for provisioning in SigningHub.
Active
Tick this check box to make this authentication profile active. Only the active profiles are available to the end users on their Login screen, Signing screen and Integration screen..
Private
Tick this check box to mark this authentication profile as private. A private profile will not be available to the (public) end users on their Login screen, Signing screen and Integration screen of SigningHub Desktop Web.
Private profiles from here will be available in the "Settings" tab of service plan configuration, and are used for the corporate logins and signing authentication.
You can associate any supported external Identity Provider (i.e. BankID, Active Directory, Google, etc.) as required with a private authentication profile to make it exclusive for a corporate.
Last updated