Nginx ssl_stapling: включить OCSP stapling

Категория: Nginx · Обновлено:

OCSP stapling позволяет Nginx прикладывать к TLS-ответу подписанное подтверждение статуса сертификата. Клиент не ходит к OCSP-серверу CA, а получает ответ вместе с рукопожатием. Это ускоряет соединение и снижает зависимость от доступности OCSP, но требует корректной цепочки и DNS-резолвера.

Включить stapling на TLS-сервере

Текст
server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/ssl/example.com/fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com/privkey.pem;
    ssl_trusted_certificate /etc/ssl/example.com/chain.pem;

    ssl_stapling on;
    ssl_stapling_verify on;

    resolver 1.1.1.1 8.8.8.8 valid=300s;
    resolver_timeout 5s;
}

ssl_stapling on включает загрузку OCSP-ответа, ssl_stapling_verify on требует, чтобы ответ был подписан и проверен по цепочке. ssl_trusted_certificate задаёт доверенную цепочку для проверки; обычно это intermediate-сертификаты CA. Без корректной цепочки Nginx пишет ssl_stapling ignored и не прикладывает ответ.

Nginx не использует системный resolver для OCSP: нужен явный resolver. Если DNS недоступен, stapling не обновится; задайте несколько резолверов и таймаут. valid=300s ограничивает кеширование DNS-ответа. Для тестовых/внутренних CA с собственным OCSP-сервером можно указать ssl_stapling_responder, но не делайте это без необходимости.

Проверьте результат командой openssl s_client -connect example.com:443 -status -servername example.com. В выводе должен быть OCSP Response Status: successful и Cert Status: good. Если OCSP URL в сертификате отсутствует, stapling не заработает независимо от конфигурации.

Не все CA поддерживают OCSP; некоторые переходят на CRL. Если ваш CA не предоставляет OCSP, оставьте ssl_stapling off, чтобы не тратить ресурсы и не получать предупреждения. Не отключайте проверку сертификата клиента ради stapling и не кешируйте OCSP-ответы вручную.

Документация: ngx_http_ssl_module: ssl_stapling, OCSP stapling.