Adicionar e verificar um domínio

Esta página mostra como adicionar um domínio à sua organização e verificá-lo. Você vai precisar de uns dez minutos e de acesso às configurações de DNS do domínio, ou da ajuda de quem tem esse acesso.

Antes de começar

Permissões. Você precisa do papel Proprietário ou Administrador. Se a aba Domínios estiver desabilitada, ou se você não vir o botão Adicionar domínio, fale com um administrador da sua organização.
Acesso ao DNS do domínio. A verificação exige adicionar um registro TXT ao domínio. Isso é feito no painel da empresa que hospeda o DNS do domínio, e não no BreezeAuth.

Encontrar os domínios da sua organização

Entre no console de administração.
Na barra lateral, selecione Organização. A página Gerenciar Organização se abre.
Selecione a aba Domínios.

A lista mostra todos os domínios adicionados à organização, quando foram adicionados e o status de cada um: Verificado, com a data da verificação, ou Pendente.

Dica: enquanto a sua organização não tiver um domínio verificado, o console de administração lembra os administradores com a janela Verifique um domínio para habilitar usuários gerenciados. Selecione Verificar um domínio para ir direto a esta aba, ou Agora não para ocultá-la até a sua próxima sessão.

Adicionar um domínio

Na aba Domínios, selecione Adicionar domínio. A janela Adicionar novo domínio se abre.
Em Domínio, informe apenas o domínio, sem https://, www. nem um endereço de e-mail. Por exemplo: exemplo.com.br.
Selecione Confirmar.

O domínio é adicionado como Pendente, e a janela Verificar domínio se abre com o registro DNS a publicar.

Algumas regras se aplicam:

O domínio precisa ser um nome de domínio completo, como exemplo.com.br ou exemplo.com. São aceitos letras, números, hifens e pontos. Letras maiúsculas são convertidas para minúsculas.
Adicione o domínio exatamente como ele aparece depois do @ nos endereços de e-mail. Se algumas pessoas usam @vendas.exemplo.com.br, adicione vendas.exemplo.com.br como um domínio separado.
Se aparecer Este domínio já foi adicionado para esta organização., o domínio já está na lista.
Se aparecer Este domínio já está verificado para outra organização., outra organização do BreezeAuth já comprovou a posse dele. Se você acredita que isso é um engano, fale com o suporte.

Publicar o registro DNS

A janela Verificar domínio mostra o registro a ser adicionado ao DNS do domínio:

Campo	O que informar
Tipo do registro	`TXT`
Nome / Host	`@` ou em branco, ou seja, o próprio domínio. Alguns provedores pedem que você digite o domínio completo.
Valor	O valor mostrado na janela, como `breeze-auth-domain-verification=6f1c…`. Use o botão de copiar ao lado dele.

Selecione o botão de copiar ao lado de Valor.
Em outra aba do navegador, abra as configurações de DNS do seu domínio no seu provedor de DNS.
Crie um novo registro do tipo TXT para o próprio domínio (@) e cole o valor.
Salve o registro.

Se você não consegue alterar o DNS, envie os três valores acima para quem administra o seu domínio. Você pode fechar a janela e voltar depois: o valor continua o mesmo e aparece de novo quando você seleciona Verificar domínio.

Observação: adicionar um registro TXT não afeta o seu site nem os seus e-mails. Um domínio pode ter vários registros TXT, por exemplo para a segurança de e-mail (SPF) ou para outros serviços. Não altere nem remova os existentes, apenas adicione um novo.

Iniciar a verificação

Na aba Domínios, selecione Verificar domínio ao lado do domínio pendente, se a janela ainda não estiver aberta.
Selecione Iniciar verificação.
Aguarde alguns segundos enquanto o BreezeAuth consulta o DNS do domínio.

Se o registro for encontrado, aparece Domínio verificado com sucesso. e o domínio passa a ser mostrado como Verificado. Em seguida, o BreezeAuth converte as contas do domínio em usuários gerenciados, em segundo plano. Veja O que acontece com as contas existentes.

Se aparecer Não foi possível verificar o domínio, o registro ainda não foi encontrado. O domínio continua Pendente e você pode tentar de novo a qualquer momento.

Importante: mudanças de DNS levam um tempo para se espalhar pela internet. Normalmente são alguns minutos, mas, dependendo do seu provedor de DNS, podem ser várias horas. Até lá, a verificação falha. O BreezeAuth não tenta de novo automaticamente: selecione Iniciar verificação novamente mais tarde.

Se a verificação continuar falhando

Verifique	O que fazer
O registro está no nome errado	O registro precisa estar no próprio domínio (`@`), e não em um subdomínio como `www`. Alguns provedores acrescentam o domínio automaticamente, transformando `exemplo.com.br` em `exemplo.com.br.exemplo.com.br`.
O valor está incompleto	Cole o valor completo, incluindo o prefixo `breeze-auth-domain-verification=`, sem espaços ou aspas adicionados à mão.
O registro está no domínio errado	Confirme que você editou a zona DNS do mesmo domínio que adicionou no BreezeAuth.
A mudança de DNS ainda não se propagou	Aguarde um pouco e tente de novo. A sua equipe de TI pode conferir o que a internet enxerga com uma ferramenta como `nslookup -type=TXT exemplo.com.br` ou um serviço de consulta DNS on-line.
O domínio usa outro provedor de DNS	Se você mudou o domínio de provedor recentemente, o registro precisa ser adicionado no provedor que responde pelo domínio atualmente (os seus “servidores de nomes”).

Depois da verificação

Mantenha o registro. O BreezeAuth confere o registro apenas quando você inicia a verificação, então removê-lo depois não a desfaz. Mesmo assim, recomendamos mantê-lo, para que qualquer pessoa que olhe o seu DNS saiba por que ele está lá.
Verifique os seus outros domínios. Repita estes passos para cada domínio usado nos e-mails das pessoas.
Revise as contas existentes. Algumas pessoas podem aparecer agora como Revisão pendente em Usuários. Veja Revisar contas pendentes.

Excluir um domínio

Na aba Domínios, selecione o ícone de lixeira ao lado do domínio.
Confirme na janela Excluir domínio.

Importante: a exclusão de um domínio não pode ser desfeita. Se você adicioná-lo de novo depois, o BreezeAuth gera um novo valor, e será preciso atualizar o registro DNS e verificá-lo novamente.

Quando você exclui um domínio verificado:

As contas que já são gerenciadas pela sua organização continuam gerenciadas. Elas não voltam a ser convidadas.
As pessoas que você adicionar a partir daí com e-mail nesse domínio serão convidadas.
Qualquer pessoa volta a poder criar uma conta pessoal no BreezeAuth com e-mail nesse domínio, e outra organização pode adicioná-lo e verificá-lo.

Excluir um domínio pendente não afeta nenhuma conta.

As mudanças são auditadas

A adição, a verificação e a exclusão de domínios ficam registradas nos Logs de Auditoria da sua organização, junto com quem fez a mudança e quando. Se os seus sistemas precisam reagir a essas mudanças, inscreva um webhook nos eventos de domínio.