Register OAuth 2.0 clients in Identity Cloud
OAuth 2.0 client profiles define how applications connect to Identity Cloud to obtain OAuth 2.0 tokens.
To allow the SDKs to connect to Identity Cloud and obtain OAuth 2.0 tokens, you must register at least one OAuth 2.0 client application.
There are two types of OAuth 2.0 client:
- Public client
-
Public clients do not use a client secret to obtain tokens because they are unable to keep them hidden. The ForgeRock SDKs commonly use this type of client to obtain tokens, as they cannot guarantee safekeeping of the client credentials in a browser or on a mobile device.
- Confidential client
-
Confidential clients are able to securely store credentials and are commonly used for server-to-server communication. For example, the "Todo" API backend provided with the SDK samples uses a confidential client to obtain tokens.
Only the following tutorials and integrations require a confidential client:
Register a public OAuth 2.0 client
To register a public OAuth 2.0 client application for use with the SDKs in Identity Cloud, follow these steps:
-
Log in to your Identity Cloud tenant.
-
In the left panel, click Applications.
-
Click Custom Application.
-
Select OIDC - OpenId Connect as the sign-in method, and then click Next.
-
Select Native / SPA as the application type, and then click Next.
-
In Name, enter a name for the application, such as
Public SDK Client. -
In Owners, select a user that is responsible for maintaining the application, and then click Next.
When trying out the SDKs, you could select the demouser you created previously. -
In Client ID, enter
sdkPublicClient, and then click Create Application.Identity Cloud creates the application and displays the details screen.
-
On the Sign On tab:
-
In Sign-In URLs, enter the following values:
https://localhost:8443/callback.htmlhttps://sdkapp.example.com:8443/callbackhttps://com.example.reactnative.todo/callbackhttps://com.example.flutter.todo/callbackAlso add any other domains where you host SDK applications. -
In Grant Types, enter the following values:
Authorization CodeRefresh Token -
In Scopes, enter the following values:
openidprofileemailphone
-
-
Click Show advanced settings, and on the Authentication tab:
-
In Token Endpoint Authentication Method, select
none. -
In Client Type, select
Public. -
Enable the Implied Consent property.
-
-
Click Save.
The application is now configured to accept client connections from and issue OAuth 2.0 tokens to the example applications and tutorials covered by this documentation.
Register a confidential OAuth 2.0 client
The following tutorials and integrations require a confidential client:
To register a confidential OAuth 2.0 client application for use with the SDKs in Identity Cloud, follow these steps:
-
Log in to your Identity Cloud tenant.
-
In the left panel, click Applications.
-
Click Custom Application.
-
Select OIDC - OpenId Connect as the sign-in method, and then click Next.
-
Select Web as the application type, and then click Next.
-
In Name, enter a name for the application, such as
Confidential SDK Client. -
In Owners, select a user responsible for maintaining the application, and then click Next.
When trying out the SDKs, you could select the demouser you created previously. -
On the Web Settings page:
-
In Client ID, enter
sdkConfidentialClient -
In Client Secret, enter a strong password and make a note of it for later use.
The client secret is not available to view after this step.
If you forget it, you must reset the secret and reconfigure any connected clients.
-
Click Create Application.
Identity Cloud creates the application and displays the details screen.
-
-
On the Sign On tab, click Show advanced settings, and on the Access tab:
-
In Default Scopes, enter
am-introspect-all-tokens.
-
-
Click Save.