Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The following table describes all of the properties that you can specify for the configuration:

Configuration PropertyTypeRequiredDescription
authorityStringXThe authority base URL. It should be https://login.microsoftonline.com/common/ for a multitenant application (this is the URL for the Azure AD common endpoint, which enables users from any Azure AD tenant to sign in. For more information about the common endpoint, see this blog post.), or https://login.microsoftonline.com/ + [YOUR_TENANT_ID]
clientIdStringXAzure Native Application ID; you can find it by selecting your Native App in Azure portal
redirectURIStringXSince usually the client app does not have an external service to redirect to, this URI is the standard placeholder for client apps; defaults to https://login.live.com/oauth20_desktop.srf
resourceURIStringXAzure AD Graph API service root; defaults to https://graph.windows.net
usernameStringXYour AD User username
passwordStringXYour AD User password
domainStringXYour Microsoft domain (e.g. mycompany.onmicrosoft.com)
tenantIdStringXAzure Tenant ID
clientSecretStringXClient Secret value; you can find it under Certificates & Secrets
scopesStringXOpenID connect scopes; defaults to https://graph.microsoft.com/.default
userAttributesToGetStringXList of user attributes to retrieve. Must contain at least id and userPrincipalName in order to make the search work.
groupAttributesToGetStringXList of group attributes to retrieve. Must contain at least id in order to make the search work.
restoreItemsBooleanXtrue if you want to restore items (users and groups) instead of creating new one

Prerequisites

Obtaining an Azure AD account

...

The required authorization must be set for the following APIs:

  • Microsoft Graph;Windows Azure Active Directory.

so, after creating the application, you'll need to select it and add a new permission for both those APIs that API in the Required permissions menu.

...

  1. In the Required permissions menu, click on Windows Azure Active Directory;In the Enable Access menu, select all permissions from Delegated Permissions and click on Microsoft Graph;
  2. Choose Delegated Permissions and add these permissions: 
    1. APIConnectors.Read.All
    2. Directory.AccessAsUser.All
    3. PrivilegedAccess.ReadWrite.AzureAD
    4. profile
    5. User.Read
  3. Click Save;
  4. Finally, back to Required permissions menu, click on the Grant Permissions button.

...

Code Block
languagebash
linenumberstrue
oauth2.authority=
oauth2.clientId=
oauth2.redirectURI=
oauth2.resourceURI=
oauth2.username=
oauth2.password=
oauth2.domain=
oauth2.tenantId=
oauth2.clientSecret=
oauth2.scopes=
oauth2.userAttributesToGet=
oauth2.groupAttributesToGet=
oauth2.restoreItems=

In case you want to test license assignment you must add the following properties:

...