Dominios y conexiones DNS internas
El módulo administra la propiedad de hostnames y el acceso a zonas DNS autorizadas para NimoApps. Solo admite una sesión de usuario con rol OWNER/ADMIN vigente para la empresa activa. Las operaciones no están disponibles en claves API, OAuth de integraciones, clientes app, SDK público, MCP externo ni chat embebible.
Al registrar un hostname, el backend normaliza IDN a ASCII minúscula y entrega un desafío aleatorio TXT. La propiedad solo pasa a verificada al encontrar exactamente ese valor; un CNAME anterior no sirve. Tras la verificación, el desafío se elimina y el hostname se registra en el proyecto Pages antes de considerar lista la DNS. La misma operación vuelve a consultar el estado de Pages, por lo que propagación y TLS pendientes se pueden reintentar sin repetir el TXT. DNS solo se verifica con validación Pages activa y TLS solo cuando Pages, DNS y certificado están activos. Los fallos persisten como estados seguros; las restricciones CAA devuelven APP_DOMAIN_TLS_CAA_RESTRICTION. Los hostname activos son únicos en toda la plataforma, aunque un conflicto no revela el tenant que ya lo usa.
Retirada recuperable
Desconectar un dominio no es un simple cambio de estado. La retirada desactiva primero la ruta en el proveedor y espera confirmación, después borra únicamente los registros DNS que Nimobase creó (etiquetados por el proveedor) para ese hostname dentro de la zona que la empresa delegó, y recién al final libera el hostname. Los registros del cliente, los tipos que pertenecen al proveedor y cualquier zona no delegada nunca se tocan; si la conexión fue revocada, la limpieza se resuelve como omitida en lugar de adivinar.
Cada paso queda guardado antes de ejecutar el siguiente, así que un fallo a mitad es visible y reintentable: la API responde 503 con un código estable y el identificador de la operación, el hostname sigue reservado y repetir la baja reanuda desde el primer paso pendiente. Una retirada ya confirmada es idempotente y no vuelve a llamar al proveedor. Mientras el hostname esté reservado nadie puede reclamarlo, de modo que un fallo parcial no permite apropiación por terceros. La consulta GET /app-domains/:id/withdrawal muestra los pasos persistidos, si el hostname sigue reservado y si puede reintentarse, sin contactar al proveedor.
La transferencia reutiliza esos mismos pasos para la asignación anterior y después mueve el dominio a otro entorno de la misma empresa con un desafío TXT nuevo: la propiedad se vuelve a probar y un fallo deja el dominio en su entorno original, reintentable.
La conexión DNS recibe un token Cloudflare, comprueba acceso a la cuenta indicada y guarda el token cifrado mediante el vault AES-GCM compartido. Las respuestas muestran únicamente metadatos de la cuenta. La consulta de zonas usa la cuenta explícita, filtra cualquier respuesta de otra cuenta y vuelve a confirmar que la conexión siga activa. Revocar la conexión borra el ciphertext y separa los dominios vinculados de forma transaccional.
| Método | Ruta | Resultado |
|---|---|---|
| POST | /app-domains | Registra el hostname y devuelve la prueba TXT |
| GET | /app-domains | Lista dominios activos de la empresa actual |
| GET | /app-domains/:id | Consulta un dominio del tenant |
| POST | /app-domains/:id/ownership/verify | Verifica TXT y actualiza Pages, DNS y TLS |
| POST | /app-domains/:id/transfer | Retira la asignación anterior y emite una prueba nueva |
| GET | /app-domains/:id/withdrawal | Muestra pasos de retirada y si el hostname sigue reservado |
| DELETE | /app-domains/:id | Retirada recuperable; libera el hostname al confirmar |
| POST | /app-dns-connections | Valida y conecta una cuenta DNS |
| GET | /app-dns-connections | Lista metadatos seguros de conexiones |
| GET | /app-dns-connections/:id/zones | Devuelve las zonas autorizadas de esa cuenta |
| DELETE | /app-dns-connections/:id | Revoca el token y separa referencias activas |
| GET | /app-dns-connections/:id/zones/:zoneId/records | Lista registros con revisión y protección |
| POST | /app-dns-connections/:id/zones/:zoneId/records/preview | Revisa el diff sin escribir |
| POST | /app-dns-connections/:id/zones/:zoneId/records | Crea un registro permitido |
| PUT | /app-dns-connections/:id/zones/:zoneId/records/:recordId | Cambia el registro si la revisión coincide |
| DELETE | /app-dns-connections/:id/zones/:zoneId/records/:recordId | Borra si la revisión coincide |
Un apex de Pages requiere zona activa en la misma cuenta Cloudflare del proyecto y nameservers delegados a Cloudflare; el backend rechaza otra cuenta y explica el requisito. Un subdominio con DNS externa sí puede usar CNAME. El backend nunca administra nameservers, zonas ni DNSSEC: solo edita registros individuales dentro de una zona que la empresa delegó.
Edición revisada de registros DNS
La empresa puede crear, cambiar y borrar registros A, AAAA, CNAME, TXT, MX y CAA en una zona autorizada. Antes de escribir se valida el nombre contra la zona, el valor según el tipo, el TTL y la prioridad MX; un valor inválido devuelve un error estable y no produce ninguna escritura. Los registros NS, SOA y DNSSEC del proveedor se muestran como no editables y nunca se modifican, y tampoco se tocan otros registros (por ejemplo el correo existente) como efecto colateral.
Cada registro trae una revisión: un cambio o una baja solo se aplica si la revisión sigue siendo la revisada, así dos personas no se pisan. La vista previa devuelve el antes/después con el diff y no escribe nada, de modo que Nimo puede mostrar el cambio antes de confirmar. Repetir una misma alta o baja no duplica ni falla: converge sin escribir. Toda escritura aplicada devuelve el antes/después y su auditoría, y los registros creados desde Nimobase quedan marcados como propios.
El hostname de un dominio Pages y el TXT de verificación de propiedad están protegidos: se cambian desde la ficha del dominio, no desde la zona DNS. Nimo interno usa app-dns-connections.records.list|preview|create|update|delete con los scopes nimo:application-dns:records:read|write; nada de esto está disponible en widgets públicos, SDK público ni MCP externo.
Nimo interno consulta la preparación con app-domains.pages.readiness, que solo lee el estado guardado y devuelve ready con un único paso siguiente (PROVE_OWNERSHIP, REGISTER_IN_PAGES, RETRY_PAGES_REGISTRATION, WAIT_DNS_PROPAGATION, FIX_DNS_RECORDS, WAIT_TLS_ISSUANCE, FIX_TLS_CONFIGURATION o ACTIVE). ready exige propiedad, registro Pages, DNS y TLS verificados: un CNAME que resuelve no alcanza y un certificado fallido nunca activa el dominio. La propagación pendiente se reanuda repitiendo la lectura o la verificación de propiedad. También puede leer la retirada con app-domains.withdrawal.get, que expone los pasos durables y exige el scope interno nimo:application-domains:withdrawal:read. Ninguna de estas capacidades está disponible en widgets públicos, SDK público ni MCP externo.