Перейти к основному содержимому
Версия: 2.11

tls

Перезагрузка без перезапуска
Новые настройки TLS применяются к маршрутным соединениям, установленным после перезагрузки; существующие маршруты сохраняют старый сеанс TLS.

Конфигурация TLS для защиты соединений кластера. verify всегда включён, а cert_file используется и клиентом, и сервером для взаимного TLS.

Свойства​

ИмяОписаниеТипПо умолчаниюПерезагрузка
cert_storeЗагружать сертификат из хранилища сертификатов ОС вместо файла. Только Windows.string-Да
certsНесколько пар сертификат/ключ, позволяющих одному слушателю предъявлять разные сертификаты разным клиентам. Используйте вместо cert_file и key_file.object-Да
handshake_firstВыполнять рукопожатие TLS до сообщения протокола INFO, а не после. Строка длительности вместо true задаёт время ожидания клиента, который может не поддерживать этот режим, до перехода к обычному порядку.(multiple)falseДа
min_versionМинимальная версия TLS, согласуемая сервером.string-Да
ocsp_peerПроверять сертификат другой стороны через её ответчик OCSP и отклонять отозванные сертификаты. Для настройки проверок задайте объект.(multiple)falseДа
cert_fileФайл сертификата TLS.string-Да*
key_fileФайл ключа сертификата TLS.string-Да*
ca_fileФайл центра сертификации TLS. По умолчанию используется системное хранилище доверенных сертификатов.string-Да*
cipher_suitesЕсли задано, разрешены только указанные наборы шифров TLS. Значения должны соответствовать версии Go, использованной для сборки сервера.string-Да*
curve_preferencesУпорядоченный список кривых для TLS.string-Да*
insecureПропустить проверку сертификата. Применяется только к исходящим соединениям, НЕ к входящим клиентским. Не рекомендуется.boolean-Да*
timeoutТайм-аут рукопожатия TLS.duration500msДа*
verifyЕсли true, требует и проверяет сертификаты клиентов. К мониторингу не применяется.booleanfalseИгнорируется*
verify_and_mapЕсли true, требует и проверяет сертификаты клиентов и отображает значения сертификата для аутентификации. К мониторингу не применяется.booleanfalseДа*
verify_cert_and_check_known_urlsИспользуется только вне клиентского контекста при включённом verify, например в конфигурациях кластеров и шлюзов. DNS-записи x509v3 Subject Alternative Name сертификата входящего соединения сопоставляются со всеми URL. При совпадении соединение принимается, иначе отклоняется. Для шлюзов сервер сопоставляет все имена сертификата с URL шлюзов, для кластеров — с URL маршрутов. Поэтому динамическое расширение кластера может потребовать изменения конфигурации других кластеров, где этот параметр включён. Проверка DNS-имён выполняется по RFC6125. Поддерживается только полная подстановка для самого левого компонента доменного имени.boolean-Да*
connection_rate_limitinteger-Игнорируется*
pinned_certsСписок отпечатков открытых ключей: SHA256 от представления DER в шестнадцатеричной кодировке. При наличии списка отпечаток предъявленного во время TLS-рукопожатия сертификата должен входить в него, иначе соединение закрывается.string-Да*

* Ограничения перезагрузки описаны на странице параметра.