Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

Mapeamento personalizado de domínio

Prev Next

Planos que suportam este recurso: Professional Business Enterprise

Domínio padrão

Quando você cria um novo projeto no Document360, ele atribui automaticamente um nome de domínio padrão neste formato: project-name.document360.com.

Por exemplo, se você nomear seu projeto Projeto Greenfield, o domínio atribuído será project-greenfield.document360.com.


Editando um domínio padrão

Você pode criar um endereço web mais personalizado que reflita sua marca e preferência, editando o endereço padrão ou configurando um domínio personalizado, como help.yourcompany.com, o que facilita para os usuários encontrarem e lembrarem do seu site.

Para editar o endereço web padrão,

  1. Navegue até Configurações () > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.

  2. No painel de navegação à esquerda, navegue até Domínio personalizado.

    Custom domain mapping setup instructions with highlighted domain configuration details.

  3. Clique no ícone Editar () no campo de domínio fornecido pelo Document360 .

    image.png

  4. Insira seu domínio preferido no campo.

    • Se seu domínio preferido não estiver disponível, o botão Atualizar ficará inativo. Você vai precisar tentar um domínio diferente.

    • Se o domínio já estiver em uso, o botão Atualizar permanecerá inativo.

    • Se seu domínio preferido estiver disponível, o botão Atualizar será ativado.

  5. Clique em Atualizar para atualizar o endereço da sua base de conhecimento.


Criando um domínio personalizado

Você pode configurar um domínio personalizado com marca, como help.yourcompany.com para o site da sua base de conhecimento, usando os seguintes passos:

  1. Adicionar o domínio personalizado no Document360

  2. Configure um registro CNAME com seu registrador de domínio

  3. Verifique o domínio no Document360

Adicionando um domínio personalizado no Document360

  1. Navegue até Configurações () > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.

  2. No painel de navegação à esquerda, navegue até Domínio personalizado > Mapeamento de domínio Personalizado.

  3. Insira o domínio personalizado no campo de configuração do domínio .

  4. Clique em Adicionar domínio.

    image.png

  5. Assim que o domínio personalizado terminar de ser configurado e a configuração estiver concluída, os registros do domínio personalizado serão gerados e você será notificado no portal da base de conhecimento.

Configurando o registro CNAME no seu registrador de domínio

Uma vez que o domínio seja adicionado no Document360, você precisará configurar um registro CNAME dentro do seu registrador de domínio para vincular seu domínio personalizado aos servidores do Document360.

Para configurar o registro CNAME,

  1. Faça login no registrador de domínios onde você comprou seu domínio (por exemplo, GoDaddy, Namecheap, Google Domains).

  2. No painel de gerenciamento de domínio, navegue até as configurações de DNS.

  3. Adicione um novo CNAME nas configurações de DNS.

    1. Insira seu domínio personalizado preferido no campo Nome/Host (por exemplo, help.yourcompany.com).

    2. Insira o CNAME fornecido pelo Document360 no campo Pontos para/Valor.

  4. Insira os detalhes de quaisquer outros campos relevantes e salve o novo CNAME.

Exemplo para configurar um registro CNAME

Este éum exemplo para demonstrar o mapeamento CNAME para domínios registrados na Hostinger.
11_Screenshot-Nameservers_example

  1. Vá para a página de gerenciamento de domínio do Hostinger.

  2. Abra a seção Domínios e selecione seu domínio.

  3. Clique em DNS/Servidores de Nomes à esquerda e selecione a aba de registros DNS .

  4. Escolha o tipo de registro no menu suspenso (CNAME).

  5. Cole o valor copiado do Document360 no campo Pontos para .

  6. Adicione ovalor TTL (Time-To-Live) e clique no botão Adicionar gravação .

12_Screenshot-DNS_record_mapping_in_hostinger

Registradores de domínio comum

Abaixo está uma lista de alguns registradores de domínio comuns:


Verificando o domínio personalizado no Document360

Depois de configurar o CNAME, siga os passos abaixo para completar a configuração personalizada de mapeamento de domínio.

  1. Volte às configurações de domínio personalizado do Document360.

  2. Selecione a caixa de seleção que diz "Adicionei os registros."

  3. Clique no botão Verificar , e o processo de verificação é iniciado.

  4. Se a verificação for bem-sucedida, você receberá uma mensagem de brinde de sucesso.

