How to create Azure Active Directory application
One of the authentication options is provided in Conduit is Azure Active Directory.
Conduit enables Single sign-on solutions for all users accessing datasources as well as central authorization via AD groups.
Conduit allows users to establish a link with an Azure Active Directory (AAD) subscription. This gives administrators the option to manage their organization's data access policies centrally in AAD so that they translate automatically to Conduit. This helps to streamline the data that users can explore.
Enabling Active Directory login requires an Active Directory app registration with the following properties that need to be filled in Conduit.
Active Directory Authority
Application ID
Client Secret
This tutorial will guide you to create and find the above properties.
TABLE OF CONTENTS
- 1 Instructions to create an AAD App registration
- 1.1 Step 1) Navigate to new registration
- 1.2 Step 2) Create new registration
- 1.3 Step 3) Configure Redirect URIs
- 1.3.1 Step 3.1) Have in a notepad the following Conduit redirect URLs:
- 1.3.2 Step 3.2) Open new app registration
- 1.3.3 Step 3.3) Add USER_LOGIN_URL redirect URI
- 1.3.4 Step 3.4) Add SUBSCRIPTION_VALIDATION_URL redirect URL
- 1.3.5 Step 3.5) Add LOGOUT_URL redirect URL
- 1.3.6 Step 3.6) Save authentication settings
- 1.4 Step 4) Configure Client Secret
- 2 Find Active Directory Authority
- 3 Find Application ID
- 4 Find Client Secret
- 5 Related articles
Instructions to create an AAD App registration
Step by step guide to create a new Azure Active Directory App registration
Step 1) Navigate to new registration
Step 1.1) Navigate to Azure ActiveDirectory
Step 1.2) Click on App Registrations
Step 1.3) Click on New Registration
Step 2) Create new registration
provide a user friendly name for your app
select account type
“Accounts in this organizational directory only (YOUR-TENANT)”
click register
Step 3) Configure Redirect URIs
Step 3.1) Have in a notepad the following Conduit redirect URLs:
USER_LOGIN_URL
HTTP_PROTOCOL://CONDUIT_FQDN/login/oauth2/code/azure/user
e.g.
https://conduit-my-deployment.com/login/oauth2/code/azure/user
SUBSCRIPTION_VALIDATION_URL
HTTP_PROTOCOL://CONDUIT_FQDN/login/oauth2/code/azure/subscription/validation
https://conduit-my-deployment.com/login/oauth2/code/azure/subscription/validation
LOGOUT_URL
HTTP_PROTOCOL://CONDUIT_FQDN/logout/oauth2
https://conduit-my-deployment.com/logout/oauth2
Step 3.2) Open new app registration
Navigate to your newly created app registration, e.g. conduit-tutorial-activedirectory-app
open Azure Active Directory → App registrations → select “All applications” tab → search for the name provided at previous step
Step 3.3) Add USER_LOGIN_URL
redirect URI
click on Authentication
click on “Add a platform”
click on “Web”
add
USER_LOGIN_URL
as an authorized Redirect URIclick “Configure”
Step 3.4) Add SUBSCRIPTION_VALIDATION_URL
redirect URL
click on “Authentication”
click on “Web” → “Add URI”
add
SUBSCRIPTION_VALIDATION_URL
Step 3.5) Add LOGOUT_URL
redirect URL
click on “Authentication”
navigate to “Front-channel logout URL”
add LOGOUT_URL
Step 3.6) Save authentication settings
click “Save”
remaining settings can be left on default values
Step 4) Configure Client Secret
Step 4.1) Create a secret
Navigate to your newly created app registration, e.g. conduit-tutorial-activedirectory-app
open Azure Active Directory → App registrations → select “All applications” tab → search for the name provided at previous step
click on “Certificates & secrets”
add a user friendly description for your secret
select expiration policy
click “Add”
Step 4.2) Copy in a notepad the SECRET_VALUE
!!! client secret can only by viewed at this stage !!!
copy the value in safe location
you cannot view the secret later if you navigate away from this page
a new secret can be created later, but this secret cannot be read again
Find Active Directory Authority
Navigate to your newly created app registration, e.g. conduit-tutorial-activedirectory-app
open Azure Active Directory → App registrations → select “All applications” tab → search for the name provided at previous step
click on overview
copy Directory (tenant) ID
this is your Active Directory Authority
Find Application ID
Navigate to your newly created app registration, e.g. conduit-tutorial-activedirectory-app
open Azure Active Directory → App registrations → select “All applications” tab → search for the name provided at previous step
click on overview
copy Application (client) ID
Find Client Secret
Client secret can only be read at app registration creation.
See above section “Instructions to create an AAD App registration”.