В обычном HTTPS-соединении подлинность доказывает только сервер: браузер проверяет сертификат и убеждается, что подключился к нужному сайту. Клиент же остаётся анонимным, и его определяют позже — по логину, паролю или API-ключу. mTLS (mutual TLS, взаимный TLS) расширяет эту схему: во время подключения клиент тоже предъявляет свой сертификат, а сервер его проверяет. Клиент без сертификата или с неправильным сертификатом до вашего приложения просто не доходит.
Разве API-ключа недостаточно?
Многие API защищены секретным ключом в заголовке запроса, и часто этого хватает. Но ключ — это обычная строка: она может остаться в конфигурационном файле, в логах или в скрипте на компьютере сотрудника. Кто её скопирует, тот сможет обращаться к вашему API из любой точки мира. Кроме того, ключ проверяется на уровне приложения, то есть кто угодно может установить TLS-соединение с вашим сервером и донести запрос до приложения.
В mTLS защита срабатывает на шаг раньше — на этапе TLS-рукопожатия. Закрытый ключ клиента никогда не передаётся по сети, он используется только для подписи. Во многих серьёзных интеграциях применяют оба механизма вместе: mTLS ограничивает сам канал, а API-ключ или токен определяет конкретные права.
Когда нужен mTLS
mTLS обычно применяют не для публичных пользователей, а для заранее известных клиентов, число которых ограничено. Типичные примеры:
- B2B-интеграция двух компаний, например обмен заказами и остатками;
- связь сервер-сервер с платёжными или банковскими системами, если партнёр этого требует;
- взаимодействие внутренних микросервисов, особенно размещённых на разных серверах;
- подключение кассовых терминалов магазина или IoT-устройств к центральному серверу.
Для обычных посетителей сайта mTLS неудобен: каждому пришлось бы устанавливать сертификат. Поэтому на публичных сайтах его практически не используют.
Пример: оптовая компания из Самарканда и партнёрский склад
Допустим, у оптовой компании из Самарканда есть API заказов по адресу api.example.uz. Партнёрский склад в Ташкенте каждые десять минут забирает новые заказы и возвращает данные об отгрузках. Компания хочет, чтобы к API имел доступ только сервер этого партнёра. Ограничение по IP — один из вариантов, но оно ломается, если партнёр сменит провайдера или перейдёт на резервный канал. mTLS к IP не привязан: откуда бы ни пришло соединение, оно пройдёт только при наличии сертификата.
Компания создаёт собственный внутренний удостоверяющий центр (CA), выпускает для партнёра клиентский сертификат и передаёт его по защищённому каналу. Nginx настраивается так, чтобы принимать только сертификаты, подписанные этим CA. Если позже появится второй партнёр, ему выпустят отдельный сертификат, и при необходимости его можно будет отозвать, не трогая первого.
Создание внутреннего CA и клиентского сертификата
Для клиентских сертификатов публичные удостоверяющие центры не нужны и обычно не подходят по смыслу. Публичный CA выдаёт сертификаты кому угодно, а вам нужна закрытая система, доверяющая только выпущенным вами сертификатам. Следующие команды на VPS создают внутренний CA и сертификат для одного партнёра:
mkdir -p /etc/nginx/mtls && cd /etc/nginx/mtls
# 1. Внутренний CA (удостоверяющий центр)
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes \
-keyout ca.key -out ca.crt -subj "/CN=Example API CA"
# 2. Ключ и запрос для партнёра
openssl req -newkey rsa:2048 -nodes \
-keyout partner.key -out partner.csr -subj "/CN=ombor-hamkor"
# 3. Подпись только для аутентификации клиента
printf "extendedKeyUsage=clientAuth\n" > client.ext
openssl x509 -req -in partner.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-out partner.crt -days 365 -sha256 -extfile client.ext
Файл ca.key храните особенно бережно: тот, у кого он есть, сможет выпустить сертификат для себя. Хорошая практика — держать его не на API-сервере, а в отдельном защищённом месте, а на сервер класть только открытый ca.crt. Партнёру передаются partner.crt и partner.key, причём не по электронной почте, а в зашифрованном архиве или по другому надёжному каналу.
Включение mTLS в Nginx
Серверный сертификат остаётся обычным, например бесплатным Let's Encrypt. Дополнительно указывается файл CA для проверки клиентских сертификатов и включается ssl_verify_client on:
server {
listen 443 ssl;
server_name api.example.uz;
ssl_certificate /etc/letsencrypt/live/api.example.uz/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.example.uz/privkey.pem;
ssl_client_certificate /etc/nginx/mtls/ca.crt;
ssl_verify_client on;
ssl_verify_depth 2;
location / {
proxy_set_header X-Client-DN $ssl_client_s_dn;
proxy_set_header X-Client-Verify $ssl_client_verify;
proxy_pass http://127.0.0.1:8000;
}
}
Здесь Nginx передаёт приложению имя (DN) проверенного клиента в заголовке, а приложение может использовать его для логирования или определения прав. proxy_set_header перезаписывает одноимённые заголовки, пришедшие от клиента, но убедитесь, что порт приложения не открыт напрямую извне, иначе заголовок можно будет подделать. Проверьте конфигурацию командой nginx -t и примените через systemctl reload nginx.
Проверка и отзыв сертификата
С сервера партнёра подключение проверяется через curl:
curl --cert partner.crt --key partner.key https://api.example.uz/v1/orders
При попытке без сертификата Nginx вернёт ошибку 400 с сообщением «No required SSL certificate was sent» — значит, настройка работает. Если договор с партнёром закончился или есть подозрение на утечку ключа, сертификат нужно отозвать. Для этого формируется список отозванных сертификатов (CRL) и подключается в Nginx директивой ssl_crl. Чтобы создавать CRL утилитой openssl ca, сначала нужно настроить её конфигурацию и индексный файл, после чего команда выглядит так:
openssl ca -gencrl -keyfile ca.key -cert ca.crt -out ca.crl
Для небольших проектов есть путь проще: выпускать сертификаты на короткий срок, например на 90 дней, и просто не продлевать их, когда доступ больше не нужен. В любом случае занесите сроки сертификатов в календарь, иначе однажды утром интеграция внезапно остановится.
Можно ли это сделать на хостинге
mTLS требует настройки на уровне веб-сервера, а на обычном виртуальном хостинге эти параметры общие, и клиент их не меняет. Поэтому для API под защитой mTLS обычно выбирают VPS. На sayt.uz VPS можно заказать в кабинете и установить на него Nginx с приведённой конфигурацией, а для серверного сертификата достаточно Let's Encrypt. Если не уверены, какой вариант подходит вашему проекту, напишите в техподдержку через кабинет sayt.uz.