NOTA

Se houver qualquer problema na configuração do domínio personalizado, confira os passos de Solução de Problemas na seção abaixo deste artigo.

Após mapear o domínio personalizado, clique no ícone Ir ao site da sua base de conhecimento para ver a mudança na URL do site.


Problemas de mapeamento após o lançamento

Mensagem 'Site enganoso à frente' ao acessar o site após mapeamento personalizado bem-sucedido.

13_Screenshot-Deceptive_site_ahead_warning

Isso significa que o Google sinalizou o domínio personalizado que você mapeou como inseguro para navegação.

  • Para verificar o status de sinalização, use o status do site Navegação Segura do Google.

  • Digite seu domínio mapeado e verifique se há algum problema.

  • Resolva e corrija os problemas detectados (ataques de phishing, infestados de malware, violação de diretrizes da comunidade, etc.).

  • Envie um pedido de avaliação pelo Google Search Console. O Google vai atualizar o status e remover o aviso do seu site.

Aqui está um artigo de ajuda do suporte do Google.

8_Screenshot-Troubleshooting_site_status


Balanceador de carga

Um balanceador de carga distribui o tráfego recebido de forma uniforme entre vários servidores, garantindo que seu site de base de conhecimento permaneça rápido e confiável, mesmo durante períodos de alto tráfego. Isso ajuda a evitar que qualquer servidor fique sobrecarregado e melhora o desempenho geral e a segurança do seu site.

Atualizar o balanceador de carga pode trazer benefícios adicionais, como recursos de segurança aprimorados e melhor gerenciamento do tráfego.

Atualização do balanceador de carga

  1. Navegue até Configurações () > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.

  2. No painel de navegação à esquerda, navegue até Domínio personalizado > Mapeamento de domínio Personalizado.

  3. Clique em Atualizar.

  4. Verifique a configuração personalizada de mapeamento de domínio no Document360.

  5. Copie o registro CNAME gerado no Document360.

  6. Configure o registro CNAME no seu registrador de domínio.

  7. Verifique a configuração personalizada de mapeamento de domínio no Document360.

NOTA

  • Essa atualização não causa nenhum tempo de inatividade. No entanto, recomendamos essa atualização durante seu horário de folga

  • Essa atualização é totalmente gratuita

Por favor, entre em contato com nossa equipe de suporte para obter assistência.


Configurando um domínio personalizado para domínios Apex

Ao configurar um domínio personalizado para o Document360, você pode querer usar seu domínio Apex (domínio raiz), como abc.com sem um subdomínio como www. Embora configurar subdomínios seja simples, configurar domínios Apex requer alguns passos extras, especialmente em relação a registros DNS.

O achatamento DNS é um método que permite usar um registro CNAME no nível do domínio Apex (raiz), que nem todos os registradores de domínio suportam. Se seu registrador não suportar achatamento DNS, você não poderá adicionar um registro CNAME para seu domínio Apex.

Configuração de Domínios Apex

Se seu registrador de domínio não suportar achatamento de DNS (por exemplo, GoDaddy), você pode optar por um provedor de DNS que suporte, como a Cloudflare. A Cloudflare oferece planos gratuitos que incluem achatamento de DNS, permitindo que você configure seu domínio personalizado para o domínio Apex com sucesso.

Por exemplo, digamos que você esteja usando o GoDaddy, que não suporta achatamento por DNS. Nesse caso, mudar para um provedor DNS como a Cloudflare permitirá que você adicione um registro CNAME para seu domínio Apex.

NOTA

Para mais informações, leia o artigo sobre o Flatting CNAME da Cloudflare.

Usando um certificado SSL personalizado

Use o certificado SSL fornecido pelo Document360 para seu domínio para garantir conexões seguras, pois ele oferece renovação automática e sem problemas para uma experiência tranquila. Forneça os seguintes detalhes para processar seu pedido de instalação de um certificado SSL personalizado:

  • Nome Comum (CN): O nome de domínio totalmente qualificado para o certificado.

  • Organização (O): O nome legal da sua organização.

  • Unidade Organizacional (OU): O departamento ou divisão dentro da sua organização.

NOTA

O certificado normalmente é válido por 90 dias. Você terá que renovar o certificado a tempo e nos fornecer o certificado atualizado para que possamos instalá-lo no seu domínio.


