blog
Servidores

Quando ativar OCSP stapling e quando ele não muda nada

Como conferir o estado atual com openssl s_client -status, ligar a diretiva no Apache, NGINX, LiteSpeed e WHM, e reconhecer os cinco cenários em que o stapling falha em silêncio.

JR · · 7 min de leitura · 1 tabela · 8 blocos de código

Resposta curta: sim, quando o certificado ainda tem respondedor OCSP. Sem stapling, o cliente abre DNS + TCP + TLS + HTTP extras à CA antes de confiar no certificado. Com `openssl x509 -noout -ocsp_uri` vazio, não há nada a recuperar e o ajuste é inútil.

Neste artigo
  1. O que sobra para cortar no handshake depois de TLS 1.3 e ECDSA
  2. Descobrir se o stapling já está ligado, falhando ou impossível
  3. Apache httpd: as três diretivas e por que o cache é obrigatório
  4. NGINX: a raiz no ssl_trusted_certificate, o resolver e o primeiro handshake sem grampo
  5. LiteSpeed e cPanel/WHM, onde a configuração não é arquivo de texto
  6. Comparar time_appconnect antes e depois sem que a medição minta
  7. Cinco sintomas de stapling quebrado e a verificação de cada um
  8. Como reverter em um reload e quando não ativar

O que sobra para cortar no handshake depois de TLS 1.3 e ECDSA

Trocar TLS 1.2 por 1.3 encurta uma viagem de ida e volta no handshake. Trocar RSA por ECDSA encurta a assinatura. Depois disso, a negociação criptográfica em si já não tem gordura relevante para cortar no servidor.

O que sobra é a validação de revogação. Sem OCSP stapling, o cliente que recebe sua cadeia precisa decidir se aquele certificado foi revogado. Para isso ele abre uma conexão independente ao respondedor OCSP da CA: resolve o nome do respondedor, abre TCP, negocia TLS (quando o respondedor é HTTPS) e faz um POST ou GET HTTP. Tudo isso acontece antes de a página começar a carregar, e nada disso aparece no seu servidor, no seu log ou no seu APM.

Com stapling, o servidor busca essa resposta da CA periodicamente, guarda em cache e a entrega grampeada dentro do próprio handshake, na extensão status_request. O cliente valida a assinatura da CA sobre a resposta e segue. Zero conexão extra.

O ganho não é um número fixo: depende de onde está o cliente, de onde está o respondedor da CA e da política de revogação do navegador (vários navegadores desktop já ignoram OCSP para certificados de servidor). Mas o custo de ativar é baixo e o diagnóstico é direto.

Validacao de revogacao com e sem staplingSem grampoCliente resolve o respondedor da CAConexao extraTCP e TLS ate o respondedorCom grampoServidor busca e guarda em cacheHandshake unicoResposta vai em status_request
Onde a conexao extra desaparece quando o servidor grampeia a resposta OCSP.

Descobrir se o stapling já está ligado, falhando ou impossível

O teste canônico é o -status do openssl s_client, que envia a extensão status_request e imprime o que voltou:

openssl s_client -connect exemplo.com.br:443 -servername exemplo.com.br -status < /dev/null 2>/dev/null | head -40

Duas saídas possíveis logo no início:

OCSP response: no response sent

ou

OCSP Response Status: successful (0x0)
Cert Status: good
This Update: ...
Next Update: ...

Se aparecer no response sent, o stapling está desligado, ou ligado e falhando. As duas situações são indistinguíveis por aqui: a diferença está no log do servidor.

Antes de culpar a configuração, confira se o certificado sequer aponta para um respondedor:

openssl x509 -in /caminho/cert.pem -noout -ocsp_uri

Saída vazia significa que não há URI OCSP na extensão AIA. Não existe stapling a fazer. Esse caso ficou comum: CAs vêm retirando o respondedor OCSP da extensão AIA e passando a depender só de CRL. Não cabe datar aqui o movimento de nenhuma CA específica, porque o que vale operacionalmente é o certificado que está instalado: sem -ocsp_uri, não há stapling possível, e esse é o critério objetivo para fechar o chamado.

Arvore de diagnostico do staplingopenssl x509 -ocsp_uriVazio: nao ha stapling possivels_client -statusRode duas vezes apos o reloadno response sent sempreVer log: verify ou timeoutErro de verificacaoRaiz ausente no arquivo confiavelTimeoutEgress bloqueado, teste do servidorCert Status: goodConferir This Update e Next Update
Ordem de diagnostico: primeiro o certificado, depois o grampo, depois o log.

Apache httpd: as três diretivas e por que o cache é obrigatório

As diretivas ficam no contexto global ou no vhost 443. O cache é obrigatório: sem ele o Apache não faz stapling.

# contexto global (fora dos vhosts)
SSLStaplingCache shmcb:/var/run/ocsp(128000)

# dentro do <VirtualHost *:443>
SSLUseStapling on
SSLStaplingResponderTimeout 5
SSLStaplingReturnResponderErrors off

Por que cada uma:

Valide a sintaxe e recarregue:

apachectl configtest && systemctl reload httpd

NGINX: a raiz no ssl_trusted_certificate, o resolver e o primeiro handshake sem grampo

