Односторонний TLS: что HTTPS уже доказывает
Когда браузер открывает сайт по HTTPS, рукопожатие TLS делает две вещи: согласует ключи шифрования, а сервер подтверждает свою личность сертификатом, подписанным центром, которому доверяет браузер. Браузер проверяет, что сертификат действителен, не просрочен и выпущен для запрошенного им имени хоста.
Обратите внимание, чего здесь нет: сервер ничего не узнаёт о клиенте. Это рукопожатие может завершить кто угодно в интернете. Кто клиент, выясняется позже, внутри HTTP-запроса — пароль, cookie сессии, ключ API, токен. Для публичного сайта это именно то, что нужно: вы хотите, чтобы подключаться мог каждый.
Взаимный TLS: обе стороны показывают сертификат
В взаимном TLS (mTLS) сервер в ответ запрашивает сертификат. Во время рукопожатия он называет центры, которые принимает; клиент отвечает собственным сертификатом и доказывает, что владеет соответствующим закрытым ключом, подписывая часть рукопожатия. Сервер проверяет цепочку по центрам, которым доверяет, и если что-то не так — сертификата нет, издатель неизвестен, срок истёк, — завершает рукопожатие.
В этом и ценность mTLS: клиент без нужного сертификата не может отправить ни одного HTTP-запроса. Нет страницы входа, чтобы подбирать пароли, нет конечной точки, чтобы её зондировать, нет запроса, который мог бы разобрать уязвимый код приложения. Проверка происходит до запуска вашего приложения.
mTLS не заменяет авторизацию. Он сообщает, какой клиент подключается; что этому клиенту разрешено, по-прежнему решает ваше приложение. И поскольку личность заключена в сертификате, вся схема держится на том, что закрытый ключ клиента остаётся закрытым.
Сертификаты и центры сертификации
Клиентские сертификаты редко покупают у публичного центра. Обычно организация держит собственный частный CA: корневой сертификат, хранящийся офлайн, и промежуточный, который ежедневно подписывает клиентские сертификаты. Серверу выдают сертификаты этого CA — CA-пакет — и он принимает любой клиентский сертификат, цепочка которого ведёт к ним.
Доверять CA значит доверять всему, что он подписывает, поэтому аккуратный сервер проверяет ещё одно: имя в сертификате — CN субъекта или запись SAN. Когда один CA выпускает сертификаты нескольким клиентам, различает их именно имя.
Отсюда два практических правила. Закрепляйте имя, а не отпечаток: сертификаты обновляются, и отпечаток меняется при каждом обновлении, а имя остаётся прежним. И автоматизируйте обновление: короткоживущие сертификаты, которые обновляет машина, безопаснее долгоживущих, о которых кому-то нужно помнить.
Где mTLS оправдан
Сервис — сервис. Внутри платформы сервисы аутентифицируют друг друга сертификатами вместо общих паролей; сервисные меши делают это автоматически.
Партнёрские и B2B API. Банк, платёжный провайдер или логистический партнёр выдаёт каждому клиенту отдельный сертификат, и API принимает только их.
Устройства. Киоски, терминалы и IoT-устройства несут сертификат, выданный при регистрации, так что одного утёкшего ключа API недостаточно.
Ваш origin за CDN. Посетители общаются с CDN; с вашим origin должен общаться только CDN. Когда edge предъявляет клиентский сертификат, а ваш origin его требует, запросы, пытающиеся обойти CDN — а с ним его WAF и лимиты, — отклоняются во время рукопожатия. Обычно это называют аутентифицированным подключением к источнику (authenticated origin pull).
Требуем клиентский сертификат в nginx
Со стороны сервера mTLS — это несколько строк. nginx нужны CA-пакет, которому доверять, указание требовать сертификат и, желательно, проверка имени, как в примере ниже.
ssl_verify_client on отклоняет рукопожатие без действительного сертификата; на такие запросы nginx отвечает 400 Bad Request («No required SSL certificate was sent»). ssl_verify_depth 2 допускает корневой плюс один промежуточный сертификат. Блок if затем принимает только ожидаемое имя, так что сертификат от того же CA, выданный кому-то другому, получает 403.
Чтобы проверить со стороны клиента, передайте curl сертификат и ключ: curl --cert client.crt --key client.key https://origin.example.com/. Тот же запрос без --cert и --key должен быть отклонён.
nginx: требуем клиентский сертификат и проверяем его имя
server {
listen 443 ssl;
server_name origin.example.com;
ssl_certificate /etc/nginx/tls/origin.crt;
ssl_certificate_key /etc/nginx/tls/origin.key;
# trust client certificates signed by this CA, and require one
ssl_client_certificate /etc/nginx/tls/client-ca.pem;
ssl_verify_client on;
ssl_verify_depth 2;
# accept only the expected name
if ($ssl_client_s_dn !~ "(^|,)CN=client\.example\.com(,|$)") {
return 403;
}
}
Аутентифицированное подключение к источнику на cdn.com.tr
На cdn.com.tr аутентифицированное подключение к источнику — это карточка на странице Источник вашего аккаунта. Когда она включена, наши edge-серверы предъявляют клиентский сертификат при каждом подключении к вашему origin, а вы выбираете, какой именно.
Сертификат CDN.com.tr — на всех платных тарифах. Каждый edge предъявляет CN=origin-pull.cdn.com.tr, что доказывает: запрос пришёл с edge-серверов CDN.com.tr. Сочетайте его с секретным заголовком origin, имя и значение которого вы выбираете и добавляете в правила доставки; ваш origin проверяет и то и другое, а заголовок отличает ваши запросы от остальных.
Сертификат только для этого аккаунта — на тарифах Enterprise. Имя в сертификате — это ID вашего аккаунта, так что origin, принимающий только это имя, принимает только ваш аккаунт.
Карточка даёт CA-пакет для скачивания (cdn-com-tr-origin-pull-ca.pem) и точное имя, которое нужно принимать. Вашему origin нужен собственный HTTPS-порт, отличный от HTTP-порта: при включённой настройке edge-серверы подключаются к нему по HTTPS для каждого посетителя, включая HTTP-посетителей. Сертификаты edge-серверов обновляются автоматически с тем же именем, так что проверка по имени продолжает проходить, а оптимизация изображений продолжает работать, потому что наши серверы оптимизации предъявляют тот же сертификат, когда забирают ваши оригиналы. Edge-серверы могут также проверять сертификат вашего origin, так что доверие работает в обе стороны. Настройки для nginx, Apache, Caddy и IIS есть в руководстве по аутентифицированному подключению к источнику.
Как включить так, чтобы не запереть себя
Порядок важен, потому что сервер, требующий сертификат, отклоняет всех, кто его пока не предъявляет.
1. HTTPS на origin. Убедитесь, что ваш origin отвечает по HTTPS на собственном порту и что CDN уже до него дотягивается.
2. Сертификат на edge. Выберите клиентский сертификат в панели и дождитесь, пока он станет активным на edge-серверах.
3. Конфигурация на origin. Установите CA-пакет и напишите конфигурацию с проверкой имени, пока не включая принудительное требование.
4. Включите требование. Только теперь включите обязательность сертификата и перезагрузите веб-сервер.
5. Проверьте в обе стороны. Запрос через CDN возвращает 200; запрос напрямую к origin без сертификата отклоняется.
Если поменять шаги 2 и 4 местами, origin отклонит edge: nginx ответит 400, а Apache, Caddy и IIS закроют соединение, и посетители увидят 502 Bad Gateway.
Кто полагается на mTLS
Каждый партнёр подключается с выданным ему сертификатом, а любой другой клиент получает отказ раньше, чем API прочитает хотя бы байт.
Киоски, терминалы и датчики несут собственный сертификат, так что один утёкший ключ API ничего не открывает.
Origin принимает только соединения с сертификатом CDN, так что никто не может обойти WAF и лимиты запросов.
Как настроить
Пошаговые руководства в справочном центре:
mTLS: частые вопросы
Чем TLS отличается от mTLS?
В TLS сертификат предъявляет только сервер, поэтому клиент знает, кто сервер. В mTLS сертификат предъявляет и клиент, поэтому сервер тоже знает, кто клиент, и во время рукопожатия отклоняет клиентов без действительного сертификата.
mTLS — это то же самое, что ключ API?
Нет. Ключ API путешествует внутри запроса, и его можно скопировать из лога или файла конфигурации. Клиент mTLS доказывает, что владеет закрытым ключом, который никогда не пересекает сеть. Многие API используют оба механизма: mTLS — чтобы знать, какой клиент подключается, ключ или токен — чтобы определить, что ему разрешено.
Поддерживают ли браузеры клиентские сертификаты?
Да, но для публики это неудобно: пользователям нужно установить сертификат и выбрать его в диалоге. Поэтому mTLS используют между машинами и на управляемых устройствах, а не для обычных посетителей сайта.
Нужен ли секретный заголовок при аутентифицированном подключении к источнику?
С сертификатом CDN.com.tr — да: сертификат доказывает, что запрос пришёл от CDN.com.tr, секретный заголовок — что он пришёл из вашего аккаунта. С сертификатом аккаунта на тарифах Enterprise одной проверки имени уже достаточно, чтобы принимать только ваш аккаунт; наличие заголовка вдобавок не помешает.
Что происходит при обновлении клиентского сертификата?
Если ваш сервер проверяет имя (CN), а не отпечаток, ничего. На cdn.com.tr сертификаты edge-серверов обновляются до истечения срока, от того же CA и с тем же именем.
Почему мой origin отвечает 400 после включения mTLS?
nginx отвечает 400, когда обязательный клиентский сертификат не был отправлен. Обычно требование включили раньше, чем edge-серверы начали предъявлять сертификат, или запрос пришёл не через CDN. Проверьте, что панель показывает сертификат активным на edge-серверах, и повторите проверку.