Solução de problemas

Verificação do domínio falhou

Se você estiver tendo problemas para verificar seu domínio personalizado, certifique-se de que o CNAME corresponda ao host do domínio.

7_Screenshot-Troubleshooting_invalid_record

Há chances de qualquer outro registro ser mapeado no lugar de CNAME (como registros AAAA). Isso também causaria um erro.

Sugestão: Para visualizar o CNAME do seu domínio e outras informações de DNS, use o Digwebinterface ou a busca DNS do Google, ou qualquer outra ferramenta de consulta de DNS disponível na web
9_Screenshot-Troubleshooting_digwebinterface

NOTA

Por razões de segurança, alguns registradores de domínio podem mascarar/restringir a descoberta dos registros DNS nas ferramentas de busca DNS. Um exemplo é a Cloudflare.
Nesses casos, você pode entrar em contato com seu registrador de domínio para mais informações.

Uma vez que o CNAME correto seja mapeado, pode levar até 24 horas para o mapeamento bem-sucedido.


Tempo de espera após a atualização dos registros DNS

Se a correspondência CNAME e o problema da verificação do domínio persistirem, o TTL (Time-To-Live) pode ser uma possível razão.

Se você estiver atualizando um valor de Registro DNS existente, pode levar um tempo para que o TTL configurado se reflita globalmente. Se o TTL for definido para 3600 para um registro DNS, pode levar até 1 hora (3600 segundos) para refletir o valor do registro DNS para o DNS Name server DNS globalmente.


Restrição CAA definida pelo registrador de domínio

Alguns registradores de domínio estabelecem uma restrição de que o certificado SSL deve ser provisionado por uma CA específica (Autoridade Certificadora).

Por exemplo, se um registro CAA tiver um valor de 0 emissão "letsencrypt.org", então somente o Let's Encrypt (CA) poderá gerar um certificado para o domínio personalizado específico. Outras Autoridades Certificadoras (como a DigiCert, no nosso caso) veriam essa configuração e negariam a geração de um certificado SSL.

Verifique se você tem algum registro CAA configurado na configuração DNS para o domínio personalizado.


Resolvendo o erro "Este site não pode ser alcançado" ao configurar um domínio personalizado

Erro: Este site não pode ser acessado

Esse erro geralmente ocorre quando o registro CNAME não é adicionado prontamente no seu DNS após ser gerado no Document360. Se houver um atraso, o CNAME pode expirar, levando a uma verificação de domínio falhada.

Outras causas possíveis incluem:

  • Atrasos na propagação do DNS

  • Entradas duplicadas do CNAME no seu DNS

  • Registros CAA ausentes para provedores SSL suportados como Let's Encrypt, DigiCert ou Google

Error message indicating the site cannot be reached with troubleshooting suggestions.

Passos para resolver:

  1. Verifique quando o CNAME foi configurado

    • Confirme se o registro CNAME foi adicionado ao seu DNS imediatamente após criá-lo no Document360.

    • Se não, o CNAME pode ter expirado.

  2. Remover e reconfigurar o domínio personalizado

    • Vá ao seu provedor de DNS e remova o registro CNAME existente.

    • Depois, no Document360, exclua a entrada de domínio personalizada existente.

    • Espere 15 minutos antes de prosseguir.

  3. Adicionar novamente o registro CNAME

    • Navegue até Configurações () > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.

    • No painel de navegação à esquerda, navegue até Domínio personalizado > Mapeamento de domínio Personalizado e crie o domínio personalizado novamente.

    • Copie imediatamente o registro CNAME e adicione-o ao seu provedor DNS com um TTL (Tempo de Vida) de 5 minutos.

    • Volte ao Document360 e clique em Verificar.

    • Espere alguns minutos para a configuração terminar.

  4. Verifique a propagação do DNS

    • As mudanças no DNS normalmente levam de 2 a 4 horas, mas em alguns casos até 24 horas.

    • Aguarde a propagação completa antes de verificar novamente o domínio.

  5. Verifique DNS usando a ferramenta Google Dig

    • Use a ferramenta Google Dig para verificar se seus registros de DNS estão aparecendo corretamente.

    • Procure por entradas duplicadas de CNAME com o mesmo nome de host. Se for encontrado, remova duplicatas.

  6. Verifique conflitos de registros da CAA

    • Use dnschecker.org para visualizar registros CAA do seu domínio.

    • Se algum registro CAA for configurado, certifique-se de que eles permitam que os provedores SSL do Document360:

Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360


