Mapeamento personalizado de domínio

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, o que facilita para os usuários encontrarem e lembrarem do seu site.

Para editar o endereço web padrão,

1. Na barra de navegação da esquerda do seu portal da Base de Conhecimento, navegue até Configurações () > Site da base de conhecimento > Domínio personalizado.

2. Clique em Editar domínio no campo fornecido pelo Document360 .

   A janela de diálogo Editar subdomínio vai aparecer.

   

3. 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.

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

 NOTA

O domínio fornecido pelo Document360 e o domínio personalizado não podem coexistir.

Criando um domínio personalizado

Você pode fortalecer a identidade da sua marca e proporcionar uma experiência fluida para seus usuários mapeando um domínio personalizado para o site da sua base de conhecimento, substituindo a URL padrão do Document360 por um domínio totalmente seu. 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 DNS com Document360

3. Verifique o domínio no Document360

Adicionando um domínio personalizado no Document360

Para adicionar um domínio personalizado,

1. Na barra de navegação à esquerda do seu portal da Base de Conhecimento, navegue até Configurações () > Site da base de conhecimento > Domínio personalizado.

2. Clique em Adicionar domínio para adicionar um domínio personalizado para seu site de base de conhecimento.

   

3. Insira seu nome de domínio personalizado no campo Inserir seu domínio personalizado e clique em Visualizar configuração.

Seu domínio personalizado será adicionado com sucesso ao Document360.

Configure DNS com Document360

Depois de adicionar um domínio ao Document360, você precisará configurar seu DNS para o servidor do Document360.

Para isso, você terá que:

1. Configure o registro TXT no seu registrador de domínio

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

Configurando o registro TXT no seu registrador de domínio

Depois que o domínio for adicionado no Document360, você precisará configurar um registro TXT dentro do seu registrador de domínio para vincular seu domínio personalizado aos servidores do Document360.

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

2. Navegue até as configurações de DNS e clique em adicionar novo registro.

3. Selecione o tipo de Registro como Registro TXT no menu suspenso.

4. Insira os detalhes de Host e Valor/Destino do Document360 no seu registrador de domínio.

5. Depois, clique no ícone de Marcar para salvar as alterações.

6. Navegue até o Document360 e clique em Verificar. O status do registro TXT deve mudar de Pendente para Verificado.

 NOTA

A verificação de registros DNS no Document360 pode levar algum tempo para ser verificada.

Configure o registro CNAME no seu registrador de domínio

1. Clique em Adicionar novo registro e selecione o tipo de Registro como Registro CNAME.

2. Insira os detalhes do Host e do Valor/Destino do Document360 no registrador do domínio.

3. Depois, clique no ícone de Marcar para salvar as mudanças.

4. No Document360, o status do registro CNAME deve mudar de Pendente para Verificado.

Verificar configuração DNS

No Document360, o tipo de registro SSL é automaticamente provisionado após a verificação por DNS e pode levar algum tempo para ser configurado.

1. Clique em verificar Retentar.

2. Uma vez verificada com sucesso, uma mensagem de sucesso aparecerá e seu domínio personalizado será verificado e acessível.

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.

 NOTA

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

Atualize o título da aba do navegador após uma mudança de nome de domínio ou projeto

Mudar o nome do seu projeto ou domínio personalizado não atualiza automaticamente o título mostrado na aba do navegador. Para atualizar:

1. Navegue até  Configurações > Site da base de conhecimento > Personalização do site.

2. Clique no botão Personalizar site .

3. Expanda o cabeçalho e rodapé do site e selecione Home.

4. Clique no ícone de Configurações na página inicial.

5. Atualize o campo de Título SEO para refletir seu novo projeto ou nome de domínio.

6. Clique em Salvar.

 NOTA

Essa configuração pode exigir permissões de Proprietário ou Administrador. Se os campos estiverem desativados, entre em contato com um usuário com as permissões apropriadas para fazer essa alteração.

Registradores de domínio comum

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

• NameCheap - Artigo de suporte

• Domain.com - Artigo de apoio

• Google Domains - Artigo de suporte

• Dreamhost - Artigo de suporte

• Hover - Artigo de suporte

• GoDaddy - Artigo de suporte

• Cloudflare - Artigo de suporte

