diff --git a/openshift/topics/advanced_concepts.adoc b/openshift/topics/advanced_concepts.adoc index fb74a821ce..b35f6fdc9d 100644 --- a/openshift/topics/advanced_concepts.adoc +++ b/openshift/topics/advanced_concepts.adoc @@ -230,7 +230,16 @@ $ oc new-app --template={project_templates_version}-https \ [[advanced-concepts-sso-hostname-spi-setup]] === Customizing the Hostname for the {project_name} Server -The hostname SPI introduced a flexible way to configure the hostname for the {project_name} server. There are two built-in providers. The first is `request`, which uses the request headers to determine the hostname. This is the *default setting* for {project_openshift_product_name} image. The second is `fixed`, which allows configuring a fixed hostname. The latter makes sure that only valid hostnames can be used and allows internal applications to invoke {project_name} server through an alternative URL. +The hostname SPI introduced a flexible way to configure the hostname for the {project_name} server. +The default hostname provider one is `default`. This provider provides enhanced functionality over the original `request` provider which is now deprecated. Without additional settings, it uses the request headers to determine the hostname similarly to the original `request` provider. + +For configuration options of the `default` provider, refer to the {installguide_link}#_hostname[{installguide_name}]. +The `frontendUrl` option can be configured via `SSO_FRONTEND_URL` environment variable. + +[NOTE] +For backward compatibility, `SSO_FRONTEND_URL` settings is ignored if `SSO_HOSTNAME` is also set. + +Another option of hostname provider is `fixed`, which allows configuring a fixed hostname. The latter makes sure that only valid hostnames can be used and allows internal applications to invoke the {project_name} server through an alternative URL. Run the following commands to set the `fixed` hostname SPI provider for the {project_name} server: diff --git a/server_installation/topics/host.adoc b/server_installation/topics/host.adoc index 58d9107bb5..f76c5274a5 100644 --- a/server_installation/topics/host.adoc +++ b/server_installation/topics/host.adoc @@ -1,4 +1,5 @@ +[[_hostname]] == Hostname {project_name} uses the public hostname for a number of things. For example, in the token issuer fields and URLs sent in