> ## 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 no Google Cloud

## Cliente ACME DigiCert com o Google Cloud DNS (Desafio DNS-01)

O cliente ACME da DigiCert suporta nativamente o provedor Google Cloud DNS. 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 Google Cloud DNS 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 o **Google Cloud DNS** como provedor de DNS;
* Criar uma chave de API com permissões específicas no **Google Cloud;**

### 1. Criando a chave no Google Cloud

1. No console do GCP, vá em **IAM e Administrador** > **Contas de Serviço**.

2. Crie uma conta de serviço (ex: `dc-acme-dns-automation`).

3. Conceda a ela a regra de **Administrador do DNS (`roles/dns.admin`)**.

4. Entre na aba **Chaves**, clique em **Adicionar Chave** > **Criar nova chave** (formato **JSON**) e baixe o arquivo (ex: `gcp-dns-key.json`) e salve no mesmo diretório do arquivo .toml .

### 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=gcloud,GCE_PROJECT=COLE_O_NOME_AQUI,GCE_SERVICE_ACCOUNT_FILE=caminho/para/seu/gcp-dns-key.json"
```