Identity Cloud

Specify realms in URLs

Specify the realm in the hostname or the path of the URL depending on the settings for the realm.

In the hostname

If you define a custom domain for the realm, you can target the realm using the hostname instead of the path.

For example, suppose the alpha realm uses the custom domain auth.example.com. Client applications can access a user profile without showing the realm name as in the following example:

https://auth.example.com/am/json/users/a0325ea4-9d9b-4056-931b-ab64704cc3da

In the path

You can specify the realm in the path of the URL. For example, use the following URL to authenticate in the alpha realm:

https://<tenant-env-fqdn>/am/json/realms/root/realms/alpha/authenticate

If you specify a custom domain and a path, the path determines the realm. For example, the following URL references a user profile in the bravo realm, not the realm with custom domain auth.example.com:

https://auth.example.com/am/json/realms/root/realms/bravo/users/8cf34972-bdec-4dfa-a34e-536647fb60ff
Copyright © 2010-2024 ForgeRock, all rights reserved.