Guía · migración

Llevando la conexión de dominios a Cnamio.

Cnamio sigue el patrón común de la categoría: un secreto en tu servidor, un token de sesión corto, una ventana en el navegador, registros con marcadores y webhooks firmados. Cambiar es, sobre todo, cambiar direcciones y claves.

Revisado el 18 de noviembre de 2026

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.timeout y, con el monitoreo, domain.records_missing y domain.records_restored.
  • Firma: Cnamio-Signature: sha256= HMAC-SHA256 de "{timestamp}.{cuerpo crudo}", con Cnamio-Timestamp. Rechaza marcas de tiempo de más de 5 minutos.
  • El botón "Enviar evento de prueba" del panel envía un webhook.test firmado para que compruebes tu código antes de cambiar.

Lista de verificación

  1. applicationId y secreto de Cnamio en el entorno del servidor
  2. Pedido de token apuntado a https://api.cnamio.com/token
  3. Etiqueta del script cambiada a https://connect.cnamio.com/sdk/v1.js
  4. Un dominio de prueba conectado de punta a punta, guiado y automático
  5. URL del webhook guardada en el panel y firma verificada con un evento real
  6. 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.