Qué cambia
Normalmente tres direcciones y una clave: la URL del token en tu servidor, la etiqueta del script en tu página, la URL del webhook en el panel y las credenciales de Cnamio. Si tu código actual depende del objeto global, de los nombres de eventos o del encabezado de firma de otro servicio, pide el modo de compatibilidad al crear la aplicación y esos nombres siguen funcionando. Escribe a contato@cnamio.com.
1. Credenciales
Al registrarte recibes una aplicación de prueba y una de producción. Cada una tiene un applicationId (app_…) y un secreto (cnm_sk_…, se muestra una vez). Guárdalos donde están tus credenciales actuales, solo en el servidor.
2. Token de sesión en tu servidor
- POST https://<current service>/token { applicationId, secret }
+ POST https://api.cnamio.com/token { applicationId, secret }
# → 200 { "auth_token": "…" } valid for 60 minutes
Los campos opcionales domain, userId y dnsRecords atan la sesión a esos valores.
3. Ventana de conexión en el navegador
<script src="https://connect.cnamio.com/sdk/v1.js"></script>
cnamio.connectDomain({ applicationId, token, dnsRecords, prefilledDomain, userId, locale: 'pt' });
dnsRecords acepta type, host, value, ttl, priority y optional, con los marcadores {DOMAIN}, {SUBDOMAIN}, {SLD} y {TLD}. Tipos: A, AAAA, CNAME, TXT, MX y CAA, hasta 20 por conexión. Detalles en la documentación.
4. Webhooks
- Guarda la URL del webhook en el panel. Eventos:
domain.added,domain.propagation.timeouty, con el monitoreo,domain.records_missingydomain.records_restored. - Firma:
Cnamio-Signature: sha256=HMAC-SHA256 de"{timestamp}.{cuerpo crudo}", conCnamio-Timestamp. Rechaza marcas de tiempo de más de 5 minutos. - El botón "Enviar evento de prueba" del panel envía un
webhook.testfirmado para que compruebes tu código antes de cambiar.
Lista de verificación
applicationIdy secreto de Cnamio en el entorno del servidor- Pedido de token apuntado a
https://api.cnamio.com/token - Etiqueta del script cambiada a
https://connect.cnamio.com/sdk/v1.js - Un dominio de prueba conectado de punta a punta, guiado y automático
- URL del webhook guardada en el panel y firma verificada con un evento real
- Credenciales anteriores desactivadas tras una semana sin tráfico
Todavía no disponible
Cnamio conecta dominios y los monitorea. No emite certificados TLS, no aloja sitios ni vende dominios. Las opciones de configuración que no están en la documentación se ignoran sin error.