• Bluehost - Artigo de suporte

Problemas de mapeamento após o lançamento

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

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.

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.

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

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.

Erros de Registro TXT

Registro TXT não encontrado

Esse erro ocorre quando o Document360 não consegue detectar o registro TXT do seu domínio no registrador.

Passos para resolver:

1. Faça login no seu registrador de domínio e navegue até as configurações de DNS.

2. Adicione o registro TXT exatamente como mostrado no Document360:

   • Anfitrião: _doc360-verify. seguido pelo seu domínio

   • Valor: O código de verificação único exibido no Document360

3. Salve o registro e clique em Retentar verificação no Document360.

 NOTA

As alterações no DNS podem levar alguns minutos para se propagar. Se o registro foi apenas adicionado, espere alguns minutos antes de tentar novamente.

Incompatibilidade de registros TXT

Esse erro ocorre quando um registro TXT é encontrado, mas o valor não corresponde ao código de verificação gerado pelo Document360.

Passos para resolver:

1. Vá até as configurações de DNS do seu registrador de domínio.

2. Localize o registro TXT existente e _doc360-verify. verifique seu valor.

3. Compare com o valor exato mostrado no Document360.

4. Atualize o valor para corresponder exatamente — mesmo uma diferença de um caractere causará falha.

5. Salvar e clicar em Verificação de Retentativa.

Múltiplos registros TXT detectados

Esse erro ocorre quando existem mais de um registro de verificação TXT para o mesmo host, causando um conflito durante a verificação.

Passos para resolver:

1. Faça login no seu registrador de domínio e navegue até as configurações de DNS.

2. Procure por todos os registros TXT com o host _doc360-verify.

3. Exclua todas as entradas duplicadas, mantendo apenas aquela que corresponde ao valor mostrado no Document360.

4. Volte ao Document360 e clique em Retentar verificação.

Registro TXT não propagado

Esse erro ocorre quando o registro TXT foi adicionado corretamente, mas ainda não se propagou entre servidores DNS globalmente.

Passos para resolver:

1. Confirme que o registro TXT foi salvo corretamente no seu registrador.

2. Use a ferramenta de busca DNS do Google ou o Digwebinterface para verificar se o registro TXT está visível.

3. Espere alguns minutos e clique em Retentar verificação.

 NOTA

A propagação do DNS normalmente leva alguns minutos, mas às vezes pode demorar mais dependendo das configurações TTL do seu registrador.

Host TXT inválido

Esse erro ocorre quando o nome host do registro TXT foi inserido incorretamente no registrador.

Passos para resolver:

1. Faça login no seu registrador de domínio e localize o registro TXT.

2. Verifique se o host está configurado exatamente como mostrado no Document360 — deve começar por _doc360-verify.

3. Corrija o nome do host se ele for diferente e salve o registro.

4. Clique em Retentar verificação no Document360.

Erros CNAME

Registro CNAME não encontrado

Esse erro ocorre quando o Document360 não consegue detectar um registro CNAME para seu domínio após a verificação TXT ter sido aprovada.

Passos para resolver:

1. Faça login no seu registrador de domínio e navegue até as configurações de DNS.

2. Adicione um novo registro CNAME:

• Anfitrião: Seu domínio personalizado (por exemplo, help.yourcompany.com)

• Pontos para: O valor CNAME mostrado no Document360

3. Salve o registro e clique em Verificar Retentar.

 NOTA

A verificação CNAME só começa após a conclusão bem-sucedida da verificação da propriedade do TXT.

Alvo incorreto do CNAME

Esse erro ocorre quando existe um registro CNAME, mas está apontando para o destino errado em vez dos servidores do Document360.

Passos para resolver:

1. Vá até as configurações de DNS do seu registrador de domínio.

2. Localize o registro CNAME existente para seu domínio personalizado.

3. Atualize os Pontos para o valor correspondente exatamente ao alvo CNAME mostrado no Document360.

4. Salvar e clicar em Verificação de Retentativa.

O CNAME é proxiado (Cloudflare)

Esse erro ocorre quando o registro CNAME é roteado pelo proxy da Cloudflare, o que impede que o Document360 verifique corretamente o registro.

Passos para resolver:

