Discover Azure API Management APIs in Catalog with the Konnect UI

Uses: Catalog

Incompatible with

on-prem

Prerequisites

Kong Konnect

If you don’t have a Konnect account, you can get started quickly with our onboarding wizard.

The following Konnect items are required to complete this tutorial:
- Personal access token (PAT): Create a new personal access token by opening the Konnect PAT page and selecting Generate Token.
Set the personal access token as an environment variable:
```
export KONNECT_TOKEN='YOUR KONNECT TOKEN'
```
Copied!

Konnect roles

You need the Integration Admin role in Konnect to install and authorize Catalog integrations.

Azure API Management

You have an API in Azure API Management and the subscription ID for the API.
Your Azure email account is associated with an Azure organization. Personal Azure accounts aren’t supported for this integration.

Configure the Azure API Management integration

Note: The Azure API Management integration uses OAuth for authentication and can only be configured through the Konnect UI.

Before you can discover APIs in Catalog, you must configure the Azure API Management integration.

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Integrations.
Click Azure API Management.
Click Add Azure API Management instance.
In the Subscription ID field, enter your Azure API subscription ID.
Click Submit configuration.
In the Add authorization section, click Authorize in Azure API Management.
Click Authorize to authenticate with Azure using OAuth.
In the Azure authorization window, click Accept.
In the Display name field, enter azure-api-management-test.
In the Instance name field, enter azure-api-management-test.
Click Save.

Create a Catalog service and map the API resources

Now that your integration is configured, you can create a Catalog service to map the ingested APIs.

In this tutorial, we’ll refer to your ingested Azure API Management API as billing-api.

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Services.
Click New service.
In the Display Name field, enter Billing Service.
Click Create.
Click Map Resources.
Select billing-api.
Click Map 1 Resource.

Your integration APIs are now discoverable from one Catalog service.

You might need to manually sync your Azure API Management integration for resources to appear. In the Konnect UI, by navigate to the Azure API Management integration you just installed and select Sync Now from the Actions dropdown menu.

Validate the mapping

To confirm that the Azure API Management resource is now mapped to the intended service, navigate to the service:

In the Konnect sidebar, click Catalog.
In the Catalog sidebar, click Services.
Click the Billing Service service.
Click the Resources tab.

You should see the billing-api resource listed.