Access Token for Microsoft Azure Active Directory

Configure an access token to connect to Microsoft Azure Active Directory.

Figure: MS Azure Active Directory Access Token Configuration screen

WAAD Access Token Configuration screen

Background and Setup

Prerequisites

Good to Know

Fields

Field Name Definition

Token Name

Function:
Specifies the unique name for your connection to Microsoft Azure Active Directory.
Accepted Values:
A text string that can have letters, numbers, and spaces
Default Value:
None
Example:
This is a common configuration field that is used in many examples. Refer to:
  • Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Application ID

Function:
Specifies the Microsoft application ID of the app you created or added in Microsoft Azure Active Directory.
Accepted Values:
A string with letters and numbers.
Default Value:
None

Key

Function:
Specifies the key of the app you created or added in Microsoft Azure Active Directory.
Accepted Values:
A string with letters and numbers.
Default Value:
None

Reply URL

Function:
Specifies the callback URL from the connected application.
Accepted Values:
A string in URL format.
Default Value:
https://mysite.com/manage/shared/success.html

Microsoft Graph API URL

Function:
Specifies the Microsoft Graph API URL for your language. The default value for this field is the value for the Microsoft Graph API in U.S. English. If you use a different language, see the Documentation from Microsoft to get the URL for your language.
Accepted Values:
  • The Microsoft Graph API URL for your language.
  • The Microsoft Graph API URL for a government organization.
Default Value:
https://graph.microsoft.com
Limitations:
The Microsoft Graph API URL for government organizations support is available in these releases:

Description

Function:
A description for your access token.
Accepted Values:
More than one line of text.
Default Value:
None
Example:
This is a common configuration field that is used in many examples. Refer to:
  • Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

OAuth2 Access Token

Function:
Specifies an OAuth 2.0 access token from Microsoft Azure Active Directory.
Accepted Values:
An OAuth 2.0 access token

This value comes from Microsoft Azure Active Directory.

Default Value:
None.

Get OAuth2 Access Token

Function:
Sends a request to the Microsoft Azure Active Directory service to get the access token.

To complete this process, you must sign in to Microsoft Azure Active Directory, and specify your consent when prompted.

Renewal Rate

Function:
Specifies how frequently to renew your application's access token.
Accepted Values:
  • Disabled
  • Every 15 minutes
  • Every half an hour
  • Every hour
Default Value:
Every hour

Encrypt

Function:
Stores the access token in the AgilePoint database as encrypted data.
Note: AgilePoint recommends you to store this access token in the database in encrypted format.
Accepted Values:
  • Deselected - The access token is in plain text in the database.
  • Selected - The access token is encrypted in the database.
Default Value:
Selected
Limitations:
  • This field was removed from the UI in AgilePoint NX OnPremises and Private Cloud v7.0 Software Update 2. Access token credentials are encrypted by default. If you want to store credentials in unencrypted format, contact AgilePoint Customer Support.