Apresentação
A validação de domínio permite que você prove que um domínio configurado no Axeptio lhe pertence e, opcionalmente, restrinja a execução do seu widget apenas a esse domínio.
A validação se baseia na adição de um registro DNS do tipo TXT na zona DNS do seu domínio. Após o domínio ser validado, você pode escolher entre dois modos de funcionamento:
Permitir que o SDK Axeptio funcione em todos os domínios (comportamento padrão).
Restringir a execução do SDK apenas ao domínio validado, para evitar que seu widget seja usado de um domínio não autorizado.
Após qualquer modificação, você deve publicar o widget para que as alterações entrem em vigor.
Pré-requisitos
Antes de começar, certifique-se de que você tem:
acesso ao seu projeto Axeptio;
permissões necessárias para modificar a configuração do projeto;
acesso à zona DNS do domínio a ser validado, através de seu provedor de hospedagem, registrador ou ferramenta de gerenciamento DNS;
identificado o domínio principal do seu site.
Exemplo:
meusite.com
Etapa 1 — Configurar o domínio principal do projeto
Na interface Axeptio, abra o projeto em questão.
Abra o detalhe do projeto.
Acesse a seção Gerenciamento de domínios.
Configure ou atualize o domínio principal do seu site.
Salve a modificação.
O domínio principal deve corresponder ao domínio que você deseja validar.
Use:
meusite.com
Evite — URL completa com protocolo ou caminho:
https://www.meusite.com/pagina
Etapa 2 — Adicionar o registro DNS de validação
Assim que o domínio principal for configurado, o Axeptio gera uma chave de validação para ser adicionada à sua zona DNS. Essa chave permite que o Axeptio verifique que você realmente tem acesso à configuração DNS do domínio.
Registro DNS a ser criado
Na sua ferramenta de gerenciamento DNS, adicione um novo registro com as informações a seguir:
Campo DNS | Valor |
Tipo |
|
Nome / Host / Subdomínio |
|
Valor | Chave de validação fornecida pelo Axeptio |
TTL | Valor padrão ou automático |
Dependendo de seu provedor DNS, o campo Nome, Host ou Subdomínio pode ser solicitado em formatos diferentes. Você deve informar a forma curta:
_axeptio-verify
Ou a forma completa:
_axeptio-verify.meusite.com
O valor TXT deve ser copiado exatamente como é exibido no Axeptio.
Exemplo:
axeptio-verify=xxxxxxxxxxxxxxxx
Etapa 3 — Validar o domínio no Axeptio
Após adicionar o registro DNS, retorne ao Axeptio.
Inicie a verificação.
O Axeptio verifica a presença do registro TXT em sua zona DNS.
Se o registro for encontrado, o domínio passa para o status validado.
Uma vez validado, o Axeptio considera que você é de fato proprietário ou administrador do domínio configurado.
Etapa 4 — Escolher o modo de funcionamento do SDK
Após validação, dois comportamentos são possíveis.
Opção 1 — Permitir que o SDK funcione em todos os domínios
Por padrão, o SDK Axeptio pode ser executado em todos os domínios onde está instalado. Esse modo é útil se seu widget é voluntariamente usado em vários domínios, ambientes ou sites.
Exemplos:
meusite.com blog.meusite.com landing-page-parceiro.com preprod.meusite.com
Nesse caso, a validação do domínio permite apenas comprovar a propriedade do domínio principal. Ela não bloqueia a execução do SDK em outros lugares.
Opção 2 — Restringir o SDK ao domínio validado
Você também pode ativar a restrição de domínio usando a caixa de seleção dedicada. Quando essa opção é ativada, o SDK Axeptio é autorizado a ser executado apenas no domínio validado.
Isso reforça o controle sobre o uso do seu widget e evita que uma configuração Axeptio seja executada de um domínio não autorizado.
Para ativar a restrição:
Vá para Gerenciamento de domínios.
Certifique-se de que o domínio principal está validado.
Ative a caixa de seleção de restrição de domínio.
Salve a modificação.
A partir desse momento, após publicação, o widget será limitado ao domínio validado.
Etapa 5 — Publicar o widget
Após modificar o domínio, validar a propriedade ou ativar a restrição, você deve publicar o widget. Essa etapa é essencial para que as alterações sejam aplicadas ao seu site.
Clique em Publicar no topo da janela.
Aguarde a confirmação de publicação.
Recarregue seu site para verificar o funcionamento correto.
Sem publicação, as modificações realizadas no gerenciamento de domínios ainda não serão aplicadas pelo SDK.