Resolver erros como "Sua conexão não é privada" ou "Sua conexão não é segura" ao acessar o site da Knowledge Base

Esse erro normalmente ocorre pelos seguintes motivos:

  1. Questão: Certificado SSL expirado

  1. Verifique se o certificado SSL expirou.

  2. Visite o site da Knowledge Base e clique na opção Ver informações do site na barra de URL.

  3. Clique na Conexão é segura para visualizar os detalhes do certificado SSL.

B. Se o Certificado SSL não expirou, tente os passos de solução de problemas abaixo:

  1. Tente acessar o site por um navegador diferente para descartar problemas específicos do navegador.

  2. Desative todas as extensões do site no seu navegador e verifique novamente.

  3. Verifique se todos os usuários estão enfrentando o mesmo problema para identificar se é específico de cada usuário ou de todo o sistema.

  4. Limpe o cache do navegador ou troque para outro, pois isso geralmente resolve o problema.

C. Conexão VPN

  1. Desative sua VPN e tente acessar o site novamente:

  2. Se desativar a VPN resolver o problema, pode ser que a VPN esteja causando o problema.

  3. Entre em contato com sua equipe de TI para obter mais assistência.

D. Problema com registros DNS

Pode haver problemas com o resolver de DNS se os registros de DNS não forem atualizados com sucesso.

  1. Use um verificador de DNS (por exemplo, o Verificador de DNS) para verificar os registros DNS.

  2. Confirme se todos os registros foram atualizados corretamente.

  3. Se os registros não estiverem devidamente sincronizados, entre em contato com seu provedor de DNS ou registrador de domínio para garantir que a zona DNS esteja corretamente configurada e sincronizada para o domínio.

Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360


Resolvendo o erro "Conexão Segura Falhada - SSL_ERROR_NO_CYPHER_OVERLAP" ao configurar um domínio personalizado

Erro: Conexão Segura Falhada - SSL_ERROR_NO_CYPHER_OVERLAP

Esse erro geralmente indica que o certificado SSL não pôde ser emitido devido a uma incompatibilidade na configuração do CNAME. Se o domínio personalizado não apontar para o domínio correto do Document360, a validação SSL falha, resultando no erro.

Passos para resolver:

  1. Vá para dnschecker.org.

  2. Na barra de busca, insira seu domínio personalizado e selecione CNAME no menu suspenso.

  3. Verifique o resultado:
    O valor do CNAME deve corresponder exatamente ao CNAME fornecido no portal Document360 durante a configuração do domínio.

  4. Se o CNAME estiver incorreto:

    • Remova o domínio personalizado atual do seu projeto Document360.

    • Corrija o registro CNAME no seu provedor DNS adicionando o fornecido no Document360.

    • Espere alguns minutos, depois reconfigure o domínio personalizado no Document360 e verifique novamente.

Uma vez que o CNAME correto esteja no lugar e seja verificado, o certificado SSL será emitido com sucesso, resolvendo o erro.

DNS check results showing Google and other service locations with IP addresses.


Perguntas Freqüentes

Preciso de um certificado SSL para configurar um domínio personalizado?

O Document360 fornece automaticamente um certificado SSL para seu domínio personalizado quando você o mapeia ao seu projeto. Você não precisa comprar um certificado SSL adicional. No entanto, se você preferir usar seu próprio certificado SSL em vez do fornecido pelo Document360, entre em contato com nossa equipe de suporte no support@document360.com.

A URL personalizada do domínio vai aparecer no e-mail de convite enviado aos leitores?

Sim, se o e-mail de convite for enviado aos leitores depois que o domínio personalizado foi mapeado com sucesso, os links do e-mail apontarão para o domínio personalizado.

O que faço se o CNAME não for verificado após atualizar o DNS?

Se o CNAME não for verificado após atualizar o DNS, você terá que reconfigurar seu domínio personalizado.

  • Remova a configuração atual de domínio personalizado.

  • Readicione o domínio personalizado e atualize o CNAME no seu DNS.

  • Certifique-se de que o CNAME seja verificado para completar a configuração.

Posso configurar dois domínios personalizados para um único site de base de conhecimento?

