Guia · migração

Levando a conexão de domínios para o Cnamio.

O Cnamio segue o padrão comum da categoria: um segredo no servidor, um token de sessão curto, uma janela no navegador, registros com marcadores e webhooks assinados. Trocar é, em grande parte, trocar endereços e chaves.

Revisado em 18 de novembro de 2026

O que muda

Normalmente três endereços e uma chave: o endereço do token no servidor, a tag do script na página, o endereço do webhook no painel e as credenciais do Cnamio. Se o seu código atual depende do objeto global, dos nomes de eventos ou do cabeçalho de assinatura de outro serviço, peça o modo de compatibilidade ao criar a aplicação e esses nomes continuam funcionando. Escreva para contato@cnamio.com.

1. Credenciais

No cadastro você recebe uma aplicação de teste e uma de produção. Cada uma tem um applicationId (app_…) e um segredo (cnm_sk_…, mostrado uma vez). Guarde os dois onde ficam as credenciais atuais, só no servidor.

2. Token de sessão no servidor

- POST https://<current service>/token   { applicationId, secret }
+ POST https://api.cnamio.com/token        { applicationId, secret }
# → 200 { "auth_token": "…" }  valid for 60 minutes

Os campos opcionais domain, userId e dnsRecords prendem a sessão a esses valores.

3. Janela de conexão no navegador

<script src="https://connect.cnamio.com/sdk/v1.js"></script>
cnamio.connectDomain({ applicationId, token, dnsRecords, prefilledDomain, userId, locale: 'pt' });

dnsRecords aceita type, host, value, ttl, priority e optional, com os marcadores {DOMAIN}, {SUBDOMAIN}, {SLD} e {TLD}. Tipos: A, AAAA, CNAME, TXT, MX e CAA, até 20 por conexão. Detalhes na documentação.

4. Webhooks

  • Grave o endereço do webhook no painel. Eventos: domain.added, domain.propagation.timeout e, com o monitoramento, domain.records_missing e domain.records_restored.
  • Assinatura: Cnamio-Signature: sha256= HMAC-SHA256 de "{timestamp}.{corpo bruto}", com Cnamio-Timestamp. Rejeite carimbos com mais de 5 minutos.
  • O botão "Enviar evento de teste" do painel manda um webhook.test assinado para você conferir o seu código antes de trocar.

Lista de verificação

  1. applicationId e segredo do Cnamio no ambiente do servidor
  2. Pedido de token apontado para https://api.cnamio.com/token
  3. Tag do script trocada para https://connect.cnamio.com/sdk/v1.js
  4. Um domínio de teste conectado de ponta a ponta, guiado e automático
  5. URL do webhook gravada no painel e assinatura validada com um evento real
  6. Credenciais antigas desligadas depois de uma semana sem tráfego

Ainda não disponível

O Cnamio conecta domínios e os monitora. Ele não emite certificados TLS, não hospeda sites e não vende domínios. Opções de configuração que não estão na documentação são ignoradas sem erro.