How to expose an API in Azure Portal so that it is visible in the list of "APIs my organization uses"

by DJ and Bard 28 Apr 2023

To expose an API in Azure Portal so that it is visible in the list of "APIs my organization uses", you need to follow these steps:

  1. Sign in to the Azure Portal.
  2. Click the Azure Active Directory icon in the left-hand navigation pane.
  3. In the Azure Active Directory blade, click App registrations.
  4. Click the name of the app registration that you want to expose the API for.
  5. In the app registration blade, click Expose an API.
  6. In the Expose an API blade, click Add a scope.
  7. In the Add a scope blade, enter a name for the scope.
  8. Select the type of permission that you want to grant for the scope.
  9. Click Add.
  10. Repeat steps 6-9 for each scope that you want to add.
  11. Once you have added all of the scopes, click Save.
  12. The API will now be visible in the list of "APIs my organization uses".

Here are some additional details about each step:

  • Sign in to the Azure Portal: You can sign in to the Azure Portal using a Microsoft account or a work or school account.
  • Click the Azure Active Directory icon in the left-hand navigation pane: The Azure Active Directory icon is a blue circle with a white A in the middle.
  • In the Azure Active Directory blade, click App registrations: App registrations are used to manage applications that access Azure resources.
  • Click the name of the app registration that you want to expose the API for: The app registration that you select will be the one that is used to expose the API to your organization.
  • In the app registration blade, click Expose an API: This will open the Expose an API blade.
  • In the Expose an API blade, click Add a scope: This will open the Add a scope blade.
  • In the Add a scope blade, enter a name for the scope: The name of the scope should be descriptive of the permission that you are granting.
  • Select the type of permission that you want to grant for the scope: There are two types of permissions that you can grant: application permissions and delegated permissions. Application permissions are granted to the app registration itself, while delegated permissions are granted to the users of the app registration.
  • Click Add: This will add the scope to the list of scopes for the app registration.
  • Repeat steps 6-9 for each scope that you want to add: You can add as many scopes as you need.
  • Once you have added all of the scopes, click Save: This will save the changes to the app registration.
  • The API will now be visible in the list of "APIs my organization uses": You can click on the API to view more information about it.