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