$ssl_client_cert

Описание

Переменная $ssl_client_cert используется при проверке клиентского SSL-сертификата в NGINX. Эта переменная хранит SSL-сертификат клиента, предоставленный в ходе SSL-рукопожатия, в формате PEM-кодированной строки. Она устанавливается в значение сертификата клиента, когда директива 'ssl_verify_client' настроена в 'on' и сертификат успешно подтверждён. Она особенно полезна в сценариях, требующих защищённой связи, где проверка личности клиента необходима, например в API-службах или системах аутентификации пользователей. Если клиентский сертификат не предоставлен или проверка неуспешна, эта переменная будет пустой. Содержимое этой переменной может быть записано в лог, проверено в условных выражениях или при необходимости передано бэкенд-приложениям. Типичные случаи использования включают авторизацию доступа на основе атрибутов клиентского сертификата, таких как Common Name (CN) или Subject Alternative Name (SAN), что повышает безопасность на уровне приложения. Такой подход критичен для сервисов, которым необходимо надёжно удостоверять личность каждого клиента с использованием протоколов SSL/TLS.

Пример конфига

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /path/to/server.crt;
    ssl_certificate_key /path/to/server.key;

    ssl_client_certificate /path/to/ca.pem;
    ssl_verify_client on;

    location / {
        if ($ssl_client_cert) {
            add_header X-Client-Cert $ssl_client_cert;
        }
    }
}