server {
    listen 443 ssl;
    ssl_certificate         /etc/ssl/exemplo/fullchain.pem;
    ssl_certificate_key     /etc/ssl/exemplo/privkey.pem;

    ssl_stapling            on;
    ssl_stapling_verify     on;
    ssl_trusted_certificate /etc/ssl/exemplo/chain.pem;

    resolver 127.0.0.1 valid=300s ipv6=off;
    resolver_timeout 5s;
}

Três armadilhas específicas do NGINX:

  1. ssl_stapling_verify on exige que o NGINX consiga montar a cadeia até a raiz para verificar a assinatura da resposta OCSP. O ssl_trusted_certificate precisa conter a intermediária e a raiz. Usar o fullchain.pem aqui é o erro clássico: ele tem a folha e a intermediária, sem a raiz, e o verify falha em silêncio.
  2. Sem resolver, o NGINX não resolve o hostname do respondedor em tempo de execução e o stapling nunca sai do lugar. O valid= define por quanto tempo a resposta de DNS é reusada; sem ele, o NGINX respeita o TTL, o que costuma estar certo, mas um valid=300s protege contra TTLs absurdamente baixos.
  3. O NGINX só busca a resposta OCSP depois do primeiro handshake que a pede. A primeira conexão após o reload sai sem grampo.

Recarregue com nginx -t && systemctl reload nginx e repita o s_client -status duas vezes: a segunda é a que vale.

LiteSpeed e cPanel/WHM, onde a configuração não é arquivo de texto

No LiteSpeed Web Server o stapling é controlado pelo painel de administração, junto das demais opções de SSL, e não por arquivo de texto editado à mão. A documentação oficial do produto descreve a ativação e o comportamento do cache de respostas em OCSP Stapling; siga a página da versão que você roda, porque não tenho fonte para garantir o nome exato de cada campo nas demais. Independentemente do rótulo que o painel usar, a validação é a mesma dos outros servidores: aplicar, reiniciar o listener e rodar o s_client -status duas vezes, porque a primeira conexão depois do restart ainda pega o cache frio.

Em servidor cPanel/WHM com Apache, procure a opção de OCSP stapling pela busca da própria interface do WHM, porque a seção e o rótulo mudam entre versões e eu não tenho como garantir um caminho fixo aqui. Mexer direto no .conf do vhost não sobrevive à próxima reconstrução da configuração pelo httpd.conf gerado. Se precisar de algo que a interface não expõe, use include de usuário em vez de editar o arquivo gerado.

Comparar time_appconnect antes e depois sem que a medição minta

O curl separa o tempo de conexão TCP do tempo de handshake TLS. A diferença entre time_appconnect e time_connect é, na prática, o custo do handshake, e é onde a conexão à CA aparece quando não há grampo.

for i in $(seq 1 20); do
  curl -so /dev/null --no-keepalive \
    -w '%{time_connect} %{time_appconnect}\n' \
    https://exemplo.com.br/
done

Regras para a comparação não mentir:

Cinco sintomas de stapling quebrado e a verificação de cada um

Sintoma Causa provável Verificação
no response sent só na primeira conexão após reload cache frio, o servidor ainda não buscou a resposta repetir o s_client -status
no response sent sempre, log diz erro de verificação ssl_trusted_certificate sem a raiz openssl verify -CAfile /etc/ssl/exemplo/chain.pem /etc/ssl/exemplo/cert.pem usando como -CAfile exatamente o arquivo apontado em ssl_trusted_certificate: se ele só tiver a intermediária, sai unable to get issuer certificate. Confirme o conteúdo com openssl crl2pkcs7 -nocrl -certfile chain.pem \ openssl pkcs7 -print_certs -noout`, que deve listar intermediária e raiz
no response sent sempre, log diz timeout egress 80/443 bloqueado para a CA curl -sv $(openssl x509 -in cert.pem -noout -ocsp_uri) a partir do servidor
Grampo presente, Next Update no passado respondedor fora do ar, cache servindo resposta velha conferir This Update/Next Update na saída
Certificado sem -ocsp_uri CA não publica OCSP nada a configurar

O egress bloqueado é a causa silenciosa mais frequente em VPS endurecido. Regra de saída restritiva, servidor funcionando normalmente, stapling ligado e nenhum grampo sendo entregue, porque o processo não alcança o respondedor. Teste sempre a partir do servidor, nunca da sua máquina.

Resposta expirada é o oposto do ganho: cliente estrito pode rejeitar um grampo com Next Update vencido. Se a CA do seu certificado tem histórico de instabilidade no respondedor, monitore o Next Update como você monitora a validade do certificado.

Como reverter em um reload e quando não ativar

A reversão é imediata e sem risco de indisponibilidade. No Apache, SSLUseStapling off e reload. No NGINX, ssl_stapling off e reload. No WHM, desmarcar a opção de OCSP stapling e reconstruir a configuração do Apache. O certificado continua válido, o handshake continua funcionando, o cliente volta a buscar a revogação por conta própria.

Quando não vale o esforço:

Fora desses casos, ativar é barato, reversível em um reload e verificável com um comando. Ligue, confira com s_client -status duas vezes, e registre o par de medianas do curl antes e depois para ter o número da sua própria infraestrutura, não o de um artigo.

Referências

  1. Documentação oficial (litespeed) — OCSP Stapling. Consultado em 2026-09-16.
Leia também