Tutorial do Debian 13 / Verificar certificados HTTPS, renovação com Certbot e aplicação no Nginx

Para operar HTTPS no Debian 13, você precisa verificar não apenas a emissão do certificado, mas também o nome, a cadeia de confiança, a expiração e o certificado realmente fornecido pelo servidor web. Uma vez que um domínio público e um caminho de verificação externa estejam prontos, você pode configurar a emissão e a renovação com o Certbot, e em uma máquina virtual de laboratório sem essas condições, você pode aprender o mesmo fluxo de verificação com uma autoridade certificadora (CA, Certificate Authority) local de teste. A verificação de execução neste curso usa o último método, e ele é diferenciado para não confundir com a emissão bem-sucedida de um certificado público.

Separe a emissão pública do laboratório com CA local

HTTPS é um método de proteger a comunicação HTTP com TLS (Transport Layer Security, segurança da camada de transporte). Certificados contêm informações como a chave pública do servidor e o nome a ser usado, e são assinados por uma autoridade certificadora (CA). Os clientes verificam se há uma cadeia até uma CA confiável, se o nome da conexão corresponde ao certificado e se está dentro do período de validade.

ACME (Automatic Certificate Management Environment) é um protocolo para verificar o controle sobre domínios e automatizar a emissão e a renovação de certificados. Certbot é um cliente que usa isso. CAs criadas localmente não são confiáveis por navegadores da Internet por padrão e não substituem certificados de sites públicos.

Método Requisitos Escopo da verificação neste curso
Emissão pública do Certbot Domínio real controlável, DNS/acesso externo de acordo com o método de verificação Este é um procedimento de operação condicional que verifica documentos oficiais e opções instaladas. A emissão real não foi realizada.
CA de teste local VM Debian separada com acesso sudo, Nginx·OpenSSL·curl O teste original verificou confiança, nome, resposta HTTPS, reemissão local e recarga do Nginx.

O guia de tipos de desafio do Let’s Encrypt explica que o HTTP-01 exige acesso externo a um token através do domínio na porta 80. Abrir apenas a porta 8443 da VM ou alterar o arquivo local de hosts não satisfaz essa condição. O DNS-01 requer controle do registro TXT público do DNS; a renovação automatizada precisa de um plugin apropriado de DNS e permissões de API cuidadosamente definidas.

Inspecione as versões instaladas e o temporizador de renovação

Para prática, use a VM da aula anterior onde o Nginx está funcionando normalmente, e certifique-se de que a porta 8443 e o caminho dedicado abaixo estejam vazios. Em servidores com sites públicos existentes, faça backup seguro da configuração, certificados e chaves, e defina o escopo das alterações antes de prosseguir.

sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager

A VM do teste original utilizava OpenSSL 3.5.7, Certbot 4.0.0 e Nginx 1.26.3. No pacote Debian, certbot.timer adicionava um atraso aleatório aos dois horários de referência diários e estava configurado com Persistent=true. O certbot.service era um oneshot que executava renew. Se o método de instalação for diferente, o nome e a programação do timer também podem diferir, então verifique as configurações reais.

timer ativo significa que a programação está ativada. Isso não significa que um certificado existe ou que a renovação/implantação foi bem-sucedida. O resultado de certbot certificates nesta VM foi No certificates found, e os certificados locais subsequentes do OpenSSL não são automaticamente registrados como destinos gerenciados pelo Certbot.

Crie a CA local e o site completo de teste HTTPS

Execute o bloco completo apenas quando todos os caminhos de laboratório dedicados listados em sua condição estiverem ausentes. Coloque a chave da CA e a chave do servidor em caminhos acessíveis apenas pelo root, e mantenha apenas o certificado público da CA legível pelo cliente em um caminho público separado. Não o adicione ao sistema ou ao armazenamento de confiança do navegador. As chaves são geradas sem senha, mas são restritas com permissões de diretório 700 e permissões de arquivo 600; este método é apenas para prática local de curto prazo.

Execute privilégios de administrador explicitamente com sudo bash, e execute os comandos internos em um único shell root. Faça a CA válida por 3 dias e o primeiro certificado do servidor válido por 1 dia, incluindo lab26.test no SAN (Subject Alternative Name, nome alternativo do titular). Este nome é utilizado apenas para teste local.

sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
  if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
    listen 127.0.0.1:8443 ssl;
    server_name lab26.test;
    ssl_certificate /etc/nginx/lf-tls26/server.crt;
    ssl_certificate_key /etc/nginx/lf-tls26/server.key;
    default_type text/plain;
    return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT

Entre os arquivos gerados, ca.key e server.key são chaves privadas, e ca.crt e server.crt são certificados públicos. Não presuma que definir o nome comum (CN, Common Name) seja suficiente para a validação do nome; verifique também o SAN. As extensões do certificado do servidor especificam que ele não é uma CA e que se destina à autenticação do servidor. A configuração e as condições para acessar chaves privadas também são explicadas na documentação de configuração HTTPS do Nginx.

Após verificar a configuração e recarregar, faça solicitações como um usuário comum na VM Debian. Se uma conexão falhar imediatamente após o recarregamento, tente novamente após um curto período e verifique a saída de ss e os registros do serviço. A opção --resolve mapeia nomes para endereços apenas para esta solicitação sem alterar o DNS, e --cacert torna a CA de teste confiável apenas para esta solicitação.

curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

A resposta esperada é TLS LAB 26. Este sucesso é baseado na verificação sob condições de loopback, CA especificada e nome especificado, e não reflete resultados do DNS público ou verificações de confiança em navegadores comuns.

Distinga erros de confiança e de nome

Para a primeira solicitação abaixo, não especifique a CA de teste, e para a segunda solicitação, especifique a CA, mas conecte-se a um endereço IP que não esteja incluído no certificado. Espera-se que ambos os comandos falhem. Execute essa comparação em um shell comum e limpo sem o set -e ativado, e leia o código de saída imediatamente após cada solicitação; um shell com errexit poderia sair antes que o echo fosse executado.

curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"

Na verificação, ambos os casos retornaram um código de saída 60 do curl, mas o primeiro foi causado por um emissor não confiável e o segundo por uma incompatibilidade de nome. Não os agrupe apenas com base no número; leia a mensagem de erro também. O resultado que teve sucesso ao desativar a verificação com -k não pode ser usado para verificações de confiança de certificado.

Verifique a cadeia, o nome e a expiração do próprio arquivo da seguinte forma. O caminho do certificado do servidor está dentro do diretório apenas para root, portanto sudo é usado.

sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600

-checkend 3600 verifica se ele irá expirar nos próximos 3.600 segundos e retorna um status diferente de zero se a expiração estiver próxima. Isso sozinho não verifica a cadeia ou o nome. De acordo com descrição da opção x509 do OpenSSL, diferencie os propósitos para verificações de data, SAN e cadeia.

Compare o arquivo com o certificado servido pelo Nginx

Mesmo que você substitua o certificado do servidor, não é possível garantir que o Nginx em execução sirva o novo certificado. Primeiro, verifique o número de série do certificado fornecido em uma nova conexão. -servername passa o nome do servidor desejado através do SNI (Server Name Indication, indicação do nome do servidor) do TLS. Este comando é para observar o certificado, e a confiança real e a verificação do nome são feitas pelo curl e openssl verify anteriores.

openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256

Execute esta comparação de substituição uma vez no laboratório recém-preparado. Preserve o primeiro server-before.crt em vez de sobrescrevê-lo em tentativas repetidas. Esses certificados têm validade de apenas alguns dias; use um relógio do sistema correto e regenere o laboratório dedicado quando necessário.

O número de série inicial é 26 em hexadecimal. Em seguida, usando a mesma CA de teste e solicitação de assinatura de certificado (CSR, Certificate Signing Request), crie um novo certificado com período de validade de 2 dias e número de série 27 e, após a verificação ser concluída, substitua o nome do arquivo no mesmo diretório. Esta comparação é uma reemissão local onde a etapa de implantação é observada separadamente, não uma renovação ACME.

sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT

Imediatamente após concluir o bloco acima, o número de série do arquivo é 27, mas o certificado recebido em uma nova conexão ainda era 26. Esta é uma evidência de que o sucesso na gravação do arquivo e o sucesso na implantação são diferentes. O certificado funcional server-before.crt foi preservado nesta etapa.

O script abaixo recarrega o Nginx somente se a verificação de sua configuração for bem-sucedida. Nesta prática, foi confirmado durante a preparação que um arquivo com este nome ainda não existe. Ele não é usado para sobrescrever scripts existentes em servidores de produção.

sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

No teste original, após a recarga, o número de série da nova conexão mudou para 27 e a resposta HTTP foi normal. Os workers antigos podem demorar um pouco a encerrar; confira novamente em uma nova conexão após essa transição. Se a verificação da configuração falhar, o recarregamento não é realizado, e a correspondência de arquivos/chaves e o caminho/permissões são investigados. Ao restaurar este certificado de prática, copie o server-before.crt preservado para server.crt e execute a verificação, o recarregamento e a verificação da provisão do certificado na mesma ordem.

Use o Certbot após preparar um domínio público

Este procedimento se aplica apenas ao operar um domínio real. Separado do site local em 127.0.0.1:8443, os registros IPv4 A e quaisquer registros IPv6 AAAA publicados do domínio devem apontar para o servidor correto, e o acesso HTTP-01 na porta 80 deve estar disponível em todos os caminhos utilizados. Além disso, verifique endereços IPv6 incorretos, proxy, CDN, firewall e configurações de NAT. Verifique o acesso ao domínio a partir de outras redes e ajuste o server_name no site Nginx para corresponder ao domínio real.

Uma execução de teste (dry run) do Certbot ainda contata o serviço de pré-produção (staging) e pode temporariamente ajustar e recarregar o servidor web. Faça backup da configuração do site relevante primeiro. Se nginx -t ou a validação de staging falhar, pare e corrija antes de tentar a emissão para produção; os seguintes comandos não são um lote para executar após um erro.

Abaixo está um comando condicional aplicado a um site Nginx já preparado. Insira o domínio que você controla e um e-mail de contato, e primeiro faça backup das configurações no servidor real. --dry-run tenta uma verificação de staging, portanto não precisa ser executado em uma VM sem condições externas.

read -r -p "Real domain you control: " domain
read -r -p "Certificate contact email: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos

Certificados de pré-produção não são confiáveis para clientes comuns. Siga as instruções de staging do Let's Encrypt e corrija os erros de validação antes de emitir em produção. Mesmo que --dry-run tenha sucesso, ele não salva um certificado de produção. O comando a seguir solicita um certificado de produção e modifica a configuração do Nginx; examine as alterações.

sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"

Confira o nome do certificado e o caminho no diretório live a partir da saída de certbot certificates. O Nginx deve estar vinculado ao fullchain.pem contendo o certificado do servidor e os certificados intermediários necessários, juntamente com o privkey.pem correspondente. Não termine a verificação apenas confirmando que os arquivos existem; verifique a resposta HTTPS externa e confirme o nome, o emissor e a validade do certificado fornecido.

A verificação de renovação operacional é realizada com sudo certbot renew --dry-run. A ajuda da versão 4.0.0 instalada no teste original indica que os deploy hooks não são executados no dry-run padrão e que --run-deploy-hooks deve ser adicionado. Se você configurou seus próprios deploy hooks além da reaplicação realizada pelo plugin Nginx, revise os alvos e o recarregamento duplicado, e testes incluindo hooks devem ser realizados dentro do escopo de manutenção.

certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager

O resultado de terminar sem qualquer ação porque não há nada a renovar não é evidência de uma renovação bem-sucedida. Primeiro, verifique se há certificados realmente sendo gerenciados e registre separadamente os resultados da renovação, os resultados da implantação e os certificados de novas conexões nos horários necessários. Para o significado de plugins e hooks, consulte o Guia Oficial de Uso do Certbot, mas priorize verificar a ajuda da versão instalada e a configuração real.

Remova apenas o laboratório TLS local

Os leitores que configuraram as configurações públicas do Certbot não devem aplicar esta seção de limpeza em sites públicos. O bloco abaixo remove o link para lf-tls26 criado anteriormente, depois verifica e recarrega, e só exclui a chave, o certificado e a pasta dedicados se o listener 8443 tiver desaparecido. Como o repositório de confiança não foi alterado, não há necessidade de remover o CA do sistema também.

sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT

Na VM do teste original, sites HTTPS dedicados, chaves, CAs e scripts de implantação foram removidos, e o hash da configuração padrão original do Nginx foi mantido. O pacote Certbot e os temporizadores ativos permaneceram, mas não havia certificados gerenciados. Este estado não é considerado o mesmo que a operação de renovação automática de certificados públicos.