# tls

Перезагрузка без перезапуска

Перезагрузка поддерживается для cert\_file/key\_file/ca\_file/cipher\_suites/curve\_preferences; timeout приводит к ошибке; всё остальное отбрасывается.

Объект конфигурации TLS для создания защищённого соединения шлюза. Если блок tls верхнего уровня `gateway{}` содержит сертификаты и для клиента, и для сервера, этот объект можно опустить: сервер использует сертификаты из раздела `gateway{tls{}}`.

## Свойства

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

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