Não, não é possível configurar dois domínios personalizados para um único site de KB. No entanto, você pode configurar um redirecionamento de um domínio para o outro. Dessa forma, os visitantes do primeiro domínio serão redirecionados para o segundo domínio.

Posso configurar múltiplos domínios para um único projeto no Document360?

Atualmente, o Document360 suporta apenas um domínio personalizado por projeto.

O que é um Domínio Nu?

Um domínio nu é um domínio que não inclui o prefixo "www". Por exemplo, se o domínio é example.com, isso é um domínio nu, enquanto www.example.com não é.

Por padrão, a maioria dos domínios terá o subdomínio "www", mas um domínio nu não yourcompany.com inclui esse subdomínio.

O que é um registrador de domínio?

Um registrador de domínios é uma empresa onde você compra e gerencia o domínio do seu site (por exemplo, GoDaddy, Namecheap ou Google Domains). É aqui que você atualiza as configurações do seu domínio personalizado para conectá-lo ao Document360.

O que é um registro CNAME?

Um registro CNAME (Nome Canônico) é um tipo de configuração de DNS (DNS, ou Sistema de Nomes de Domínio, é como o catálogo de endereços da internet, direcionando os usuários para o servidor web correto). O CNAME conecta seu domínio personalizado (por exemplo, help.yourcompany.com) a outro endereço, como o domínio padrão fornecido pelo Document360. Isso garante que, quando alguém digitar seu domínio personalizado, ele seja direcionado para o site da sua base de conhecimento.

Por que preciso atualizar para o novo balanceador de carga?

  • Ele implementa o offloading SSL, reduzindo a carga nos servidores e melhorando a segurança ao lidar com criptografia/descriptografia SSL no nível do balanceador de carga.

  • Inclui um firewall de aplicações web (WAF) para proteção contra ataques comuns na web, como injeção SQL e scripts cross-site.

  • Utiliza algoritmos dinâmicos de gerenciamento de tráfego para distribuição ótima do tráfego e desempenho aprimorado.

Recomendamos fortemente o upgrade para esta solução avançada para maior segurança e confiabilidade.

É possível criar um domínio separado para cada versão do meu projeto?

Não, atualmente não é possível atribuir domínios separados a versões individuais. Quando você cria uma nova versão, só pode personalizar o caminho dentro do domínio existente.

Mudar o domínio personalizado afetará o widget ou os links de artigos existentes?

Não, mudar o domínio da sua base de conhecimento não afetará a funcionalidade do widget.

  • O widget funciona usando um token de API, então continua funcionando mesmo após uma mudança de domínio.

  • Links de artigos no Document360 geralmente são relativos (por exemplo, /docs/article-name), então não quebram após a atualização do domínio.

  • No entanto, se você já usou URLs completas (por exemplo, https://yourproject.document360.io/docs/article-name), deve revisá-las e atualizá-las manualmente.

  • Como boa prática, use links relativos sempre que possível para evitar problemas ao atualizar o domínio.

Por que estou vendo o Erro Cloudflare 1014 – CNAME Cross-User Banido ao configurar meu domínio personalizado?

Isso acontece quando tanto o Document360 quanto seu domínio estão hospedados no Cloudflare. O Cloudflare impede registros CNAME entre diferentes contas Cloudflare.

Para resolver isso:

  1. Se você estiver em uma conta paga na Cloudflare, verifique se "Também prevenir subdomínios" (retenção de zona) está ativado. Desmarque temporariamente, espere o domínio verificar e então ative novamente.

  2. Se você estiver em uma conta gratuita da Cloudflare, o zone hold está desativado por padrão. Nesse caso:

    • Garanta que os registros CNAME sejam adicionados e propagados rapidamente (dentro de 7 dias após a geração dos registros no Document360).

    • Se a verificação falhar, remova o domínio personalizado do Document360 e reinicie a configuração.

    • Se os problemas continuarem, entre em contato com o suporte da Cloudflare, pois pode ser relacionado à cobrança (por exemplo, cartão vencido).

Adicionar um domínio personalizado muda o link do meu portal do Document360?

Não. A URL do portal (por exemplo, https://portal.us.aaa.document360.io/dashboard) permanece a mesma. O domínio personalizado se aplica apenas ao site da base de conhecimento, não ao portal de administração.