Conecte sua conta Cloudflare para Pages, CDN e DNS

O que a conexão faz por você

Conectar sua conta Cloudflare nos permite publicar sites estáticos no Cloudflare Pages na sua conta e fornecer o DNS e o cache dos seus sites a partir dela. Tudo fica no seu próprio painel Cloudflare e no seu próprio plano Cloudflare.

Antes de começar

Uma conta Cloudflare, com os domínios que você deseja usar adicionados a ela como zonas. O plano gratuito é suficiente para conectar; o que você pode fazer em cada zona é o que o seu plano permitir.

1. Crie a chave na Cloudflare

No painel da Cloudflare, abra Meu perfil → Tokens de API e escolha Criar token, depois Criar token personalizado. Dê um nome a ele, adicione as permissões abaixo e, em Recursos de zona, escolha as zonas que deseja que alcancemos — todas as zonas ou apenas aquelas que você indicar. Revise e clique em Criar token. A Cloudflare mostra o token apenas uma vez; copie-o nesse momento.

Adicione estas permissões:

• Zona → Zona → Ler
• Zona → DNS → Editar
• Zona → Limpeza de cache → Limpar
• Zona → Configurações de zona → Editar
• Conta → Cloudflare Pages → Editar — apenas se quiser que publiquemos sites no Pages. Um token sem essa permissão ainda se conecta e funciona para DNS e cache.

A alternativa anterior. Em vez de um token, você pode conectar com sua Chave de API global e o endereço de e-mail usado para fazer login (Meu perfil → Tokens de API → Chaves de API → Chave de API global → Exibir). A Cloudflare não recomenda isso: a Chave de API global possui todas as permissões que o seu login tem, em todas as zonas, e não pode ter o escopo limitado. Use um token, se puder.

2. Conecte-o aqui

Abra Integrações no seu painel e escolha Conectar uma conta. Selecione Conta Cloudflare (Pages, CDN e DNS) como o grupo e Cloudflare como a conta, preencha Token de API — ou, para a alternativa anterior, Chave de API e E-mail da conta — e clique em Conectar conta.

Testamos o que você cola antes que qualquer coisa seja salva. Uma chave que não funciona nunca é armazenada, e a resposta informa o que havia de errado com ela. Uma chave que funciona é mantida criptografada no nosso cofre de segredos — nunca no nosso banco de dados — e nunca mais é exibida, nem mesmo para você.

O que acontece a seguir

• O Cloudflare Pages aparece como um destino de implantação quando você cria ou move um site estático, e publicamos a compilação em um projeto do Pages na sua conta.
• Suas zonas podem fornecer o DNS de um domínio e o cache de um site a partir dessa conta.
• Verificamos se o token pode ler suas zonas, editar DNS, limpar o cache e alterar as configurações de zona. A lista de verificação ao lado da conexão mostra quais dessas ações conseguimos confirmar.

Se você quiser manter CDN e DNS em contas Cloudflare diferentes, conecte-os separadamente como Cloudflare CDN e Cloudflare DNS — cada um tem seu próprio guia.

Se não conectar

Uma permissão é exibida como não confirmada. A Cloudflare nem sempre permite que um token liste suas próprias permissões, portanto algumas são confirmadas na primeira vez em que as usamos. Se uma ação falhar posteriormente com um erro de permissão, edite o token em Meu perfil → Tokens de API e adicione a permissão que falta — o valor do token não muda, portanto não é necessário reconectar nada.

Uma zona está ausente. Os Recursos de zona do token não a incluem. Edite o token para incluir essa zona ou todas as zonas.

Diz que a chave foi rejeitada. Quase sempre é uma de três situações: um espaço ou uma quebra de linha copiada com ela, uma chave expirada ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha depois. A chave é autenticada, mas não possui uma permissão de que a ação precisa. Crie uma nova chave com as permissões listadas acima, depois desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrações, localize a conta e clique em Desconectar. Isso exclui a chave armazenada imediatamente. Tudo o que a estava usando para na próxima ação, e as telas que dependiam dela avisam isso em vez de falharem silenciosamente.

A desconexão não desfaz o que já foi feito — registros, implantações ou configurações que alteramos na sua conta permanecem como estão. Se você acha que a própria chave pode ter vazado, revogue-a também no fornecedor; desconectar remove a nossa cópia, não a deles.