~ / hub / erros / Erro de certificado SSL/TLS — guia compl
27 set 2026errosguia completo

Erro de certificado SSL/TLS — guia completo

Cert expirado, hostname mismatch, cadeia incompleta e como validar com openssl.

1. Mensagens típicas

  • NET::ERR_CERT_AUTHORITY_INVALID
  • certificate has expired
  • hostname does not match
  • unable to get local issuer certificate

2. Inspecionar o certificado

echo | openssl s_client -connect exemplo.com:443 -servername exemplo.com 2>/dev/null \
  | openssl x509 -noout -dates -subject -issuer -ext subjectAltName

curl -vI https://exemplo.com

3. Correções

  • Renovar Let's Encrypt (Certbot, Caddy automático)
  • Incluir SAN para www e apex
  • Instalar a cadeia completa (intermediate)
  • Sincronizar relógio do servidor (NTP)
ATENÇÃO curl -k ou “avançar mesmo assim” no browser não é solução em produção.

4. Como identificar a causa pelo sintoma

  • Expirado: a data notAfter na saída do openssl já passou. A renovação automática falhou ou nunca foi configurada.
  • Hostname não confere: o domínio acessado não está na lista subjectAltName. Confira www versus domínio sem www e subdomínios.
  • Autoridade desconhecida ou "unable to get local issuer": o servidor não está enviando a cadeia completa (certificado intermediário ausente) ou o cliente não confia na autoridade emissora.
  • Funciona no navegador, falha no curl ou na aplicação: costuma ser cadeia incompleta, que alguns navegadores conseguem completar e outros clientes não.
  • Data do dispositivo errada: um relógio fora de hora faz um certificado válido parecer expirado ou ainda não válido.

5. Verificar a cadeia enviada pelo servidor

echo | openssl s_client -connect exemplo.com:443 -servername exemplo.com -showcerts 2>/dev/null | grep -E 's:|i:'

A saída lista cada certificado enviado (s: sujeito, i: emissor). Se faltar o intermediário, instale o arquivo de cadeia completa (fullchain) no servidor web, em vez de apenas o certificado do domínio.

6. Depois de corrigir

Recarregue o serviço (Nginx, Caddy ou outro) para que o novo certificado seja lido, repita o comando da etapa 2 e confirme a nova data e o domínio. Se a renovação é automática, teste-a com um comando de simulação do cliente ACME que você usa. Para a configuração de proxy com HTTPS, veja Nginx como reverse proxy e Caddy; para o conceito, TLS e HTTPS; para testar com curl, comando curl.

← erros · curso TLS

Quer aplicar isso no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar diagnóstico →