Connect your API gateway to the API Catalog

Cloud connectors enable teams to bring APIs into the API Catalog. API specifications then appear in the API Catalog with metadata, including the associated environments and clusters. Collections are automatically generated for further API development in Postman.

The API Catalog supports the following API gateways:

Although discoverable in the Postman integrations marketplace, cloud connectors are only available for connection by customers with Enterprise plans because the API Catalog is an Enterprise-only product. Also, only Team Admins can install apps.

Once the Admin completes the connection, all users in the Postman team can select APIs to bring into the Catalog from the Service Discovery tab of the API Catalog.

The following fields are ingested from the gateway:

id
name
version
title
description
openAPI spec
environment
- id
- name
- version

To get started:

Go to the API Catalog and click Service discovery.
Expand Cloud Connectors.
Select your connector.
Enter the data required to connect. The required data depends on the connector you select. For more information, see the requirements for each connector below.
Follow the instructions to connect your cloud connector to the API Catalog. Once connected, the API Catalog automatically discovers APIs and adds them to the catalog.

AWS requirements

To connect to AWS, you need to have the following:

Access key — The access key in your AWS account. You can find it in the AWS IAM Console, under IAM > Users, in the Security credentials tab.
Secret key — The secret key in your AWS account. You can find it in the AWS IAM Console, under IAM > Users, in the Security credentials tab.
AWS session token — Find it in the individual values section.
SSO Region — The region where your AWS Gateway is deployed. Find it in the AWS IAM Identity Center credentials section.

Google Cloud requirements

To connect to Google Cloud, you need to have the following:

Project ID — The project ID in your Google Cloud account. Click Service Accounts in the IAM & Admin menu. Select the account and click the actions menu to reveal Manage Keys. Create a new key in JSON format. The project ID will be located in this file.
Private key ID — The private key ID in your Google Cloud account. The private key ID is located in the same JSON file created above.
Private key — The private key in your Google Cloud account. The private key is located in the same JSON file created above.
Client email — The client email in your Google Cloud account. The client email is located in the same JSON file created above.
Client ID — The client ID in your Google Cloud account. The client ID is located in the same JSON file created above.

Azure requirements

To connect to Azure, you need to have the following:

Client ID — The client ID in your Azure account. You can find it in the Azure Active Directory, under App registrations, in the Overview tab.
Tenant ID — The tenant ID in your Azure account. You can find it in the Azure Active Directory, under App registrations, in the Overview tab.
Client secret — The client secret in your Azure account. You can find it in the Azure Active Directory, under App registrations, in the Certificates & secrets tab.
Subscription ID — The subscription ID in your Azure account. You can find it in the Azure Active Directory, under App registrations, in the Overview tab.

IBM API Connect requirements

To connect to IBM API Connect, you need to have the following:

API key — Click My API Keys in your profile. Create a new API key and copy the API key from the REST API example.
Client ID — Using the same REST API example above, find the Client ID in the curl.
Client secret — Using the same REST API example above, find the Client secret in the curl.