$ssl_client_i_dn_legacy
Переменная $ssl_client_i_dn_legacy возвращает устаревшее строковое представление имени субъекта (DN) клиентского SSL-сертификата. — NGINX Core (HTTP)
Описание
Переменная $ssl_client_i_dn_legacy устанавливается при обработке клиентских запросов на сервере NGINX, настроенном для использования SSL/TLS с аутентификацией клиента. Когда клиент предъявляет SSL-сертификат во время рукопожатия, сервер обрабатывает этот сертификат и извлекает различные сведения, включая имя субъекта (DN) клиента. DN включает атрибуты, такие как общее имя (CN), организация (O) и страна (C). В случае $ssl_client_i_dn_legacy переменная возвращает этот DN в формате, совместимом с более ранними версиями NGINX, и предназначена главным образом для обратной совместимости. Формат этой строковой записи DN может различаться в зависимости от способа выдачи клиентского сертификата и конкретных данных сертификата.
Пример конфига
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /path/to/your/cert.pem;
ssl_certificate_key /path/to/your/key.pem;
ssl_client_certificate /path/to/your/ca.pem;
ssl_verify_client on;
location / {
add_header X-Client-DN $ssl_client_i_dn_legacy;
}
}Подсистема
httpКэшируется
ДаКонтексты
http, server, location, if$ssl_client_i_dn_legacy доступен только при включенной проверке клиента (ssl_verify_client on).
Формат строки DN может отличаться в зависимости от данных сертификата клиента, что может привести к проблемам при обработке, если это не учесть.
Неправильно настроенные SSL-настройки могут привести к тому, что переменная будет пустой или неопределённой.