Tutorial do Rocky Linux 10 / HTTPS no Rocky Linux 10: certificados ACME, renovação e monitoramento
Para operar HTTPS no Rocky Linux 10, você precisa não apenas emitir certificados, mas também aplicá-los ao servidor web, executar a renovação automática e monitorar os certificados realmente servidos e sua expiração. Este tutorial reproduz a emissão e renovação reais via ACME utilizando uma autoridade certificadora de teste separada, distinguindo DNS, portas e condições de confiança necessárias ao aplicar a serviços públicos.
Diferença entre certificados públicos e certificados de teste locais
O HTTPS protege a comunicação HTTP usando TLS (Transport Layer Security). Autoridades Certificadoras (CAs) assinam certificados vinculando o nome do site e a chave pública, e os clientes verificam o nome, o período de validade e a cadeia de emissão. ACME (Automated Certificate Management Environment) é um protocolo que automatiza a validação de controle de domínio, emissão e renovação, e o Certbot é um cliente que realiza essas ações.
Como explicado na documentação dos desafios da Let’s Encrypt, a validação pública HTTP-01 solicita o arquivo de autenticação na porta 80. Os registros A·AAAA usados pelo domínio, firewalls externos e redirecionamento de portas, assim como o caminho real do servidor web, devem estar todos corretos. Simplesmente alterar seu próprio arquivo de hosts ou mudar a porta de escuta do Certbot para outro número não altera as condições de conexão da autoridade certificadora pública. O DNS-01 valida através de registros TXT do DNS e requer o método de automação do provedor de DNS para renovação automática.
| Ambiente | Escopo e confiança da validação |
|---|---|
| Esta prática do Pebble | Dentro da VM, o laboratório de origem verificou o nome de teste e o desafio HTTP-01. É uma CA de teste privada e não é geralmente confiável pelos navegadores. |
| Let’s Encrypt de teste | Emitido para testes com DNS público e condições de acesso. Certificados de teste não são certificados geralmente confiáveis. |
| Autoridade de Certificação de Produção | Emitido para atender a requisitos reais de domínio público e de política. Confiança do cliente, nomes, cadeias e acesso externo são verificados separadamente. |
Guia de Testes do Let’s Encrypt recomenda testar antes da emissão em produção e apresenta o Pebble como um servidor ACME local para desenvolvimento. Este exercício não reflete resultados verificados usando emissão em ambiente de testes ou produção com um domínio público.
Preparando Ferramentas e Ambiente de Teste ACME Local
Prossiga em uma máquina virtual separada com Rocky Linux 10. O ambiente de laboratório original era Rocky Linux 10.2, Python 3.12.15, Certbot 5.10.0, Pebble 2.10.3, Nginx 1.26.3, OpenSSL 3.5.8, SELinux em Modo Enforcing. O arquivo de distribuição do Pebble abaixo é para x86_64. Para outras arquiteturas de CPU, selecione a distribuição oficial correspondente e o checksum. Não execute como está em servidores que tenham sites existentes, certificados ou arquivos de prática com os mesmos nomes.
O pacote EPEL Certbot neste ambiente não foi instalado porque algumas dependências não correspondem ao repositório Rocky 10.2. Sem substituir forçosamente os pacotes do sistema, o Certbot foi instalado em um ambiente virtual Python dedicado. Na documentação de instalação do Certbot você pode ver que o método pip é um método de suporte limitado que utiliza um ambiente virtual. Em produção, métodos de instalação e responsabilidades de atualização são determinados em conjunto, e diferentes instalações do Certbot não são misturadas.
sudo dnf install python3 tar openssl nginx policycoreutils-python-utils
sudo ss -lntp
sudo bash <<'ROOT'
set -euo pipefail
test ! -e /root/lf-course26
test ! -e /usr/local/bin/lf-course26-pebble
for path in /etc/pki/tls/lf-course26 /etc/nginx/conf.d/lf-course26.conf /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer; do
test ! -e "$path"
done
for port in 14000 15000 5001 5002 18426; do
listeners=$(ss -H -lnt "sport = :$port")
test -z "$listeners"
done
if grep -Eq '(^|[[:space:]])course26[.]test([[:space:]]|$)' /etc/hosts; then
printf 'The test hostname already exists in hosts. Stop.\n' >&2
exit 1
fi
install -d -m 0700 /root/lf-course26
cp -a /etc/hosts /root/lf-course26/hosts.before
cp -a /etc/nginx /root/lf-course26/nginx.before
python3 -m venv /root/lf-course26/venv
/root/lf-course26/venv/bin/python -m pip install 'certbot==5.10.0'
cd /root/lf-course26
curl -fL -o pebble.tar.gz https://github.com/letsencrypt/pebble/releases/download/v2.10.3/pebble-linux-amd64.tar.gz
printf '7e33cf3e426b67e9e647c44e8cc91683caa8ab331f7a99e5e27fcee291c4c7e2 pebble.tar.gz\n' | sha256sum -c -
tar -xzf pebble.tar.gz --strip-components=3
install -m 0755 pebble /usr/local/bin/lf-course26-pebble
restorecon /usr/local/bin/lf-course26-pebble
openssl req -x509 -newkey rsa:2048 -noenc -keyout api.key -out api.pem -days 2 -subj /CN=localhost -addext 'subjectAltName=DNS:localhost,IP:127.0.0.1'
chmod 0600 api.key
printf '\n127.0.0.1 course26.test # lf-course26\n' >> /etc/hosts
ROOT
Antes da execução, certifique-se de que os números 14000, 15000, 5002 e 18426 não estão em uso e de que o course26.test não esteja nas entradas de hosts existentes. O sudo bash interno é executado com privilégios de administrador e, se ocorrer um erro, os comandos subsequentes são interrompidos. O valor SHA-256 esperado do arquivo de distribuição deve ser comparado com as informações de lançamento da versão oficial. Não execute se o hash for diferente.
Abra o arquivo com sudoedit /root/lf-course26/pebble.json e salve o conteúdo a seguir. O certificado de acesso da API api.pem e os certificados emitidos para sites subsequentes são diferentes entre si. Ambas as APIs recebem conexões apenas no endereço de loopback e não modificam o armazenamento de CA do sistema.
{
"pebble": {
"listenAddress": "127.0.0.1:14000",
"managementListenAddress": "127.0.0.1:15000",
"certificate": "/root/lf-course26/api.pem",
"privateKey": "/root/lf-course26/api.key",
"httpPort": 5002,
"tlsPort": 5001,
"keyAlgorithm": "ecdsa",
"profiles": {
"default": {
"description": "Local course26 test",
"validityPeriod": 7776000
}
}
}
}
sudo systemd-run --unit=lf-course26-pebble --property=WorkingDirectory=/root/lf-course26 --setenv=PEBBLE_VA_NOSLEEP=1 --setenv=PEBBLE_AUTHZREUSE=0 /usr/local/bin/lf-course26-pebble -config /root/lf-course26/pebble.json
sudo curl --retry 3 --retry-connrefused --cacert /root/lf-course26/api.pem -fsS https://localhost:14000/dir
sudo curl --cacert /root/lf-course26/api.pem -fsS https://localhost:15000/roots/0 -o /root/lf-course26/issuer-root.pem
A primeira consulta retorna um JSON contendo o caminho ACME, e a segunda salva o certificado raiz da cadeia de emissão de teste. PEBBLE_VA_NOSLEEP=1 apenas remove atrasos artificiais, e PEBBLE_AUTHZREUSE=0 desativa a reutilização de resultados de autorização anteriores para observar a verificação repetida. Não use modos que sempre tratam a verificação como bem-sucedida. O estado da autoridade certificadora do Pebble é armazenado na memória durante a execução, portanto, não presuma que os estados anteriores de raiz, conta ou emissão sejam mantidos após uma reinicialização. Se reiniciado, verifique novamente a emissão e os relacionamentos de confiança do novo ambiente de teste. Para configurações detalhadas, consulte Pebble 2.10.3 README oficial .
A primeira tentativa de colocar o binário a ser executado pelo systemd em /root falhou devido à negação de permissão na fase de execução. Após colocá-lo no caminho de execução padrão /usr/local/bin e restaurar o contexto, ele rodou normalmente. Quando 203/EXEC aparecer, verifique journalctl -u lf-course26-pebble junto com o caminho do arquivo, permissões e contexto do SELinux, e não resolva isso desativando recursos de segurança.
Emitindo um certificado de teste via validação HTTP-01
sudo env REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem /root/lf-course26/venv/bin/certbot certonly --standalone --http-01-address 127.0.0.1 --http-01-port 5002 --preferred-challenges http --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --register-unsafely-without-email --agree-tos --non-interactive -d course26.test
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial -dates -issuer -ext subjectAltName
sudo journalctl -u lf-course26-pebble -n 25 --no-pager
Este comando cria uma conta apenas no servidor de teste local, e um servidor temporário standalone fornece o arquivo de autenticação na porta 5002. A opção de omitir o e-mail é limitada a este teste privado. REQUESTS_CA_BUNDLE é usado apenas para a confiança TLS da API dessa execução. Não há necessidade de uma opção para pular a verificação TLS.
Nos registros de origem, consta que houve três verificações usando http://course26.test:5002/.well-known/acme-challenge/... e que a autenticação foi concluída, e o certificado foi emitido. Esta porta 5002 é a porta de teste configurada no Pebble. Esta porta local personalizada não implica que uma CA pública HTTP-01 validará em uma porta arbitrária.
cert.pem é o certificado do site, chain.pem é o certificado intermediário, fullchain.pem é a cadeia do certificado do site e intermediário, e privkey.pem é a chave privada. Os arquivos dentro de live são links simbólicos para arquivos versionados em archive. Chaves privadas e chaves de conta não devem ser colocadas no caminho de documentos da web ou em backups públicos. Esta configuração define o período de validade de teste como 90 dias, mas não assuma um período de validade uniforme para certificados de produção; verifique o notAfter real.
Aplicando ao Nginx e verificando o nome e a cadeia
O site de teste é fornecido apenas a partir de 127.0.0.1:18426. Os certificados são implantados em um caminho TLS dedicado que o Nginx irá ler, sem expor diretamente o caminho de armazenamento do Certbot. Primeiro, verifique se o novo caminho e porta não estão sendo usados na configuração existente.
sudo install -d -m 0700 /etc/pki/tls/lf-course26
sudo install -m 0644 /root/lf-course26/config/live/course26/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
sudo install -m 0600 /root/lf-course26/config/live/course26/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
sudo restorecon -Rv /etc/pki/tls/lf-course26
sudo semanage port -a -t http_port_t -p tcp 18426
Abra o arquivo com sudoedit /etc/nginx/conf.d/lf-course26.conf e salve o bloco de servidor completo. Mantenha a configuração do site padrão na porta 80.
server {
listen 127.0.0.1:18426 ssl;
server_name course26.test;
ssl_certificate /etc/pki/tls/lf-course26/fullchain.pem;
ssl_certificate_key /etc/pki/tls/lf-course26/privkey.pem;
location / {
default_type text/plain;
return 200 "LF26 HTTPS works\n";
}
}
sudo nginx -t && sudo systemctl start nginx
sudo curl --cacert /root/lf-course26/issuer-root.pem --resolve course26.test:18426:127.0.0.1 -sS -w 'HTTP %{http_code}\n' https://course26.test:18426/
Se o Nginx já estiver em execução, aplique as novas configurações com sudo systemctl reload nginx em vez de start. Este exercício foi verificado no caso iniciado a partir de um estado parado. LF26 HTTPS works e 200 são os resultados esperados. --resolve especifica apenas o endereço de acesso para esta solicitação, mantendo o nome da URL e o TLS SNI (Indicação de Nome do Servidor). --cacert especifica apenas a CA de teste para este laboratório e não altera as configurações de confiança de um navegador comum.
Em comparação real, o curl sem especificar a raiz de teste falhou com o código de saída 60 porque não pôde confiar na cadeia de emissão. Mesmo se a raiz de teste for especificada, alterar o nome da URL para wrong26.test resulta no mesmo código de saída 60 devido à incompatibilidade de nomes do certificado. Não distinga a causa apenas pelo código de saída; verifique também a mensagem de erro. Verifique tanto a negociação TLS bem-sucedida quanto a identidade do servidor apresentada ao cliente. Este teste não configura autenticação de cliente TLS mútua.
Verificação real de renovação e hooks de implantação
Mesmo que o Certbot salve um novo arquivo de certificado, o certificado do Nginx copiado para um caminho separado não é alterado automaticamente. O hook de implantação, executado após a renovação bem-sucedida, lida com a cópia, restauração do contexto, verificação de configuração e recarregamento. Abra o arquivo com sudoedit /usr/local/sbin/lf-course26-deploy e salve o conteúdo a seguir. Este hook é limitado ao nome do teste e ao caminho de armazenamento para este laboratório.
#!/bin/bash
set -euo pipefail
test "${RENEWED_LINEAGE:-}" = /root/lf-course26/config/live/course26
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -checkend 0
openssl verify -CAfile /root/lf-course26/issuer-root.pem -untrusted "$RENEWED_LINEAGE/chain.pem" -verify_hostname course26.test "$RENEWED_LINEAGE/cert.pem"
BACKUP=$(mktemp -d /root/lf-course26/deploy-backup.XXXXXXXX)
cp -a /etc/pki/tls/lf-course26/fullchain.pem /etc/pki/tls/lf-course26/privkey.pem "$BACKUP/"
install -m 0644 "$RENEWED_LINEAGE/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$RENEWED_LINEAGE/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
restorecon -R /etc/pki/tls/lf-course26
if ! nginx -t || ! systemctl reload nginx; then
install -m 0644 "$BACKUP/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$BACKUP/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
nginx -t && systemctl reload nginx
exit 1
fi
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -serial >> /root/lf-course26/deploy-serials.log
Antes de aplicar, verifique a cadeia, o nome e a data de expiração, e armazene os arquivos de implantação existentes em um local protegido. Se a verificação da configuração ou o recarregamento falharem, reverta os arquivos da implantação anterior e saia com um erro. Se a restauração também falhar, você deve verificar os logs do serviço e a resposta real, e isso não será considerado uma recuperação automática bem-sucedida. Desta vez, o caminho onde o certificado normal foi implantado foi executado para verificação, e este ramo de recuperação de falha não foi reproduzido deliberadamente.
Abra o arquivo com sudoedit /usr/local/sbin/lf-course26-renew e salve o conteúdo a seguir. Execute o script de console Certbot com Python no ambiente virtual.
#!/bin/bash
set -euo pipefail
export REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem
exec /root/lf-course26/venv/bin/python /root/lf-course26/venv/bin/certbot renew --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --non-interactive --no-random-sleep-on-renew --deploy-hook /usr/local/sbin/lf-course26-deploy "$@"
sudo chmod 0750 /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo restorecon /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo /usr/local/sbin/lf-course26-renew --force-renewal
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial
sudo bash -o pipefail <<'BASH'
openssl s_client -connect 127.0.0.1:18426 -servername course26.test -verify_hostname course26.test -CAfile /root/lf-course26/issuer-root.pem -verify_return_error </dev/null | openssl x509 -noout -serial
BASH
--force-renewal é uma opção para observar a renovação neste teste local. A renovação forçada não é aplicada ao temporizador de produção. O número de série inicial era 4DFCA979CEB14834, e o número salvo e fornecido após a renovação real foi 4E9CBB509103CA00. Na primeira conexão imediatamente após o comando de recarregamento, o certificado anterior foi observado brevemente, e após reconectar, foi confirmada a correspondência entre o número salvo e o número fornecido. Não julgue que a aplicação do serviço foi concluída apenas verificando a conclusão do comando.
sudo bash <<'ROOT'
set -euo pipefail
sha256sum /root/lf-course26/config/live/course26/cert.pem > /root/lf-course26/dryrun-before.sha256
/usr/local/sbin/lf-course26-renew --dry-run --run-deploy-hooks
sha256sum -c /root/lf-course26/dryrun-before.sha256
ROOT
A renovação simulada real executou com sucesso HTTP-01 e os hooks, e o hash do certificado atual permaneceu o mesmo. Os hooks especificados para o teste seco em --run-deploy-hooks usam o certificado atualmente ativo, não um certificado de teste temporário. A operação e as opções também podem ser confirmadas em Guia do Usuário do Certbot . Um teste seco bem-sucedido não significa que o arquivo atual foi substituído por um novo certificado.
Verificar a execução do temporizador e monitorar a expiração
Abra o arquivo com sudoedit /etc/systemd/system/lf-course26-renew.service e salve a unidade de serviço a seguir.
[Unit]
Description=Local course26 certificate renewal test
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-course26-renew
Abra o arquivo com sudoedit /etc/systemd/system/lf-course26-renew.timer e salve a unidade de temporizador a seguir. OnActiveSec=3s é uma linha para observar a execução imediata agendada na prática. Em produção, remova essa linha de teste e defina os tempos de execução e atrasos de distribuição de acordo com a política de carga de serviço e gerenciamento.
[Unit]
Description=Local course26 renewal timer test
[Timer]
OnActiveSec=3s
OnCalendar=*-*-* 03,15:00:00
Persistent=true
Unit=lf-course26-renew.service
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl start lf-course26-renew.timer
systemctl list-timers lf-course26-renew.timer --no-pager
systemctl show lf-course26-renew.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-course26-renew.service -n 25 --no-pager
A chamada do temporizador de origem ocorreu após 3 segundos, e os estados finais foram Result=success, ExecMainStatus=0 e ActiveState=inactive. O certificado ainda não estava próximo da renovação, então o registro indicou que a reemissão e os hooks de implantação foram ignorados. Portanto, 'o temporizador foi executado', 'tentou atualizar' e 'emitiu/distribuiu um novo certificado' são itens de confirmação separados. É normal que um serviço oneshot esteja inativo após terminar normalmente. Neste exemplo, iniciar o temporizador o ativa apenas durante a execução atual do sistema, e as configurações de habilitação são necessárias separadamente para execução automática na reinicialização.
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -enddate
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 604800
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 8640000
Este certificado de teste não expira dentro de 7 dias, resultando no código de saída 0 em uma verificação de 604.800 segundos, e expira dentro de 100 dias, resultando em 1 em uma verificação de 8.640.000 segundos. Isso não significa "já expirou." -checkend verifica a expiração dentro do número especificado de segundos. Por favor, verifique o significado das opções no documento x509 do OpenSSL . A monitoração operacional verifica não apenas arquivos locais, mas também certificados fornecidos externamente, e em caso de falha, a rota de notificação deve ser testada para que o administrador possa ser informado.
Condições para aplicar a configuração a serviços públicos
Em um domínio real, CAs de teste privadas, entradas de hosts, verificação da porta 5002 e APIs de loopback não são usados. Primeiro, verifique o DNS público e as conexões externas da porta 80 e, se desejar manter o servidor web existente, você pode fornecer o arquivo de autenticação usando o método webroot. Prepare um caminho e um diretório de configuração separados do Certbot para operação e não misture contas de teste ou certificados de teste com certificados operacionais.
- Verifique se os registros A e AAAA do seu domínio apontam para o servidor real e estão acessíveis externamente. Além disso, verifique se os registros IPv6 não utilizados não apontam para servidores incorretos.
- No Nginx, verifique de fora se o arquivo de teste
/.well-known/acme-challenge/está sendo servido no caminho correto do documento. Bloqueios de caminho ocultos, requisitos de autenticação ou redirecionamentos incorretos podem interferir na verificação. - Primeiro, realize a verificação pública no ambiente de testes (staging) a partir do Certbot operacional para
certonly --webroot -w /srv/example-webroot -d www.example.com --dry-run. Substitua o webroot e o domínio de exemplo pelos seus valores reais, insira um e-mail de conta acessível e revise os termos da CA. - Após um teste bem-sucedido, realize a emissão operacional e aplique os caminhos da cadeia completa e da chave privada no Nginx. Os hooks de renovação operacional devem ser escritos de acordo com o caminho real, nome e cadeia de confiança, e os hooks da CA privada deste tutorial não devem ser reutilizados como estão.
- Verifique a resposta externa na porta 443, nome, cadeia, expiração, simulação de renovação e gancho de implantação, e também a próxima execução e o resultado recente do temporizador. Além disso, siga as políticas e restrições de emissão e renovação exigidas pela CA pública.
Esta seção é para as condições de mudança para o serviço público. A verificação local desta vez não pode ser considerada como confirmação do DNS, firewall da internet ou emissão por uma autoridade de certificação pública para o domínio que você realmente possui.
Parando o ambiente de teste e restaurando as configurações existentes
Após terminar o teste, primeiro pare o temporizador e o Pebble. Mova os arquivos do Nginx que você criou para o local de backup e, após a inspeção e o recarregamento, apenas o site padrão existente permanecerá.
sudo systemctl stop lf-course26-renew.timer lf-course26-renew.service lf-course26-pebble.service
sudo mv /etc/nginx/conf.d/lf-course26.conf /root/lf-course26/lf-course26.conf.saved
sudo nginx -t && sudo systemctl reload nginx
sudo semanage port -d -p tcp 18426
sudo rm -- /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer
sudo systemctl daemon-reload
No arquivo /etc/hosts da VM Rocky Linux, remova apenas a linha exata adicionada nesta prática. Se não houver outras edições, ela pode ser restaurada comparando com o original protegido. Além disso, após verificar a propriedade, remova executáveis de teste não utilizados, certificados de distribuição dedicados e arquivos de estado de timer, e mantenha arquivos ou regras usados por outros sites. Se você armazenar chaves secretas e informações de conta, proteja-as com permissões apenas para root como antes.
Após a limpeza no laboratório de origem, Nginx, configurações de firewall, hosts e política local do SELinux estavam iguais ao que eram antes do exercício, e o conteúdo do site padrão existente também estava igual. SSH e firewalld permaneceram ativos, e o SELinux continuou no modo Enforcing. Teste da API, listeners HTTPS e tarefas agendadas foram removidos, e apenas a pasta de logs dedicada foi mantida com permissões 0700.




