Os certificados SSL são uma parte essencial da internet e garantem que os dados sejam transmitidos com segurança entre o cliente e o host. Neste guia, mostramos como configurar a ferramenta de código aberto Certbot para solicitar certificados SSL gratuitos da autoridade certificadora sem fins lucrativos Let's Encrypt.
Para usar o Certbot, você precisa de um servidor Linux e de um domínio próprio. Você precisa ter acesso às configurações de DNS do domínio e deve criar um registro DNS A para cada domínio raiz ou subdomínio que quiser usar, apontando para o endereço IP do seu servidor Linux.
O Certbot também oferece plugins adicionais que permitem configurar um certificado para um domínio com apenas um clique — compatíveis com vários servidores web, como Nginx ou Apache. Recomendamos o Nginx, pois é um servidor web de código aberto popular e de alto desempenho. Você encontra instruções para configurá-lo em nosso guia Proxy reverso Linux.
Comece instalando o pacote de código aberto Certbot, que permite solicitar certificados SSL gratuitos da Let's Encrypt.
sudo apt install certbot
Depois de instalar o Certbot, você pode solicitar certificados para seu(s) domínio(s). A Let's Encrypt e o Certbot oferecem diferentes desafios ACME para verificar a propriedade do domínio.
Recomendamos fortemente o método padrão HTTP-01, pois ele permite renovações automáticas. Se você tiver problemas com esse método, pode usar como alternativa o método manual DNS-01, que funciona por meio de um registro DNS TXT, mas não permite renovações automáticas.
Use plugins de servidor web Se você usa um servidor web como Nginx, Apache ou outro servidor próprio, recomendamos ir diretamente para a seção Plugins de servidor web mais abaixo. Lá, mostramos como usar plugins adicionais do Certbot para esses servidores e solicitar certificados com uma instalação de „um clique“, sem precisar parar o servidor web.
Com o Certbot instalado, você já pode solicitar certificados para seu(s) domínio(s). Neste exemplo, usamos o modo standalone, no qual o Certbot inicia um servidor web temporário para realizar o desafio. Para isso, você precisa liberar a porta 80 no firewall e não pode ter outro servidor web ou serviço em execução na porta 80, para que o servidor temporário possa iniciar e o desafio possa ser acessado (daí o nome HTTP do desafio).
No comando a seguir, você usa o parâmetro --standalone para informar ao Certbot que deve usar o servidor web temporário.
# Für Root-Domains
certbot certonly --standalone -d [deine_root_domain] -d www.[deine_root_domain]
# Für Subdomains
certbot certonly --standalone -d [deine_domain]
# Interaktive Einrichtung
certbot certonly --standalone
Depois de executar o comando, talvez você passe por uma configuração interativa inicial. Nela, será necessário informar um endereço de e-mail para as comunicações sobre o certificado, seguido de uma lista de e-mails opcional e dos termos e condições, com os quais você deverá concordar.
O Certbot vai gerar um desafio ACME e hospedá-lo por meio do servidor web temporário. Em seguida, os servidores da Let's Encrypt tentarão acessá-lo no seu servidor. Se tudo der certo, os certificados serão criados e armazenados no diretório /etc/letsencrypt/live/[deine_domain].
Agora você pode usar os certificados SSL onde precisar, basta informar o caminho local para os certificados.
Se você tiver problemas para verificar seu domínio usando o método HTTP-01, pode usar como alternativa o método DNS-01. Nesse caso, você cria um registro DNS TXT com um valor fornecido pela Let's Encrypt.
Como mencionado, esse método não permite renovações automáticas, a menos que você configure uma infraestrutura própria para isso. Por esse motivo, recomendamos usar o método HTTP-01 sempre que possível.
No comando a seguir, você usa o parâmetro --preferred-challenges para informar ao Certbot que deseja usar o método DNS-01.
# Für Root-Domains
certbot certonly --preferred-challenges dns-01 -d [deine_root_domain] -d www.[deine_root_domain] --manual -m [deine_email]
# Für Subdomains
certbot certonly --preferred-challenges dns-01 -d [deine_domain] --manual -m [deine_email]
# Interaktive Einrichtung
certbot certonly --preferred-challenges dns-01
Depois de executar o comando, talvez você passe por uma configuração interativa inicial. Nela, será necessário informar um endereço de e-mail para as comunicações sobre o certificado, seguido de uma lista de e-mails opcional e dos termos e condições, com os quais você deverá concordar.
O Certbot vai mostrar instruções para criar um registro DNS TXT com um valor específico. O nome de destino geralmente é _acme-challenge. seguido do seu domínio (por exemplo, _acme-challenge.zapdocs.example.com), e você encontra o valor no terminal.
Depois de criar o registro, pressione Enter para continuar. Se tudo estiver correto e o registro já tiver se propagado, os certificados serão criados e armazenados no diretório /etc/letsencrypt/live/[deine_domain].
Tenha paciência, pois as alterações de DNS podem levar algum tempo para se propagarem. Normalmente, isso leva apenas alguns minutos, mas, em casos raros, pode demorar mais.
Agora você pode usar os certificados SSL onde precisar, basta informar o caminho local para os certificados.
O Certbot oferece vários plugins adicionais para servidores web que facilitam ainda mais o gerenciamento de certificados, pois ajustam automaticamente os blocos de servidor relevantes. Para usar um plugin, basta adicionar o parâmetro correspondente ao comando certbot.
Os dois métodos usam o desafio HTTP-01 e funcionam basicamente da mesma forma. Primeiro, o Certbot procura o bloco de servidor que contém o domínio solicitado como server_name. Em seguida, gera um desafio ACME e adiciona temporariamente um bloco location /.well-known/acme-challenge/... à configuração do bloco de servidor.
Depois, os servidores da Let's Encrypt tentarão acessar o desafio no seu servidor. Se tudo der certo, seu certificado será gerado e a configuração do bloco de servidor será ajustada automaticamente para usar HTTPS (porta 443) e incluir os caminhos para os novos certificados.
Antes de usar o plugin, verifique se ele está instalado.
sudo apt install python3-certbot-nginx
Para usar o plugin do Nginx, adicione o parâmetro --nginx ao comando.
# Für Root-Domains
certbot --nginx -d [deine_root_domain] -d www.[deine_root_domain]
# Für Subdomains
certbot --nginx -d [deine_domain]
# Interaktive Einrichtung
certbot --nginx
Se quiser desativar os ajustes automáticos de „um clique“ nos blocos de servidor feitos pelo Certbot, você pode adicionar o parâmetro certonly, por exemplo, certbot certonly.
Antes de usar o plugin, verifique se ele está instalado.
sudo apt install python3-certbot-apache
Para usar o plugin do Apache, adicione o parâmetro --apache ao comando.
# Für Root-Domains
certbot --apache -d [deine_root_domain] -d www.[deine_root_domain]
# Für Subdomains
certbot --apache -d [deine_domain]
# Interaktive Einrichtung
certbot --apache
Se quiser desativar os ajustes automáticos de „um clique“ nos blocos de servidor feitos pelo Certbot, você pode adicionar o parâmetro certonly, por exemplo, certbot certonly.
Se você usa seu próprio servidor web local, que não é um software padrão, talvez queira usar o método Webroot para manter o servidor web em funcionamento sem precisar pará-lo.
Para usar o plugin Webroot, adicione o parâmetro --webroot ao comando. Além disso, use -w [dein_webserver_pfad] (abreviação de --webroot-path) para especificar o caminho do diretório raiz do seu servidor web.
# Für Root-Domains
certbot --webroot -w [dein_webserver_pfad] -d [deine_root_domain] -d www.[deine_root_domain]
# Für Subdomains
certbot --webroot -w [dein_webserver_pfad] -d [deine_domain]
# Interaktive Einrichtung
certbot --webroot -w [dein_webserver_pfad]
Um caminho Webroot comum é /var/www/html. Você também pode usar esse método com servidores web como Nginx ou Apache se quiser mantê-los em funcionamento sem ajustes automáticos nos blocos de servidor, como os feitos pelos plugins nativos.
Na maioria dos casos, o Certbot configura a renovação automática dos certificados por meio de um cronjob e/ou de um temporizador systemd. Você pode testar isso com o comando a seguir, que executa uma simulação usando --dry-run.
certbot renew --dry-run
Como mencionado, o método DNS-01 não permite renovações automáticas pelo Certbot, a menos que você configure uma infraestrutura própria para isso. Por esse motivo, recomendamos usar o método HTTP-01 sempre que possível.
O teste deve ser concluído com sucesso se tudo estiver configurado corretamente. Se quiser consultar ou ajustar a renovação automática, você encontra o comando correspondente em um dos seguintes diretórios: /etc/crontab/, /etc/cron.*/* ou usando systemctl list-timers.
Se a renovação automática não estiver configurada, você pode adicioná-la manualmente usando um cronjob. Abra o crontab com crontab -e. Se essa for a primeira vez, você precisará escolher um editor. Selecione a primeira opção, normalmente /bin/nano.
No Nano, adicione a linha a seguir para executar a renovação todos os dias às 6h da manhã, no horário local.
0 6 * * * certbot renew
Salve o arquivo e saia do Nano com CTRL + X, confirme com Y e pressione ENTER.