Resolução de problemas de DNS do White Label

A maioria dos problemas de DNS do White Label Lite resulta de uma de quatro situações: o registo não existe, tem um valor diferente do apresentado na tabela Branding, existe um proxy ativo ou a etapa do certificado requer atenção.

Comece pela tabela DNS for your brand no separador Branding do domínio. É a referência definitiva para o nome de host e o destino. Não copie um destino CNAME de um artigo antigo, de outra conta nem de uma ferramenta de verificação de DNS.

Percurso rápido

1. Abra Branding e copie o host, o tipo e o valor do endereço afetado.
2. Crie ou corrija esse registo no fornecedor de DNS que aloja a zona DNS ativa.
3. Mantenha o registo apenas em DNS se o fornecedor disponibilizar uma opção de proxy.
4. Volte a Branding e selecione Verify DNS. Partilhe o endereço apenas quando o estado for Active.

Como verificar o DNS sem um terminal

Antes de investigar qualquer outra causa, compare o registo no seu fornecedor de DNS com a linha em Branding:

• Host ou Name
• Type, que é CNAME para um host personalizado do painel ou do webmail
• Value ou Target
• A definição de proxy, que tem de estar desativada para um host personalizado que use Cloudflare

Use a ação Verify DNS em Branding depois de guardar o registo. A ação coloca uma nova verificação em fila e a página mostra o estado resultante.

Para uma verificação independente, use um serviço público de pesquisa de DNS ou peça ao seu fornecedor para consultar o nome de host completo como CNAME. A resposta tem de corresponder exatamente ao campo Value atual em Branding. Uma ferramenta pública pode confirmar o que deteta, mas não substitui o estado Active da plataforma.

Não precisa de um terminal para terminar esta configuração. Se usar um, consulte o nome de host completo e compare o CNAME devolvido com o valor apresentado em Branding.

O estado indica "Pending DNS"

Pending DNS significa que a plataforma ainda não encontrou o registo esperado para esse host. Selecione Verify DNS depois de corrigir um registo e regresse ao separador Branding depois de o estado ser atualizado. Faça estas verificações por ordem:

Editou o fornecedor de DNS errado. Confirme qual fornecedor é autoritativo para o DNS do seu domínio. É possível editar o painel do registador quando a zona DNS ativa está alojada noutro local.

O destino CNAME não é o atual. Copie Value ou Target da tabela Branding. Remova um registo antigo em conflito para o mesmo nome de host apenas depois de verificar que não é usado por outro serviço.

O tipo de registo está errado. Um host do painel ou do webmail precisa do registo CNAME apresentado em Branding. Um registo A ou AAAA no mesmo nome de host pode impedir o resultado esperado.

O nome de host foi introduzido no formato errado. Alguns fornecedores pedem apenas o prefixo, como dashboard, enquanto outros pedem o nome de host completo. Siga a indicação do campo do fornecedor e compare o registo resultante com o host apresentado em Branding.

Se o registo corresponder, mantenha-o e use novamente Verify DNS. Alterar repetidamente um registo correto pode prolongar o tempo até todos os resolvedores de DNS verem a mesma resposta.

A nuvem laranja do Cloudflare impede o provisionamento de SSL

Se usar o Cloudflare como fornecedor de DNS, verá um ícone de nuvem junto de cada registo. Uma nuvem laranja significa que o Cloudflare encaminha o pedido através de um proxy. Um CNAME personalizado do painel ou do webmail tem de estar apenas em DNS para a plataforma o poder verificar e emitir o certificado.

Correção: selecione a nuvem junto ao CNAME do host personalizado afetado até ficar cinzenta e guarde o registo. Volte a Branding e selecione Verify DNS.

Esta regra aplica-se ao registo do host personalizado, não automaticamente a todos os outros registos do domínio. Se outro fornecedor tiver uma opção de proxy ou CDN, desative-a para esse CNAME, salvo instruções diferentes na tabela Branding.

O estado indica "SSL could not be issued" e menciona CAA

Um registo CAA informa os fornecedores de certificados sobre as organizações autorizadas a emitir um certificado para o seu domínio. Altere-o apenas quando o estado em Branding ou o apoio identificar especificamente o CAA como impedimento.

