Enable Azure AD authentication for API Management Service Developer Portal

2 minute read

We use Azure Api Management Service (APIM) quite a lot and recently I have been looking at the new APIM Developer portal and how to enable Azure Active Directory authentication for the new portal.


To be able to achieve this we will need to manually register a new application in Azure AD. This app will then be used to authenticate against Azure AD from our APIM developer portal. The following list is a list of requirements needed:

  • Client ID of new Azure AD application
  • Client Secret of new Azure AD application
  • Redirect URL of Azure APIM
  • Permissions to register new applications in Azure AD

Add Azure AD identity provider in APIM

First, navigate to your APIM instance, and select Identities under the Developer portal settings

Add Identity

Click add new identity and select Azure Active Directory and copy the Redirect URL. We will need this later when we create our Azure AD application.

Redirect URL

Make sure you don’t copy the legacy redirect URL if you are using the new APIM portal like me.

Don’t close this window just yet. We will need to fill in the ClientID and Client Secret of the new app we are about to register in Azure AD.

Register a new application in Azure AD

Open a new tab and register a new app in Azure AD. Select New Registration. Give your new app a meaningful name , select “Accounts in this organizational directory only” and paste the redirect url from APIM and press register.

Register APP in Azure AD

Once the app is registered, copy the ClientID

Client ID

Go to Certificate and Secrets and create a new Secret. Once created, copy the Client Secret.

Client Secret

There is one last thing we should do in our newly created Azure AD app before switching back to our APIM. Click on Authentication and select ID Tokens.

ID Tokens

Finalize Azure AD identity provider in APIM

Now, let’s switch back to our APIM and fill in all the necessary information. Paste the ClientID and Client Secret from the previous step and press Add.

Add info

At this stage you can already try and login to your APIM with Azure AD. Go to https:yoururl/signin

AD Sign in

You will see that the sign in page is using the Sign-in button: OAuth widget for Azure AD authentication. After sign in the user will be prompted to complete the sign up process.

Modify the APIM portal for Azure AD authentication

I want all my users to use Azure AD authentication instead of Basic authentication. So I customized the APIM portal and removed all Basic oAuth widgets from the portal.

Remove Basic oAuth


As you can see it’s not complicated to enable Azure AD for the APIM portal. Using Azure AD also means I can now use all the security features in Azure AD like conditional access and MFA for my developers.


Leave a comment