🤝
blog.cat.ssl

mTLS: защита API взаимной аутентификацией по сертификатам

20.11.2026
← Все статьи

В обычном HTTPS-соединении подлинность доказывает только сервер: браузер проверяет сертификат и убеждается, что подключился к нужному сайту. Клиент же остаётся анонимным, и его определяют позже — по логину, паролю или API-ключу. mTLS (mutual TLS, взаимный TLS) расширяет эту схему: во время подключения клиент тоже предъявляет свой сертификат, а сервер его проверяет. Клиент без сертификата или с неправильным сертификатом до вашего приложения просто не доходит.

Разве API-ключа недостаточно?

Многие API защищены секретным ключом в заголовке запроса, и часто этого хватает. Но ключ — это обычная строка: она может остаться в конфигурационном файле, в логах или в скрипте на компьютере сотрудника. Кто её скопирует, тот сможет обращаться к вашему API из любой точки мира. Кроме того, ключ проверяется на уровне приложения, то есть кто угодно может установить TLS-соединение с вашим сервером и донести запрос до приложения.

В mTLS защита срабатывает на шаг раньше — на этапе TLS-рукопожатия. Закрытый ключ клиента никогда не передаётся по сети, он используется только для подписи. Во многих серьёзных интеграциях применяют оба механизма вместе: mTLS ограничивает сам канал, а API-ключ или токен определяет конкретные права.

Когда нужен mTLS

mTLS обычно применяют не для публичных пользователей, а для заранее известных клиентов, число которых ограничено. Типичные примеры:

Для обычных посетителей сайта 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.

Похожие статьи

📧 SSL для mail.домен.uz: как убрать предупреждение о сертификате в Outlook ⏳ Лимиты Let's Encrypt: ошибка «too many certificates» и как её решить 📜 Certificate Transparency: как работают открытые журналы SSL-сертификатов 🏢 SSL для внутренних (интранет) сайтов: как защитить офисные системы
🌐 Язык
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English