keycloak-scim/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]
----
http://host:port/auth/realms/master/clients/account/redirect
----               
This URL temporarily redirects to: http://host:port/auth/realms/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}"]`
			`= 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`:

			`[source]`
			`----`
more clients 2016-05-20 20:52:41 +00:00			`http://host:port/auth/realms/master/clients/account/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			`This URL temporarily redirects to: http://host:port/auth/realms/master/account`