When an application access token is generated, an OAuth client is created underneath. The consumer key and consumer secret shown under a key type actually belongs to the OAuth client. In previous releases of API Manager, the only way to create an OAuth client was through the API Store. However, there can be situations where an OAuth client is created elsewhere, but needs to be associated with an application in the API Store. For instance, in an oorganization where WSO2 Identity Server is used as the authoritative server, OAuth clients may only be created through the Identity Server. Similarly, when a third party OAuth provider is used, users might want to use previously created OAuth clients with the API Manager.
To achieve this, you can provision the OAuth clients created outside the API Store into the API Manager, thereby associating the OAuth client with an application in the API Store. Once the mapping is done, you can use it in the same way as an OAuth client created through the API Store.
The steps below describe how to provision OAuth clients created outside the API Store into the API Manager:
In this example, we use a standalone API Manager instance and do this via the management console of the API Manager.
Sign in to the WSO2 APIM Management Console (
https://<Server Host>:9443/carbon) and click Add under Service Providers.
- Give a name for the service provider and click Register.
- Click Configure under Inbound Authentication Configuration > OAuth/OpenId Connect Configuration to add a new OAuth client.
- Provide a callback URL.
If you do not have a callback URL, you can uncheck the Code and Implicit authorization grant types checkboxes and add the OAuth client.
As you have now created the OAuth client, the OAuth client key and OAuth client secret appears.
Enable the option to provide out-of-band keys by opening the
<APIM_HOME>/repository/deployment/server/jaggeryapps/store/site/conf/site.jsonfile and changing the
- Sign into the WSO2 API Store.
In the My Subscriptions page, notice that you now see a Provide Keys button for your application.
Click Provide Keys, paste the consumer key and consumer secret pair, which you received in step 4, and click Save.If you receive an error when you click Save, use the OAuth Admin Service to provision the out-of-band OAuth client.
You have successfully provisioned an out-of-band OAuth client.