Saltar al contenido principal

DNS y Cloudflare

La célula DNS automatiza la creación y revocación de registros tipo A mediante la API v4 de Cloudflare.

Datos base​

Los adjuntos muestran esta configuración de referencia:

  • ZoneId
  • ZoneName
  • CellSubdomain
  • ApiToken
  • DefaultContent
  • RecordTtl
  • Proxied

Flujo general​

  1. El usuario solicita un subdominio desde el frontend.
  2. El backend persiste la intención en SQL Server.
  3. El backend llama a Cloudflare.
  4. Si Cloudflare responde bien, el registro queda Active.
  5. Si falla, el backend guarda el error para trazabilidad.

Endpoint del backend​

MétodoRutaUso
GET/api/me/dnsLista registros del usuario
POST/api/me/dnsCrea un registro
DELETE/api/me/dns/{id}Revoca un registro

Payload de creación​

{
  "label": "testdb",
  "content": "49.13.85.216",
  "recordTtl": 1,
  "proxied": false
}

Llamada manual a Cloudflare​

La forma equivalente manual del backend es una petición como esta:

curl -X POST "https://api.cloudflare.com/client/v4/zones/<zone-id>/dns_records" \
  -H "Authorization: Bearer <cloudflare-api-token>" \
  -H "Content-Type: application/json" \
  --data '{
    "type": "A",
    "name": "testdb",
    "content": "49.13.85.216",
    "ttl": 1,
    "proxied": false
  }'

Reglas importantes​

  • proxied: false crea DNS directo.
  • proxied: true pasa por el proxy de Cloudflare.
  • El backend debe mantener trazabilidad local del estado.
  • No se debe confiar solo en la respuesta del proveedor externo.

Cuando revisar esta página​

Usa esta doc junto con: