Перейти к основному содержимому
Версия: 2.15 (последняя)

tls

Перезагрузка без перезапуска
Сертификаты перезагружаются и используются соединениями, установленными после этого. Изменение timeout, verify_and_map или verify_cert_and_check_known_urls приводит к ошибке перезагрузки.

Объект конфигурации tls для защиты соединений шлюза. verify всегда включён. Если не указано иное, cert_file служит сертификатом клиента по умолчанию.

Свойства​

ИмяОписаниеТипПо умолчаниюПерезагрузка
allow_insecure_cipher_suitesРазрешить указывать в cipher_suites наборы шифров, считающиеся небезопасными в Go. Без этого их имена отклоняются.booleanfalseДа
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-Да*

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