Available only when Management interface is enabled
The management interface allows accessing management endpoints via a different HTTP server than the primary one.
It provides the possibility to hide endpoints like /metrics
or /health
from the outside world and, therefore, hardens the security.
The most significant advantage might be seen in Kubernetes environments as the specific management port might not be exposed.
The management interface is turned on by default, so management endpoints such as /metrics
, and /health
are exposed on the default management port 9000
.
The management interface provides a set of options and is fully configurable.
In order to change the port for the management interface, you can use the Keycloak option http-management-port
.
If management interface properties are not explicitly set, their values are automatically inherited from the default HTTP server. |
You can change the relative path of the management interface, as the prefix path for the management endpoints can be different.
You can achieve it via the Keycloak option http-management-relative-path
.
For instance, if you set the CLI option --http-management-relative-path=/management
, the metrics, and health endpoints will be accessed on the /management/metrics
and /management/health
paths.
If you do not explicitly set the value for it, the value from the http-relative-path property is used. For instance,
if you set the CLI option --http-relative-path=/auth , these endpoints are accessible on the /auth/metrics and /auth/health paths.
|
When the TLS is set for the default Keycloak server, the management interface will be accessible through HTTPS as well. The management interface can run only either on HTTP or HTTPS, not both as for the main server.
Specific Keycloak management interface options with the prefix https-management-*
were provided for setting different TLS parameters for the management HTTP server. Their function is similar to their counterparts for the main HTTP server, for details see Configuring TLS.
When these options are not explicitly set, the TLS parameters are inherited from the default HTTP server.
The management interface is automatically turned off when nothing is exposed on it.
Currently, only health checks and metrics are exposed on the management interface regardless.
If you want to disable exposing them on the management interface, set the Keycloak property legacy-observability-interface
to true
.
Exposing health and metrics endpoints on the default server is not recommended for security reasons, and you should always use the management interface.
Beware, the |
Value | |
---|---|
Available only when Management interface is enabled |
(default) |
Available only when Management interface is enabled |
(default) |
Available only when Management interface is enabled |
|
Available only when Management interface is enabled |
|
Available only when Management interface is enabled |
|
Available only when Management interface is enabled |
|
Available only when Management interface is enabled |
(default) |
DEPRECATED. |
|