> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.activeweb.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

1. Acesse o painel de [Tokens de API da Cloudflare](https://dash.cloudflare.com/profile/api-tokens).

2. Clique em **Criar token** (_Create Token_) e escolha **Criar token personalizado** (_Create Custom Token_).

3. Dê um nome para o token (ex: `dc-acme-dominio.com`).

4. 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** |

5. 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** | **seudominio.com.br** |

6. Clique em **Continuar para o resumo** e depois em **Criar token**.

7. 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"
```