Configure multiple connections

APPLIES TO: All API Management tiers

You can configure multiple connections to a credential provider in your API Management instance. For example, if you configured Microsoft Entra ID as a credential provider, you might need to create multiple connections for different scenarios and users.

In this article, you learn how to add a connection to an existing provider, using credential manager in the portal. For an overview of credential manager, see About API credentials and credential manager.

Prerequisites

  • An API Management instance. If you need to, create one.
  • A configured credential provider. For example, see the steps to create a provider for GitHub or Microsoft Entra ID.

Create a connection - portal

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

  2. In the left menu, select Credential manager.

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

  4. In the provider window, select Overview > + Create connection.

    Screenshot of creating a connection in the portal.

  5. On the Connection tab, complete the steps for your connection.

    1. Enter a Connection name, then select Save.
    2. Under Step 2: Login to your connection (for authorization code grant type), select the link to login to the credential provider. Complete steps there to authorize access, and return to API Management.
    3. Under Step 3: Determine who will have access to this connection (Access policy), the managed identity member is listed. Adding other members is optional, depending on your scenario.
    4. Select Complete.

    The new connection appears in the list of connections, and shows a status of Connected. If you want to create another connection for the credential provider, complete the preceding steps.

Manage credentials - portal

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

To update provider settings:

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

  2. In the left menu, select Credential manager.

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

  4. In the provider window, select Settings.

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

    Screenshot of updating credential provider settings in the portal.

To update a connection:

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

  2. In the left menu, select Credential manager.

  3. Select the credential provider whose connection you want to update.

  4. In the provider window, select Connections.

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

    Screenshot of updating a connection in the portal.

  6. In the window that appears, make updates, and select Save.