Como configurar o cliente ACME utilizando a validação por DNS na Cloudflare
Cliente ACME DigiCert com a Cloudflare (Desafio DNS-01)
O cliente ACME da DigiCert suporta nativamente o provedor de DNS Cloudflare. Isso permite que ele crie automaticamente o registro do tipo TXT (_acme-challenge) necessário para provar o controle do seu domínio.
Para utilizar a Cloudflare para na automação e validação de domínio através do cliente ACME da DigiCert, é necessário:
- Que todos os domínios presentes no certificado SSL utilizem a Cloudflare como provedor de DNS;
- Criar um token de API com permissões específicas na Cloudflare;
1. Criando o Token Único na Cloudflare
- Acesse o painel de Tokens de API da Cloudflare.
- Clique em Criar token (Create Token) e escolha Criar token personalizado (Create Custom Token).
- Dê um nome para o token (ex:
dc-acme-dominio.com).
- Na seção Permissões (Permissions), adicione duas linhas utilizando o botão Adicionar mais com os seguintes valores:
Permissões | ||
|---|---|---|
Zona | DNS | Ler |
Zona | DNS | Editar |
- Na seção Recursos de zona (Zone Resources) adicione uma linha para cada domínio que esteja incluído no certificado SSL, exemplo:
Recursos de zona | ||
|---|---|---|
Incluir | Zona Específica |
- Clique em Continuar para o resumo e depois em Criar token.
- Copie o token gerado (ele só aparece uma vez).
2. Edite o arquivo de configuração do cliente ACME DigiCert
Configure a seção Challenge preferences do seu arquivo .toml, por exemplo dc-acme-seusite.toml, com o seguinte conteúdo:
# Challenge preferences
type = "dns-01"
handler_name = "default"
handler_args = "DNS_PROVIDER_NAME=cloudflare,CF_DNS_API_TOKEN=COLE_O_TOKEN_AQUI,CF_ZONE_API_TOKEN=COLE_O_TOKEN_AQUI"
Atualizado em: 06/11/2026
Obrigado!
