19.6. HTTP(S)

http-enabled

启用 HTTP 侦听器。

CLI: --http-enabled
Env: KC_HTTP_ENABLED

true,false （默认）

http-host

使用的 HTTP 主机。

CLI: --http-host
Env: KC_HTTP_HOST

0.0.0.0 （默认）

http-max-queued-requests

排队的 HTTP 请求的最大数量。

使用它来保证负载过载。过量请求将返回 "503 Server not Available" 响应。

CLI: --http-max-queued-requests
Env: KC_HTTP_MAX_QUEUED_REQUESTS

http-pool-max-threads

线程的最大数量。

如果没有指定，则会自动调整到最大 8 个()可用处理器的数量和 200。例如，如果有 4 个处理器，最大线程数为 200。如果有 48 个处理器，它将是 384。

CLI: --http-pool-max-threads
Env: KC_HTTP_POOL_MAX_THREADS

http-port

使用的 HTTP 端口。

CLI: --http-port
Env: KC_HTTP_PORT

8080 （默认）

http-relative-path 🛠

为服务资源设置相对于 / 的路径。

该路径必须以 / 开头。

CLI: --http-relative-path
Env: KC_HTTP_RELATIVE_PATH

/ （默认）

https-certificate-file

PEM 格式的服务器证书或证书链的文件路径。

CLI: --https-certificate-file
Env: KC_HTTPS_CERTIFICATE_FILE

https-certificate-key-file

PEM 格式到私钥的文件路径。

CLI: --https-certificate-key-file
Env: KC_HTTPS_CERTIFICATE_KEY_FILE

https-cipher-suites

要使用的密码套件。

如果未指定，则会选择合理的默认值。

CLI: --https-cipher-suites
Env: KC_HTTPS_CIPHER_SUITES

https-client-auth 🛠

将服务器配置为 require/request 客户端身份验证。

CLI: --https-client-auth
Env: KC_HTTPS_CLIENT_AUTH

none （默认）、请求、必需

https-key-store-file

保存证书信息的密钥存储，而不是指定单独的文件。

CLI: --https-key-store-file
Env: KC_HTTPS_KEY_STORE_FILE

https-key-store-password

密钥存储文件的密码。

CLI: --https-key-store-password
Env: KC_HTTPS_KEY_STORE_PASSWORD

密码 （默认）

https-key-store-type

密钥存储文件的类型。

如果没有给定，会根据文件名自动检测类型。如果将 fips-mode 设置为 strict 且没有设置值，则默认为 BCFKS。

CLI: --https-key-store-type
Env: KC_HTTPS_KEY_STORE_TYPE

https-port

使用的 HTTPS 端口。

CLI: --https-port
Env: KC_HTTPS_PORT

8443 （默认）

https-protocols

要显式启用的协议列表。

CLI: --https-protocols
Env: KC_HTTPS_PROTOCOLS

[TLSv1.3,TLSv1.2] （默认）

https-trust-store-file

包含要信任的证书信息的信任存储。

CLI: --https-trust-store-file
Env: KC_HTTPS_TRUST_STORE_FILE

已弃用。使用 System Truststore 替代，请参阅文档了解详情。

https-trust-store-password

信任存储文件的密码。

CLI: --https-trust-store-password
Env: KC_HTTPS_TRUST_STORE_PASSWORD

已弃用。使用 System Truststore 替代，请参阅文档了解详情。

https-trust-store-type

信任存储文件的类型。

如果没有给定，会根据文件名自动检测类型。如果将 fips-mode 设置为 strict 且没有设置值，则默认为 BCFKS。

CLI: --https-trust-store-type
Env: KC_HTTPS_TRUST_STORE_TYPE

已弃用。使用 System Truststore 替代，请参阅文档了解详情。