Keycloak and the Public Hostname

In order for Keycloak to be accessible by external clients (using the public hostname of the server it is installed on), Keycloak must be configured to be aware of this public hostname.

The following steps describe how to configure the public hostname in Keycloak:

• Stop the Blueriq Keycloak Service

Edit [INSTALL_FOLDER]\tools\Keycloak\conf\keycloak.conf, and depending on the blueriq version:

Blueriq 15.4 and later

• Set hostname=[HOSTNAME]
• Add hostname-port=[PORT]
• Add hostname-admin=[HOSTNAME]

Before Blueriq 15.4

• set hostname=[HOSTNAME]:[PORT]

Where:

• [HOSTNAME] is the public hostname, for example my-studio.company.com

• [PORT] is public port, for example 150 in a default Blueriq 15 installation.

In the [INSTALL_FOLDER]\tools\Keycloak\bin folder:

• From the command line run kc build 

• Start the Blueriq Keycloak Service