(Example) How to Get the Access Token Credentials from Microsoft Cognitive Services

This example shows how to get the access token credentials from Microsoft Cognitive Services.

Prerequisites

  • One of these account types:
    • Microsoft Azure Business
    • Microsoft Azure Enterprise
    • Microsoft Azure Personal

Good to Know

  • You can use one of these APIs, which are supported in AgilePoint NX:
    • Language > Text Analytics
    • Decision > Content Moderator
    • Vision > Face
    • Vision > Computer Vision

    This example uses the Face API.

  • OAuth 2.0 access tokens require a 2-way exchange of credentials between AgilePoint NX and the external service. This means that you must get the credentials from the third-party service to paste in the AgilePoint NX access token, and get the redirect URI from AgilePoint NX to paste in the external service. This requires you to open both the AgilePoint NX access token and the third-party service at the same time, so you can copy and paste from one screen to the other.

    This topic shows the suggested procedure for Microsoft Cognitive Services. The exact procedure for your access token depends on whether you already have a connection (usually called an app) configured in the external service.

  • This topic gives one example. The procedure may vary depending on your configuration and account settings in the third-party service.
  • Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Step 1: Start Creating an Access Token in AgilePoint NX

First, create a new access token in AgilePoint NX for Microsoft Cognitive Services.

How to Start

Procedure

  1. In AgilePoint NX, open the access token configuration screen for Microsoft Cognitive Services.

    Microsoft Cognitive Services Global Access Token screen

    Do not configure the access token credentials.

    Keep the access token configuration screen open in AgilePoint NX, but do not save it.

Step 2: Create an Azure Cognitive Services API

Next, create an Azure Cognitive Services API in Microsoft Cognitive Services.

How to Start

  1. In a new web browser tab, go to https://azure.microsoft.com/en-in/services/cognitive-services/.

Procedure

  1. On the Microsoft Azure screen, in the Azure Cognitive Services section, select your API.

    You can use one of these APIs, which are supported in AgilePoint NX:

    • Vision > Face
    • Language > Text Analytics
    • Decision > Content Moderator
    • Vision > Computer Vision

    This example uses the Face API.


    Cognitive Services screen
  2. On the Face screen, click Try Face.

    Face screen
  3. Go through the sign in process.
  4. After you sign in, the Your APIs screen shows the API keys.

    Result screen

Step 3: Copy the Azure Cognitive Services API Key

Next, copy the Azure Cognitive Services API keys from Microsoft Cognitive Services to your AgilePoint NX access token.

How to Start

  1. In one web browser tab, open the Azure Cognitive Services API you created in Microsoft Cognitive Services.

    For more information, refer to Create an Azure Cognitive Services API.

  2. In a different web browser tab, in AgilePoint NX, open the Microsoft Cognitive Services access token configuration screen.

Procedure

  1. In Microsoft Cognitive Services, on Your API screen, copy the API key value.

    Only one API key value is required.


    Your APIs screen
  2. In AgilePoint NX, on the Microsoft Cognitive Services Access Token Configuration screen, in the API Key field, paste the API key value from Microsoft Cognitive Services.

    Microsoft Cognitive Services Access Token Configuration screen

Step 4: Complete the AgilePoint NX Access Token

Next, complete the AgilePoint NX access token configuration for Microsoft Cognitive Services.

How to Start

  1. In AgilePoint NX, open the Microsoft Cognitive Services access token configuration screen.

Procedure

  1. In AgilePoint NX, on the Microsoft Cognitive Services Access Token Configuration screen, in the Token Name field, enter a name for the access token.

    Microsoft Cognitive Services Access Token Configuration screen
  2. In the MS Cognitive Service Type list, select your Azure Cognitive Services API.

    You can use one of these APIs, which are supported in AgilePoint NX:

    • Vision > Face
    • Language > Text Analytics
    • Decision > Content Moderator
    • Vision > Computer Vision

    This example uses the Face API.


    Microsoft Cognitive Services Access Token Configuration screen
  3. Click Test Connection.

    Microsoft Cognitive Services Access Token Configuration screen

    If the connection is successful, a confirmation message shows.


    Connection Successful Confirmation Message
  4. Click Done.

    OneDrive for Business Access Token screen