Gestionar registros DNS

Los registros se gestionan por zona. Para leerlos basta el rol readonly; para cambiarlos hace falta tech o superior. Cada cambio es una versión nueva con su motivo.

Los nombres de los registros se pueden escribir como @ (el apex), relativos (www) o completos con punto final (www.example.com.). Nombres y destinos se guardan en minúsculas y sin el punto final. En Tipos de registro y validación tienes el contenido de cada tipo.

#Listar registros

openwaf-cloud ctl records list example.com

curl "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE/records" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"

#Crear un registro

openwaf-cloud ctl records add example.com type=A name=www content=203.0.113.10 proxied=true --reason "Alta de www"
openwaf-cloud ctl records add example.com type=MX name=@ content=mx1.example.net priority=10 --reason "Correo"
openwaf-cloud ctl records add example.com type=TXT name=@ content="v=spf1 mx -all" comment="SPF" --reason "SPF"

curl -X POST "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE/records" \
  -H "Authorization: Bearer $OPENWAF_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Change-Reason: Alta de www" \
  -d '{"type": "A", "name": "www", "content": "203.0.113.10", "ttl": 3600, "proxied": true,
       "comment": "servidor web", "tags": ["prod"]}'

#Editar un registro

Solo cambian los campos que envías. Cambiar proxied en un registro A, AAAA o CNAME lo cambia en todos los de ese nombre.

openwaf-cloud ctl records set example.com www/A content=203.0.113.20 --reason "Servidor web nuevo"

curl -X PATCH "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE/records/$RECORD" \
  -H "Authorization: Bearer $OPENWAF_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Change-Reason: Servidor web nuevo" \
  -d '{"content": "203.0.113.20"}'

#Borrar un registro

Un registro borrado deja de resolver en cuanto se propaga el cambio. Borrar un registro con proxy deja de servir su sitio.

openwaf-cloud ctl records rm example.com antiguo/CNAME --reason "Sin uso"

curl -X DELETE "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE/records/$RECORD" \
  -H "Authorization: Bearer $OPENWAF_TOKEN" \
  -H "X-Change-Reason: Sin uso"

#Importar registros

En las zonas delegadas puedes traer registros de tres fuentes. En todas puedes revisar la lista y aplicar los registros elegidos como una sola versión.

• El DNS público actual. Al dar de alta una zona, OpenWAF copia sin proxy los registros que encuentra (y los nombres que aparecen en los registros públicos de certificados). Volver a buscar en el panel, o GET /v1/orgs/{org}/zones/{zone}/import, lista lo que aún no está en la zona.

• Un fichero de zona BIND (hasta 1 MiB) exportado de tu proveedor anterior: Importar en DNS › Registros, o la CLI. OpenWAF indica qué deja fuera y por qué (por ejemplo el SOA, los NS del apex o los tipos no admitidos).

  openwaf-cloud ctl records import example.com zona.txt --reason "Importación del proveedor anterior"

  Añade --proxied para importar con proxy los registros A, AAAA y CNAME. En la API, POST /v1/orgs/{org}/zones/{zone}/import/bind convierte el fichero en candidatos sin aplicar nada; aplica los que quieras conservar con un lote.

• Muchos registros desde un script: envíalos en un lote.

#Exportar registros

Exportar en DNS › Registros descarga la zona como fichero de zona BIND o CSV; con registros seleccionados, Exportar la selección exporta solo esos.

#A tener en cuenta

• Los registros NS del apex y el SOA los gestiona OpenWAF y no se pueden editar. Los registros NS por debajo del apex delegan un subdominio en otros servidores de nombres.
• Un CNAME sin proxy en el apex se publica como alias: OpenWAF resuelve el destino y responde con sus direcciones (aplanado de CNAME), así que puede convivir con registros MX y TXT.
• En una zona externa solo se pueden añadir registros A, AAAA y CNAME con proxy: el resto del DNS vive en tu proveedor.
• Los registros de una zona desactivada no se pueden cambiar (409 conflict).