1. Faça login na sua conta Cloudflare e navegue até as configurações de DNS do seu domínio.

2. Localize o registro CNAME do seu domínio personalizado.

3. Clique no ícone laranja do proxy ao lado do registro para mudar para apenas DNS (nuvem cinza).

4. Salve a alteração e clique em Retentar verificação no Document360.

 NOTA

O proxy da Cloudflare (nuvem laranja) intercepta a resolução DNS, o que bloqueia a verificação do Document360. Mudar para o modo apenas DNS é necessário para uma verificação bem-sucedida.

Propriedade não verificada (CNAME bloqueado pelo TXT)

Esse erro ocorre quando a verificação CNAME é tentada antes que a verificação de propriedade do TXT seja completa.

Passos para resolver:

1. Retorne à tabela de registros DNS no Document360.

2. Certifique-se de que o registro TXT foi adicionado corretamente no seu registrador.

3. Complete a verificação do TXT primeiro — a verificação CNAME só prosseguirá após a confirmação do TXT.

Erros SSL

Provisão SSL bloqueada

Esse erro ocorre quando o provisionamento SSL não pode iniciar porque a verificação DNS (TXT e CNAME) não foi concluída.

Passos para resolver:

1. Garanta que tanto os registros TXT quanto CNAME sejam verificados com sucesso no Document360.

2. Assim que ambos os registros apresentam status Verificado , o provisionamento SSL começará automaticamente.

Provisionamento SSL falhou

Esse erro ocorre quando o Document360 não consegue emitir um certificado SSL para seu domínio.

Passos para resolver:

1. Verifique se algum registro CAA no seu DNS está restringindo a emissão de SSL. Certifique-se de que as seguintes entradas estejam presentes:

   • @ IN CAA 0 issue digicert.com

   • @ IN CAA 0 issue letsencrypt.org

   • @ IN CAA 0 issue pki.goog

2. Adicione quaisquer entradas da CAA que faltem e clique em Verificação de Retentar.

3. Se o problema persistir, entre em contato com o suporte do Document360.

Ainda provisionamento SSL

Essa mensagem aparece quando a configuração do SSL está em andamento e ainda não foi concluída.

Passos para resolver:

1. Nenhuma ação é necessária — o provisionamento SSL é automático.

2. Espere alguns minutos e atualize a página para verificar o status atualizado.

3. Se o status não mudar após 15 minutos, clique em verificar Retentar.

Erros Gerais de Verificação

Verificação já rodando

Essa mensagem aparece quando uma tentativa de verificação já está em andamento.

Passos para resolver:

1. Aguarde o processo atual de verificação ser concluído.

2. Não clique em Retentar verificação enquanto a verificação estiver rodando — isso pode causar um conflito.

3. Quando o processo for concluído, revise o status de cada registro e tente novamente se necessário.

Verificação incompleta

Esse erro aparece quando algumas verificações de verificação foram aprovadas, mas outras falharam.

Passos para resolver:

1. Revise a tabela de registros DNS no Document360 — registros falhados serão destacados.

2. Corrija apenas os registros que mostram status de falha ou não verificado.

3. Registros que já foram aprovados não precisam ser reconfigurados.

4. Clique em Retentar verificação assim que os registros falhados forem corrigidos.

Erros padrão no domínio

Domínio já em uso

Esse erro aparece quando o subdomínio que você inseriu já está ocupado por outro projeto.

Passos para resolver:

1. Insira um nome de subdomínio diferente no campo.

2. O botão Atualizar será ativado assim que um nome disponível for inserido.

3. Clique em Atualizar para salvar a alteração.

Nome de domínio inválido

Esse erro aparece quando o subdomínio inserido contém caracteres não suportados.

Passos para resolver:

1. Certifique-se de que o subdomínio use apenas letras minúsculas e hífens.

2. Remova quaisquer caracteres especiais, espaços, letras maiúsculas ou hífens iniciais/finales.

3. Reintroduza o subdomínio corrigido e clique em Atualizar.

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

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:

     • @ NO CAA 0 edição digicert.com

     • @ NO CAA 0 edição letsencrypt.org

     • @ IN CAA 0 edição pki.goog

       Adicione essas entradas CAA ao seu DNS se estiverem faltando.

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.

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.