Mantenha o CNAME inalterado e verifique se o domínio já tem um registo CAA. O seu fornecedor de DNS pode apresentá-lo, ou uma pesquisa independente de DNS pode consultar o domínio raiz.

Se o registo tiver de autorizar o emissor de certificados da plataforma, adicione o valor CAA exato fornecido pelo apoio ou apresentado nas orientações atuais do produto. Não elimine entradas CAA não relacionadas apenas para concluir esta etapa. Podem coexistir vários registos CAA.

No processo atual de certificados, o valor necessário é normalmente:

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Se não tiver registos CAA, não adicione um apenas por precaução. Volte a Branding e selecione Verify DNS depois de fazer uma alteração ao CAA.

O estado indica "SSL could not be issued" sem motivo

O CNAME pode já estar correto. Não o elimine e recrie repetidamente. Em vez disso:

1. Confirme que o registo continua a corresponder ao host e ao destino em Branding e não passa por um proxy.
2. Selecione Verify DNS uma vez.
3. Se o estado continuar inalterado, contacte o apoio com o nome de host, o estado apresentado e uma captura de ecrã do registo DNS.

O trabalho do certificado não é uma alteração que possa resolver editando um CNAME que já está correto. A equipa de apoio pode analisar o resultado do lado da plataforma sem pedir que revele credenciais do fornecedor de DNS.

O domínio estava ativo, mas o estado mudou

Quando um host está Active, está pronto para funcionar. Se o estado mudar mais tarde:

• Voltou a "Pending DNS": compare o CNAME atual com a tabela Branding. O registo pode ter sido alterado, removido ou colocado atrás de um proxy.
• "SSL could not be issued": mantenha um CNAME correspondente, selecione Verify DNS e contacte o apoio se o estado persistir.
• Off: verifique se Branding foi desativado para esse domínio ou se a subscrição White Label está inativa. Se nenhuma das situações explicar o problema, contacte o apoio.

Cenários comuns

"Alterei o CNAME, mas o estado continua pendente." Confirme que editou o fornecedor de DNS autoritativo e que o novo CNAME corresponde exatamente a Branding. Use depois Verify DNS. Evite alternar entre valores enquanto a verificação estiver em curso.

"Eliminei o CNAME antigo no fornecedor anterior, mas o novo não é encontrado." Se mudou de fornecedor de DNS, certifique-se de que o registador delega o domínio nos servidores de nomes do novo fornecedor. Caso contrário, peça ao fornecedor que aloja a zona DNS autoritativa para confirmar o registo.

"O meu site principal usa um proxy. O host personalizado também pode usá-lo?" Mantenha o CNAME personalizado apenas em DNS. O resto do domínio pode usar as suas próprias definições de proxy, desde que o host específico em Branding não passe por um proxy.

"Posso usar um CNAME universal?" Configure o nome de host específico apresentado em Branding. Isto fornece à plataforma um endereço inequívoco para verificar e testar. Não substitua o host indicado na tabela por um registo universal.

"Quero usar um subdomínio diferente." Altere o nome no separador Branding do domínio, guardando um host de cada vez. Copie o novo CNAME da tabela, teste o novo host apenas quando ficar Active e mantenha o endereço antigo dos clientes até concluir a transição.

"Uma rede não consegue ver o novo registo." Teste noutra rede ou peça ao cliente afetado para voltar a tentar mais tarde. Se a tabela Branding indicar Active e o host funcionar noutros locais, o atraso restante está provavelmente na cache de DNS dessa rede.

Próximos passos

• Configurar o White Label Lite: os passos de configuração originais, se ainda não tiver terminado.
• Perguntas frequentes sobre preços do White Label Lite: questões relacionadas com faturação.
• Cancelar o White Label Lite: o que acontece ao seu domínio se cancelar.
• Registos DNS recomendados: uma visão mais ampla dos registos DNS usados pelo TrekMail.

Se continuar sem conseguir resolver o problema, abra um pedido de apoio com o nome de host, o estado exato em Branding, o fornecedor de DNS e uma captura de ecrã do registo. Não envie palavras-passe nem tokens de API do fornecedor de DNS.