# 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.

> 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.

João Rizzon · 2026-11-01 · Servidores

---

## 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:

```bash
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:

```bash
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.

```apache
# 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 5` limita quanto tempo o servidor espera a CA. Sem teto curto, uma CA lenta vira atraso no handshake, exatamente o que se queria evitar.
- `SSLStaplingReturnResponderErrors off` faz 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:

```bash
apachectl configtest && systemctl reload httpd
```

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

```nginx
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 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.
- 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.
- 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](https://docs.litespeedtech.com/shared/lsws/ocsp-after/); 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.

```bash
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 `curl` novo, então já é um handshake novo. O `--no-keepalive` só 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 `curl` do 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. O `s_client -status` continua 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_uri` vazio. 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, e `must-staple` está 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 `SSLStaplingResponderTimeout` em 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.

