Conecte sua conta do Cloudflare para Pages, CDN e DNS

O que a conexão faz por você

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

Antes de começar

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

1. Criar a chave na Cloudflare

No painel da Cloudflare, abra My Profile → API Tokens e escolha Create Token, depois Create Custom Token. Dê um nome a ele, adicione as permissões abaixo e, em Zone Resources, escolha as zonas que você deseja que alcancemos — todas as zonas ou apenas aquelas que você nomear. Revise e pressione Create Token. A Cloudflare exibe o token uma única vez; copie-o nesse momento.

Adicione estas permissões:

• Zone → Zone → Read
• Zone → DNS → Edit
• Zone → Cache Purge → Purge
• Zone → Zone Settings → Edit
• Account → Cloudflare Pages → Edit — apenas se você quiser que publiquemos sites no Pages. Um token sem isso ainda se conecta e funciona para DNS e cache.

A alternativa mais antiga. Em vez de um token, você pode se conectar com sua Global API Key e o endereço de e-mail com o qual você faz login (My Profile → API Tokens → API Keys → Global API Key → View). A Cloudflare desaconselha isso: a Global API Key carrega todas as permissões que seu login possui, em todas as zonas, e não pode ser restrita. Use um token se puder.

2. Conectá-la aqui

Abra Integrations em seu painel e escolha Connect an account. Selecione Cloudflare account (Pages, CDN & DNS) como o grupo e Cloudflare como a conta, preencha API token — ou, para a alternativa mais antiga, API key e Account email, e pressione Connect account.

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

O que acontece em seguida

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

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

Se não conectar

Uma permissão aparece 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 que as usamos. Se uma ação falhar posteriormente com um erro de permissão, edite o token em My Profile → API Tokens e adicione a permissão ausente — o valor do token não muda, portanto, nada precisa ser reconectado.

Falta uma zona. Os Zone Resources do token não a incluem. Edite o token para incluir essa zona ou todas as zonas.

A mensagem diz que a chave foi rejeitada. Quase sempre uma destas três coisas: um espaço ou uma quebra de linha copiada junto, uma chave que expirou ou uma chave que foi revogada ou regenerada após você copiá-la. Crie uma nova e cole-a novamente.

Ela se conecta, mas algo falha mais tarde. A chave se autentica, mas falta uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrations, localize a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Qualquer coisa que a estivesse usando para na próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

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