Configure multiple authorization connections

You can configure multiple authorizations (also called authorization connections) to an authorization provider in your API Management instance. For example, if you configured Azure AD as an authorization provider, you might need to create multiple authorizations for different scenarios and users.

In this article, you learn how to add an authorization connection to an existing provider, using the portal. For an overview of configuration steps, see How to configure authorizations?

Prerequisites

  • An API Management instance. If you need to, create one.
  • A configured authorization provider. For example, see the steps to create a provider for GitHub or Azure AD.

Create an authorization connection - portal

  1. Sign into portal and go to your API Management instance.

  2. In the left menu, select Authorizations.

  3. Select the authorization provider that you want to create multiple connections for (for example, mygithub).

    Screenshot of selecting an authorization provider in the portal.

  4. In the provider windows, select Authorization, and then select + Create.

    Screenshot of creating an authorization connection in the portal.

  5. Complete the steps for your authorization connection.

    1. On the Authorization tab, enter an Authorization name. Select Create, then select Next.
    2. On the Login tab (for authorization code grant type), complete the steps to login to the authorization provider to allow access. Select Next.
    3. On the Access policy tab, assign access to the Azure AD identity or identities that can use the authorization. Select Complete.
  6. The new connection appears in the list of authorizations, and shows a status of Connected.

    Screenshot of list of authorization connections in the portal.

If you want to create another authorization connection for the provider, complete the preceding steps.

Manage authorizations - portal

You can manage authorization provider settings and authorization connections in the portal. For example, you might need to update client credentials for the authorization provider.

To update provider settings:

  1. Sign into portal and go to your API Management instance.

  2. In the left menu, select Authorizations.

  3. Select the authorization provider that you want to manage.

  4. In the provider windows, select Settings.

  5. In the provider settings, make updates, and select Save.

    Screenshot of updating authorization provider settings in the portal.

To update an authorization connection:

  1. Sign into portal and go to your API Management instance.

  2. In the left menu, select Authorizations.

  3. Select the authorization provider (for example, mygithub).

  4. In the provider window, select Authorization.

  5. In the row for the authorization connection you want to update, select the context (...) menu, and select from the options. For example, to manage access policies, select Access policies.

    Screenshot of updating an authorization connection in the portal.

Next steps