このページは、まだ日本語ではご利用いただけません。翻訳中です。
Enable or Disable Application Registration for an API Product Version
To grant developers access to register an application, you must apply an authentication strategy and enable application registration for an API product version. When you apply an authentication strategy, Kong Konnect enables plugins automatically to support the desired mode, either key authentication or OpenID Connect. These plugins run inside the data plane to support application registration for the API product version and are managed by Kong Konnect.
Enabling application registration is specific to the geographic region. You must enable application registration in each geo that you want to allow developers to register with. Each geo has their own API keys and specifications for application registration in their respective geo.
Konnect provides the capability to configure and implement a range of authentication strategies. Utilizing the OpenID Connect authentication strategy allows for specific permissions to be set within your Identity Provider (IdP). This system offers the versatility to either apply a unified authentication strategy across all API Products or to designate a unique authentication strategy to individual API Products.
flowchart TB subgraph Staging Portal WeatherAPIv1["Weather API v1"] --> key-auth WeatherAPIv2["Weather API v2"] --> okta-oidc MapsAPIv2-1["Maps API v2"] --> okta-oidc end subgraph Production Portal WeatherAPIv3["Weather API v3"] --> okta-dcr MapsAPIv2-2["Maps API v2"] --> auth0-oidc end
Auth Configs are independently configured entities, meaning they can be used by multiple API Products (for example, Weather API v2 and Maps API v2 in Staging Portal both use the Okta OIDC config). Independently configured Auth Configs also give you the flexibility to configure the same API Product version to use different auth strategies in different portals. For example, Maps v2 uses the Okta OIDC Auth Config in the Staging Portal, and the Auth0 OIDC Auth Config in the Production portal.
Developers are limited to using a single auth strategy per application. For example, they can create an application to register for both Weather v2 and Maps v2, as both employ okta-oidc
, however, registering for Weather v1 and Weather v2 within the same application isn’t possible due to their differing auth configurations.
Prerequisites
-
An API product that is versioned and published to a Konnect Dev Portal.
-
If you are using OpenID Connect, set up your application, claims, and scopes in your OpenID identity provider.
Note: Generally, it’s only recommended for an API product version to be linked to a Gateway service. However, for app registration to work, the link between API product version and a Gateway service is required.
Enable app registration with key authentication
-
In API Products, select an API product.
-
Click Product Versions and select a product version.
Note: If the API product version is in the
default
control plane group, it will instead receive read-only entries for theacl
andkey-auth
plugins to provide support for Kong Gateway versions less than 3.0. -
From the Dev Portals tab, click Publish to Dev Portals.
- Enable Require Authentication then do one of the following:
- If your API product is already published to a Dev Portal, select key-auth in the Auth Strategy menu for that Dev Portal.
- If your API product is not published, add a Dev Portal, select the target Dev Portal in the menu, and then select Key Auth in the Auth Strategy menu.
-
Enable Accept application registrations for each Dev Portal to allow developers to register their applications to consume this API.
-
Optional: Click the Auto Approve checkbox if you want to automatically approve all application registration requests.
- Click Save.
Enable app registration with OpenID Connect
To enable app registration with OpenID Connect, from the Konnect menu, click API Products, select an API product, and follow these steps:
If you already have an OIDC Auth Strategy created in the Application Auth:
-
In your API Product, click Product Versions to select a version.
-
From the Dev Portals tab, click Publish to Dev Portals.
- Enable Require Authentication then do one of the following:
- If your API product is already published to a Dev Portal, select OIDC in the Auth Strategy menu for that Dev Portal.
- If your API product is not published, add a Dev Portal, select the target Dev Portal in the menu, and then select OIDC in the Auth Strategy menu.
-
Enable Accept application registrations for each Dev Portal to allow developers to register their applications to consume this API.
-
Optional: Click the Auto Approve checkbox if you want to automatically approve all application registration requests.
- Click Save.
If you do not already have an OIDC Auth Strategy created, we will first create an OIDC Auth strategy, and then apply it to our API product:
-
In the Dev Portal menu, navigate to the Application Auth tab. Click New Auth Strategy to create an auth strategy. Refer to the configuration parameters section for more information about each field.
-
Enter a name to be seen only in Konnect and a display name that will be displayed on your Dev Portal.
-
In the Auth Type dropdown menu select OpenID-Connect. Enter the Issuer URL for your OIDC tenant.
-
Enter any scopes your developers may need access to (e.g. openid, profile, email, etc). Note the required scopes may differ depending on your IdP.
-
Enter the Credential Claims which will match the client ID of the corresponding application in your IdP.
-
Select the relevant Auth Methods you need (for example:
client_credentials
,bearer
,session
). -
Click Save
-
In your API Product, click Product Versions to select a version.
-
From the Dev Portals tab, click Publish to Dev Portals.
- Enable Require Authentication then do one of the following:
- If your API product is already published to a Dev Portal, select OIDC in the Auth Strategy menu for that Dev Portal.
- If your API product is not published, add a Dev Portal, select the target Dev Portal in the menu, and then select OIDC in the Auth Strategy menu.
-
Enable Accept application registrations for each Dev Portal to allow developers to register their applications to consume this API.
-
Optional: Click the Auto Approve checkbox if you want to automatically approve all application registration requests.
- Click Save.
Note: If the API product version is in the
default
control plane group, it will instead receive read-only entries for theacl
andopenid-connect
plugins to provide support for Kong Gateway versions less than 3.0.
OpenID Connect configuration parameters
In the default
control plane group, Credential claim is used as a Consumer claim which identifies a consumer. In non-default
control plane groups, the Credential claim should be mapped to a claim that contains the unique clientId
or applicationId
in the identity provider. For more background information about OpenID Connect plugin parameters, see Important Configuration Parameters.
Form Parameter | Description | Required |
---|---|---|
Issuer |
The issuer URL from which the OpenID Connect configuration can be discovered. For example: https://dev-1234567.okta.com/oauth2/default . |
True |
Scopes |
The scopes to be requested from the OpenID Provider. Enter one or more scopes separated by spaces, for example: open_id myscope1 . |
False |
Credential claims |
Name of the claim that maps to the unique client id in the identity provider. | True |
Auth method |
The supported authentication method(s) you want to enable. This field should contain only the authentication methods that you need to use. Individual entries must be separated by commas. Available options: password , client_credentials , authorization_code , bearer , introspection , kong_oauth2 , refresh_token , session . |
True |
Hide Credentials |
Default: disabled Hide the credential from the upstream service. If enabled, the plugin strips the credential from the request header, query string, or request body, before proxying it. |
False |
Auto Approve |
Default: disabled Automatically approve developer application requests for an application. |
False |
Enable app registration with multiple IdPs
In Konnect can configure and manage multiple authentication strategies across various API products and their versions, allowing you to apply distinct authentication scopes for different API versions.
This section will introduce you to the functionality portal product versions using Dynamic client registration (DCR). Using the Application Registration API, you can manage multiple APIs and configure a different DCR on a per API product basis. DCR is one type of strategy for application auth, where Konnect is integrated directly with the IdP to outsource, link, and automate the credential management using that IDP.
Using the product-versions
endpoint, you can link authentication strategies with your API products.
- Configure the auth strategies of your choice:
- Before making a request to this endpoint, ensure you have gathered the following details from the previous step:
-
portalId
: ID of the Dev Portal -
product_version_id
: API Product version ID. -
auth_strategy_id
: The ID of the auth strategy you configured.
-
- Apply the auth strategy to your API, making sure to replace
your_product_version_id
andyour_auth_strategy_id
with the actual IDs you intend to use:
curl --request POST \
--url https://us.api.konghq.com/v2/portals/{portalId}/product-versions/ \
--header 'Authorization: $KPAT' \
--header 'content-type: application/json' \
--data '{
"product_version_id": "your_product_version_id",
"auth_strategy_ids": [
"your_auth_strategy_id"
],
"publish_status": "published",
"application_registration_enabled": true,
"auto_approve_registration": true,
"deprecated": false
}
Executing this request does the following:
-
Published API Product Versions: This makes the latest iterations of these APIs available to developers through the Dev Portal.
-
Enabled Application Registration: Developers can now register for access to your API. This allows them to integrate this API into their own apps.
-
Configured Authentication Strategies: The auth strategies you configured are now all applied to your published API.
Note: If your API Products are not yet published, you will need to publish the API Product itself in order for the API Product versions to be published to your Dev Portal.