Apresentação
A validação de domínio permite que você prove que um domínio configurado no Axeptio pertence a você 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 validar o domínio, 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 a partir 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ê tenha:
acesso ao seu projeto Axeptio;
as permissões necessárias para modificar a configuração do projeto;
acesso à zona DNS do domínio a validar, através do seu provedor de hospedagem, registrador ou ferramenta de gerenciamento de DNS;
identificado o domínio principal do seu site.
Exemplo:
meusites.com
Etapa 1 — Preencher o domínio principal do projeto
A partir da interface Axeptio, abra o projeto em questão.
Abra os detalhes do projeto.
Acesse a seção Gerenciamento de domínios.
Preencha 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.
A usar:
meusites.com
A evitar — URL completa com protocolo ou caminho:
https://www.meusites.com/pagina
Etapa 2 — Adicionar o registro DNS de validação
Após preencher o domínio principal, o Axeptio gera uma chave de validação a ser adicionada à sua zona DNS. Esta chave permite que o Axeptio verifique que você tem acesso à configuração de DNS do domínio.
Registro DNS a criar
Na sua ferramenta de gerenciamento de DNS, adicione um novo registro com as seguintes informações:
Campo DNS | Valor |
Tipo |
|
Nome / Host / Subdomínio |
|
Valor | Chave de validação fornecida pelo Axeptio |
TTL | Valor padrão ou automático |
Dependendo do seu provedor de DNS, o campo Nome, Host ou Subdomínio pode ser solicitado em diferentes formatos. Você deverá preencher a forma curta:
_axeptio-verify
Ou a forma completa:
_axeptio-verify.meusites.com
O valor TXT deve ser copiado exatamente como aparece 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 muda para o status validado.
Uma vez validado, o Axeptio considera que você é o 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 — Deixar o SDK funcionar em todos os domínios
Por padrão, o SDK Axeptio pode ser executado em todos os domínios nos quais está instalado. Este modo é útil se o seu widget for intencionalmente usado em múltiplos domínios, ambientes ou sites.
Exemplos:
meusites.com blog.meusites.com landing-page-parceiro.com preprod.meusites.com
Neste 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 outro lugar.
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 esta opção está 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 impede que uma configuração Axeptio seja executada a partir 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á bem validado.
Ative a caixa de seleção de restrição de domínio.
Salve a modificação.
A partir desse momento, após a 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. Esta etapa é indispensável 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 se está funcionando corretamente.
Sem publicação, as modificações feitas no gerenciamento de domínios ainda não serão aplicadas pelo SDK.