33 lines
1 KiB
Text
33 lines
1 KiB
Text
|
= Clients
|
||
|
|
:doctype: book
|
||
|
|
:sectnums:
|
||
|
|
:toc: left
|
||
|
|
:icons: font
|
||
|
|
:experimental:
|
||
|
|
:sourcedir: .
|
||
|
|
|
||
|
|
Keycloak provides support for managing Clients.
|
||
|
|
|
||
|
|
== Client Config
|
||
|
|
|
||
|
|
Keycloak supports flexible configuration of Clients.
|
||
|
|
|
||
|
|
=== Redirect Endpoint
|
||
|
|
|
||
|
|
For scenarios where one wants to link from one client to another, Keycloak provides a special redirect endpoint: `/realms/realm_name/clients/client_id/redirect`.
|
||
|
|
|
||
|
|
If a client accesses this endpoint via an `HTTP GET` request, Keycloak returns the configured base URL for the provided Client and Realm in the form of an `HTTP 307` (Temporary Redirect) via the response's `Location` header.
|
||
|
|
|
||
|
|
Thus, a client only needs to know the Realm name and the Client ID in order to link to them.
|
||
|
|
This indirection helps avoid hard-coding client base URLs.
|
||
|
|
|
||
|
|
As an example, given the realm `master` and the client-id `account`:
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
http://keycloak-host:keycloak-port/auth/realms/master/clients/account/redirect
|
||
|
|
----
|
||
|
|
Would temporarily redirect to: http://keycloak-host:keycloak-port/auth/realms/master/account
|
||
|
|
|
||
|
|
|