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.

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
- O que sobra para cortar no handshake depois de TLS 1.3 e ECDSA
- Descobrir se o stapling já está ligado, falhando ou impossível
- Apache httpd: as três diretivas e por que o cache é obrigatório
- NGINX: a raiz no ssl_trusted_certificate, o resolver e o primeiro handshake sem grampo
- LiteSpeed e cPanel/WHM, onde a configuração não é arquivo de texto
- Comparar time_appconnect antes e depois sem que a medição minta
- Cinco sintomas de stapling quebrado e a verificação de cada um
- 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.
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.
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:
SSLStaplingCache shmcb:memória compartilhada entre os workers. Se ficar fora, o Apache registra erro e o stapling não acontece.SSLStaplingResponderTimeout 5limita quanto tempo o servidor espera a CA. Sem teto curto, uma CA lenta vira atraso no handshake, exatamente o que se queria evitar.SSLStaplingReturnResponderErrors offfaz o servidor omitir a resposta quando o respondedor devolve erro, em vez de grampear um erro e induzir o cliente a tratar como problema.
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:
ssl_stapling_verify onexige que o NGINX consiga montar a cadeia até a raiz para verificar a assinatura da resposta OCSP. Ossl_trusted_certificateprecisa conter a intermediária e a raiz. Usar ofullchain.pemaqui é o erro clássico: ele tem a folha e a intermediária, sem a raiz, e o verify falha em silêncio.- Sem
resolver, o NGINX não resolve o hostname do respondedor em tempo de execução e o stapling nunca sai do lugar. Ovalid=define por quanto tempo a resposta de DNS é reusada; sem ele, o NGINX respeita o TTL, o que costuma estar certo, mas umvalid=300sprotege contra TTLs absurdamente baixos. - 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:
- Mesma URL, mesma origem de rede, mesma hora do dia. Mudar qualquer uma invalida o par.
- Cada iteração do loop é um processo
curlnovo, então já é um handshake novo. O--no-keepalivesó desliga o keepalive TCP no socket, não tem efeito sobre reuso de conexão entre processos distintos; se você trocar o loop por uma única invocação com várias URLs, aí sim precisa de-H 'Connection: close'ou de URLs em hosts diferentes para não reusar a mesma conexão. - Descarte a primeira amostra depois de um reload: ela carrega o cache frio.
- Compare medianas, não a melhor amostra.
- O cliente
curldo teste não consulta OCSP por padrão em muitas distribuições. Se o seu não consulta, o delta medido será pequeno ou nulo mesmo com o stapling desligado. Isso mede o seu cliente, não o seu servidor. Os_client -statuscontinua sendo a prova de que o grampo está indo.
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:
openssl x509 -noout -ocsp_urivazio. Sem respondedor, não há resposta a grampear. É o caso de certificados emitidos por CAs que migraram para distribuição por CRL. O caminho aqui é confiar na distribuição de CRL do cliente, emust-stapleestá fora de questão: um certificado com a extensão must-staple emitido por CA sem OCSP vira um site que não abre.- Audiência majoritariamente de navegadores desktop que já ignoram OCSP para certificados de servidor. O ganho de tempo tende a zero, embora o custo de manter ligado também seja próximo de zero.
- Servidor sem rota de saída e sem como abrir uma. Stapling ligado sem alcançar a CA não é neutro: você gasta o
SSLStaplingResponderTimeoutem tentativas.
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
- Documentação oficial (litespeed) — OCSP Stapling. Consultado em 2026-09-16.