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.timeoute, com o monitoramento,domain.records_missingedomain.records_restored. - Assinatura:
Cnamio-Signature: sha256=HMAC-SHA256 de"{timestamp}.{corpo bruto}", comCnamio-Timestamp. Rejeite carimbos com mais de 5 minutos. - O botão "Enviar evento de teste" do painel manda um
webhook.testassinado para você conferir o seu código antes de trocar.
Lista de verificação
applicationIde segredo do Cnamio no ambiente do servidor- Pedido de token apontado para
https://api.cnamio.com/token - Tag do script trocada para
https://connect.cnamio.com/sdk/v1.js - Um domínio de teste conectado de ponta a ponta, guiado e automático
- URL do webhook gravada no painel e assinatura validada com um evento real
- 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.