Configuração automática de DNS com a Cloudflare

A TrekMail pode criar os registros DNS de e-mail dos domínios gerenciados pela Cloudflare. Os dois métodos mostram uma etapa de confirmação antes de gravar qualquer mudança; a verificação de DNS acontece depois. Escolha a opção adequada para o domínio.

Método 1: configuração automática de um domínio qualificado

Quando aparece na aba DNS e status, esta é a opção mais rápida para um único domínio gerenciado pela Cloudflare. Ela não exige token de API. O botão não está disponível para todas as configurações, como um domínio usado apenas para envio ou um domínio que precisa de outro seletor DKIM.

1. Abra a aba DNS e status do domínio.
2. Clique em Configurar DNS automaticamente.
3. Você será levado à Cloudflare para revisar os registros.
4. Aprove a alteração na Cloudflare.
5. Volte à TrekMail. Uma verificação de DNS começa depois que o fluxo do provedor termina. Aguarde o status na TrekMail antes de considerar a configuração concluída.

Este método usa o protocolo Domain Connect. O domínio precisa usar os servidores DNS da Cloudflare.

Método 2: configuração com token de API para um ou vários domínios

Use este método para configurar vários domínios de uma vez ou quando o Domain Connect não estiver disponível.

Como funciona

1. Você cria um token de API na Cloudflare.
2. A TrekMail encontra as zonas às quais o token dá acesso e mostra quais podem ser adicionadas ou conectadas.
3. Você revisa e aplica as mudanças. Em seguida, a TrekMail adiciona os domínios e cria os registros DNS automaticamente.

Passo a passo

Etapa 1: conectar à Cloudflare

1. Na TrekMail, abra Domínios e clique na aba Cloudflare do cartão “Adicionar um domínio”. Você também pode acessar diretamente /app/domains?add=cloudflare.
2. Clique em Abrir Cloudflare para entrar na página de criação do token.
3. Na Cloudflare:
   • Clique em Create Token.
   • Comece pelo modelo Edit zone DNS ou crie um token personalizado com Zone → DNS → Edit.
   • Em Zone Resources, escolha somente a zona ou as zonas que a TrekMail deverá gerenciar. Use All zones apenas quando realmente quiser conectar um lote amplo.
   • Não inclua permissões que não tenham relação com essa tarefa.
   • Clique em Continue to summary → Create Token.
   • Copie o token. A Cloudflare só o mostra uma vez.
4. Cole o token na TrekMail. Uma marca verde confirma que ele é válido.

Etapa 2: selecionar domínios

A TrekMail mostra as zonas da Cloudflare acessíveis pelo token. Revise a seleção antes de continuar e desmarque qualquer domínio que não queira conectar.

• Configurar DNS: O domínio já existe na TrekMail e os registros DNS serão configurados.
• Adicionar e configurar DNS: O domínio é novo; ele será adicionado à TrekMail e o DNS será configurado automaticamente.

Domínios que não são gerenciados pela Cloudflare não aparecem nessa lista.

Etapa 3: aplicar os registros DNS

A TrekMail mostra uma prévia das alterações para cada domínio selecionado:

• Será adicionado: Um novo registro DNS será criado.
• Será combinado: O registro SPF existente será atualizado para incluir a TrekMail.
• Já configurado: Nenhuma mudança é necessária.
• Será substituído: Um registro existente entra em conflito com o que a TrekMail precisa. Use a opção Substituir / Manter desse registro: Substituir grava o valor da TrekMail no lugar do anterior; Manter deixa o registro intacto.

Antes de aplicar, você também pode escolher exatamente quais registros serão gravados. Cada registro tem uma caixa de seleção. É possível aplicar apenas MX e SPF agora e voltar depois para o DKIM, ou ignorar um registro que já é administrado por outra ferramenta. Tudo que ficar desmarcado não será alterado.

Clique em Aplicar DNS a todos os domínios para criar os registros selecionados. Depois de uma aplicação bem-sucedida, a TrekMail agenda uma verificação de DNS. Ela confirma o que está visível publicamente e é o status final no qual você deve confiar.

Configuração em lote

Se você tem muitos domínios na Cloudflare, o assistente pode cuidar deles ao mesmo tempo:

1. Ao criar o token de API, selecione All zones em Zone Resources.
2. Na etapa 2, selecione os domínios que deseja incluir e revise a escolha.
3. A TrekMail adicionará os novos domínios e aplicará os registros DNS a cada um deles em sequência.

Limites do plano

O limite de domínios do seu plano se aplica:

• Nano: Até 10 domínios no total.
• Starter: Até 50 domínios no total.
• Pro: Até 100 domínios no total.
• Agency: Até 1.000 domínios no total.

Você pode conectar até 50 domínios por lote. Domínios novos contam para o limite do plano.

Segurança

• O token de API é armazenado com criptografia e a TrekMail não registra seu valor em logs.
• A prévia determina o que a TrekMail pode criar ou atualizar. Leia tudo com atenção, especialmente quando houver uma combinação de SPF ou um registro em conflito.
• Desconectar a Cloudflare impede futuras mudanças de DNS pela TrekMail, mas não desfaz os registros que já foram gravados.

Solução de problemas

“Este token de API é inválido ou expirou”

Crie outro token na Cloudflare. Copie-o quando a Cloudflare exibi-lo e cole na TrekMail. Proteja-o como uma senha.

“O domínio não foi encontrado na sua conta da Cloudflare”

Confira se o domínio foi adicionado à Cloudflare e aparece com o status Active.

“Não tem permissão para editar registros DNS”

O token precisa de permissão para editar DNS. Crie um novo com Permissions → Add more → Zone → DNS → Edit.

O DNS continua pendente depois da configuração

Aguarde a execução da verificação de DNS e, se necessário, use Verificar DNS na página DNS do domínio. O cache depende do TTL do registro e do resolvedor, por isso nenhum prazo fixo em minutos ou horas é garantido. Antes de aplicar mudanças novamente, confira qual registro específico a TrekMail mostra como ausente ou em conflito.

Para consultar as etapas e permissões atuais da Cloudflare, veja gerenciamento de registros DNS e permissões de tokens de API.