How to connect to Azure

• Go to the Overview page of your Azure API Management service

  • The serviceName is displayed at the top left (see screenshot)

  • The resourceGroupName is displayed in the overview under "Resource group”

  • The subscriptionId is displayed in the overview under “Subscription ID”

Open

Azure API Management Service: Overview

We recommend creating an application via Azure Active Directory to access the API Management Service. Below is a description of how to do this and how to obtain the required IDs and the client secret.

Step 1 of 2: Create a new Application in Azure Active Directory

• See this Microsoft Azure link to learn how to create an Application:
  Quickstart: Register an app in the Microsoft identity platform - Microsoft identity platform

• After the application is created, the clientId and the associated tenantId are displayed:

• Now click on Add a certificate or secret (see Screenshot)

• After that click on New client secret and add a new secret

• The requested clientSecret will now be displayed

Important: Save the secret value, because it will no longer be displayed after you have left the page!

Note that the created application must also be assigned to the API Management Service (see Step 2), otherwise there is no link between the API Management service and the Application.

Step 2 of 2: Assign the Application to your Azure API Management Service

• Go to the Overview page of your Azure API Management service

  • Select Access control (IAM) in the menu on the left side

  • Click on Add role assignment in the interface

  • Select the Role “API Management Service Contributor” to grant the necessary permissions

  • Click on Members (next to Role) or Next (at the bottom) to continue

  • Add your Application to the list of Role members

  • Click on Review + assign (next to Members) or Next (at the bottom) to continue

  • Confirm by clicking on the ”Review + assign”-Button (at the bottom)