keycloak-scim/docs/documentation/server_admin/topics/clients/con-client-links.adoc


[id="con-client-links_{context}"]
= Client links
[role="_abstract"]
To link from one client to another, {project_name} provides a redirect endpoint: `/realms/realm_name/clients/\{client-id}/redirect`.

If a client accesses this endpoint using a `HTTP GET` request, {project_name} returns the configured base URL for the provided Client and Realm in the form of an `HTTP 307` (Temporary Redirect) in the response's `Location` header. As a result of this, a client needs only to know the Realm name and the Client ID to link to them. This indirection avoids hard-coding client base URLs. 

As an example, given the realm `master` and the client-id `account`: 

[source,subs=+attributes]
----
http://host:port{kc_realms_path}/master/clients/account/redirect
----               
This URL temporarily redirects to: http://host:port{kc_realms_path}/master/account
clints 2016-05-20 00:15:52 +00:00
applying indentation using leveloffsets 2020-12-01 23:16:31 +00:00			`[id="con-client-links_{context}"]`
admin-reuse -- Found one more Data Grid link to fix based on a separate PR. 2021-06-17 14:39:30 +00:00			`= Client links`
Keycloak 16024 (#36) * rearranges all client modules into assembly * Adds [role=_abstract] to modules 2020-10-30 15:43:38 +00:00			`[role="_abstract"]`
			To link from one client to another, {project_name} provides a redirect endpoint: `/realms/realm_name/clients/\{client-id}/redirect`.
clints 2016-05-20 00:15:52 +00:00
Keycloak 16024 (#36) * rearranges all client modules into assembly * Adds [role=_abstract] to modules 2020-10-30 15:43:38 +00:00			If a client accesses this endpoint using a `HTTP GET` request, {project_name} returns the configured base URL for the provided Client and Realm in the form of an `HTTP 307` (Temporary Redirect) in the response's `Location` header. As a result of this, a client needs only to know the Realm name and the Client ID to link to them. This indirection avoids hard-coding client base URLs.
clints 2016-05-20 00:15:52 +00:00
			As an example, given the realm `master` and the client-id `account`:

Update documentation for Quarkus distribution (#1385) 2022-02-08 13:07:16 +00:00			`[source,subs=+attributes]`
clints 2016-05-20 00:15:52 +00:00			`----`
Update documentation for Quarkus distribution (#1385) 2022-02-08 13:07:16 +00:00			`http://host:port{kc_realms_path}/master/clients/account/redirect`
clints 2016-05-20 00:15:52 +00:00			`----`
Update documentation for Quarkus distribution (#1385) 2022-02-08 13:07:16 +00:00			`This URL temporarily redirects to: http://host:port{kc_realms_path}/master/account`