Модуль Apache mod_tls

Краткое описание

mod_tls — это альтернатива mod_ssl для обеспечения https-сервиса. Его функционал является подмножеством, описанным более подробно ниже. Он может использоваться как дополнение к mod_ssl, например, оба модуля могут быть загружены одновременно.

mod_tls, написанный на C, использует реализацию TLS на Rust под названием rustls через свой C-интерфейс rustls-ffi. Это обеспечивает безопасную криптографию и обработку протоколов со сравнимой производительностью.

Он может быть настроен для фронтенд- и бэкенд-соединений. Директивы конфигурации в основном аналогичны mod_ssl.

TLS в контексте VirtualHost

Listen 443
TLSEngine 443

<VirtualHost *:443>
  ServerName example.net
  TLSCertificate file_with_certificate.pem file_with_key.pem
  ...
</VirtualHost>

Выше приведена минимальная конфигурация. Вместо включения mod_tls в каждом виртуальном хосте, указывается порт для входящих TLS-соединений.

Вы не можете смешивать виртуальные хосты с mod_ssl и mod_tls на одном порту. Либо одно, либо другое. Поддерживаются SNI и ALPN. Вы можете использовать несколько виртуальных хостов на одном порту и смешивать протоколы, такие как http/1.1 и h2.

Сравнение функциональности с mod_ssl

Таблица ниже показывает сравнение функциональных возможностей mod_ssl и mod_tls. Если функция mod_ssl не указана здесь, она не поддерживается mod_tls. Вероятно, самое существенное отличие — отсутствие поддержки сертификатов клиента в текущей версии mod_tls.

Протоколы TLS

mod_tls поддерживает протоколы TLS версии 1.2 и 1.3. Если когда-нибудь появится версия 1.4 и rustls ее поддержит, она также будет доступна.

В mod_tls настраивается минимальная версия, а не максимальная:

TLSProtocol TLSv1.3+

Это позволяет использовать только версию 1.3 и любые последующие версии при общении с вашим сервером или конкретным виртуальным хостом.

Шифры TLS

Список поддерживаемых шифров TLS в библиотеке rustls можно найти здесь. Все шифры TLS v1.3 поддерживаются. Для TLS v1.2 доступны только шифры, которые rustls считает безопасными.

mod_tls поддерживает следующие имена для шифров TLS:

1. Присвоенное IANA имя, использующее `_` для разделения частей. Пример: TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
2. Имя OpenSSL, использующее `-` в качестве разделителя (для 1.2). Пример: ECDHE-ECDSA-AES256-SHA384. Такие имена часто встречаются в документации. `mod_tls` определяет их для всех шифров TLS v1.2. Для шифров TLS v1.3 также поддерживаются имена, начинающиеся с TLS13_.
3. Присвоенный IANA идентификатор, представляющий собой 16-битное числовое значение. Пример: 0xc024. Вы можете использовать его в конфигурациях как TLS_CIPHER_0xc024.

Вы можете настроить предпочтение шифров, что означает, что они будут использоваться для клиентов, которые их поддерживают. Если вы не настроите предпочтение, rustls будет использовать тот, который он считает лучшим. Это рекомендуется.

Тем не менее, если вам необходимо указать приоритет одного шифра над другим, вы можете настроить это следующим образом:

TLSCiphersPrefer ECDHE-ECDSA-AES256-SHA384
# or several
TLSCiphersPrefer ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305

Если вы укажете неизвестный шифр, конфигурация завершится ошибкой. Если вы укажете шифр, не поддерживаемый rustls (или больше не поддерживаемый в обновленной версии rustls по соображениям безопасности), mod_tls выведет сообщение WARNING, но продолжит работу.

Аналогичный механизм существует, если вы хотите отключить определенный шифр:

TLSCipherSuppress ECDHE-ECDSA-AES256-SHA384

Запрещенный шифр больше не будет использоваться. Если вы укажете неизвестный шифр, конфигурация завершится ошибкой. Если вы укажете шифр, не поддерживаемый rustls (или больше не поддерживаемый в обновленной версии rustls по соображениям безопасности), mod_tls выведет сообщение WARNING, но продолжит работу.

Виртуальные хосты

mod_tls использует SNI (Server Name Indicator) для выбора одного из настроенных виртуальных хостов, соответствующих порту, который обслуживается. Если клиент не предоставит SNI, будет выбран первый настроенный виртуальный хост. Если клиент предоставит SNI (как это делают все современные клиенты), он должен совпадать с одним виртуальным хостом (ServerName или ServerAlias) или подключение завершится ошибкой.

Как и в случае с mod_ssl, вы можете указать шифры и версии протоколов для базового сервера (глобального) и/или отдельных виртуальных хостов, которые выбираются клиентом по SNI.

Listen 443
TLSEngine 443

<VirtualHost *:443>
  ServerName example1.net
  TLSCertificate example1-cert.pem
  ...
</VirtualHost>

<VirtualHost *:443>
  ServerName example2.net
  TLSCertificate example2-cert.pem
  ...
  TLSProtocol v1.3+
</VirtualHost>

Приведенный выше пример показывает разные настройки TLS для виртуальных хостов на одном порту. Это поддерживается. example1 может быть достигнут через все версии TLS, а example2 допускает только v1.3 или более поздние версии.

Сертификаты ACME

Сертификаты ACME через mod_md поддерживаются, как и для mod_ssl. Минимальная конфигурация:

Listen 443
TLSEngine 443
MDomain example.net

<VirtualHost *:443>
  ServerName example.net
  ...
</VirtualHost>

OCSP Stapling

mod_tls не имеет собственной реализации для получения информации OCSP для сертификата. Однако он будет использовать ее для Stapling, если она предоставляется mod_md. См. документацию mod_md по включению этой функции.

Переменные TLS

Через директиву TLSOptions, несколько переменных помещаются в среду запросов и могут быть просмотрены, например, в скрипте CGI.

Имена переменных задаются mod_ssl. Обратите внимание, что это только подмножество многих переменных, которые предоставляет mod_ssl.

Переменная SSL_SESSION_ID намеренно не поддерживается, так как содержит конфиденциальную информацию.

Сертификаты клиентов

Хотя rustls поддерживает сертификаты клиентов в принципе, часть инфраструктуры для использования этих сертификатов на сервере не реализована.

К этим функциям относятся: списки отзыва, проверка расширений сертификатов и сопоставленной цепочки выдачи для проверки OCSP. Без них отзыв сертификатов клиента невозможен. Предложение аутентификации без отзыва не рассматривается.

Работа над этим будет продолжена, и поддержка сертификатов клиентов может стать доступной в будущей версии.

TLSCertificate cert_file [key_file]

TLSCiphersPrefer cipher(-list)

TLSCiphersPrefer ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305

TLSCiphersSuppress cipher(-list)

TLSCiphersSuppress ECDHE-ECDSA-CHACHA20-POLY1305

TLSEngine [address:]port

TLSEngine 443

TLSHonorClientOrder on|off

TLSHonorClientOrder on

TLSOptions [+|-]option

<Location /myplace/app>
  TLSOptions Defaults StdEnvVars
  ...
</Location>

TLSProtocol version+

TLSProtocol v1.2+

TLSProxyCA file.pem

TLSProxyCiphersPrefer cipher(-list)

TLSProxyCiphersSuppress cipher(-list)

TLSProxyEngine on|off

TLSProxyMachineCertificate cert_file [key_file]

TLSProxyProtocol version+

TLSProxyProtocol v1.2+

TLSSessionCache cache-spec

TLSStrictSNI on|off

TLSStrictSNI on