Principal 🚀Dicas importantes Como configurar um domínio personalizado com SSL na Central de Ajuda

Como configurar um domínio personalizado com SSL na Central de Ajuda

Última atualização em Apr 15, 2025

Com SSL, seus clientes podem acessar o portal da Central de Ajuda com segurança e sem qualquer risco de violação de dados. Fornecemos certificados SSL através do domínio Get a Hub para garantir a segurança da sua documentação de ajuda.

Vamos criar um portal de documentação de produtos para seudominio.com.br. Usaremos isso para o domínio personalizado docs.seudominio.com.br. Siga os passos abaixo:

Passo 1: Abra as configurações do seu Portal

Se estiver criando um novo portal, clique no botão “Novo Portal”.

Se você já possui um portal, clique em "Configurações" na barra lateral secundária da sua Central de Ajuda.

Passo 2: Configure o domínio personalizado

Encontre o campo “Domínio Personalizado” e preencha-o com o endereço desejado. Vamos supor que você esteja usando docs.seudominio.com.br.

Passo 3: Salve as configurações

Clique no botão "Criar" ou "Atualizar" para salvar suas configurações.

Passo 4: Configure o DNS

Em seguida, você precisa apontar seu domínio personalizado para seudominio.com.br. Para isso, abra seu servidor de nomes, acesse as configurações de DNS e adicione um novo registro CNAME.

Exemplo:
Adicione docs como um registro CNAME apontando para seudominio.com.br.

Estou usando o servidor de nomes Cloudflare

Você pode encontrar essa configuração na guia “DNS”.

Estou usando o servidor de nomes AWS

Você pode encontrar essa configuração no serviço Route53.

Se você estiver usando outro servidor de nomes, o processo será semelhante. Basta localizar as configurações de DNS e adicionar um registro CNAME. Ou pesquise por:
How to add CNAME record with your nameserver?

Isso garantirá que seu registro CNAME aponte para o servidor . Agora temos as informações do seu portal e o certificado SSL do seu domínio personalizado (por exemplo, docs.seudominio.com.br).


Obtendo um certificado SSL

O sistema fornece certificados SSL para todos os clientes em nuvem que configuram um domínio personalizado para o portal da Central de Ajuda.

Entre em contato com nosso suporte para solicitar seu certificado SSL e fornecer o registro do domínio personalizado. Como alternativa, envie-nos um e-mail com o assunto:
"Emitir certificação SSL para {Portal Slug}"

Nota: Precisamos de 1 a 2 dias úteis para configurar o certificado.

Depois disso, docs.seudominio.com.br estará ativo com uma conexão segura e os dados do seu portal estarão visíveis.


Como isso funciona?

Quando um cliente aponta seu domínio personalizado docs.seudominio.com.br para seudominio.com.br por meio de um CNAME, o DNS direciona para o site. No entanto, isso ainda precisa ser validado.

Quando um cliente acessa o endpoint docs.seudominio.com.br, o sistema valida o roteamento de docs.seudominio.com.br para seudominio.com.br adicionando um registro no painel do Heroku. Isso confirma o roteamento DNS do Heroku e o domínio personalizado.

Para configurar isso, vá até o painel do Heroku, acesse o app e navegue até:
Configurações → Domínios
Adicione um novo domínio como docs.seudominio.com.br.

Certificação via Cloudflare

Os clientes precisam:

  1. Apontar o domínio personalizado para seudominio.com.br via CNAME.

  2. Solicitar ao suporte a emissão do certificado SSL para o domínio.

  3. No painel da Cloudflare, adicionar um registro com validação HTTP e tipo de certificado "Fornecido pela Cloudflare".

  4. Aguardar a ativação do certificado SSL.

  5. Verificar o status do ACM no Heroku para docs.seudominio.com.br, que deve exibir "Ok" quando finalizado.


A funcionalidade de nome de host personalizado da Cloudflare fornece o certificado para o domínio personalizado adicionado.

  • docs.seudominio.com.br resolve pelo servidor de nomes do cliente e redireciona para seudominio.com.br.

  • O servidor seudominio.com.br certifica docs.seudominio.com.br.

  • As configurações de domínio do Heroku validam o certificado e as rotas para seudominio.com.br.

  • seudominio.com.br verifica o registro do portal com o domínio personalizado docs.seudominio.com.br.

  • Em seguida, redireciona para os registros do portal correspondentes ao domínio.