Cloudflare API Security: How to update DNS without compromising your network

Cloudflare API Security: How to update DNS without compromising your network

Back to Blog

Para que una herramienta actualice tu DNS en Cloudflare necesita una credencial con permiso para hacerlo. Si esa credencial es demasiado poderosa o se filtra, el problema ya no es tu IP: es tu dominio. Esta guía explica cómo crear un token con los permisos mínimos y cómo guardarlo bien en Windows.

Token de API o clave global: usa el token

Cloudflare ofrece dos tipos de credencial. La clave global de API da acceso a toda tu cuenta: todos los dominios y casi todas las acciones. Un token de API se crea con permisos y alcance concretos, y se puede revocar sin tocar nada más. Para actualizar un registro DNS no hace falta más que un token que pueda editar el DNS de una zona. Si algún programa te pide la clave global, desconfía y busca la opción con token.

Crear un token con permisos mínimos

  1. En el panel de Cloudflare entra en tu perfil, apartado Tokens de API, y pulsa Crear token.
  2. Elige la plantilla Editar DNS de la zona o crea uno personalizado.
  3. En permisos deja solo Zona, DNS, Editar.
  4. En recursos de zona elige Incluir, Zona específica y selecciona únicamente el dominio que vas a sincronizar. No marques todas las zonas.
  5. Si quieres, añade una fecha de caducidad al token. Cuando venza tendrás que crear otro, pero limitas el daño si se pierde sin que lo sepas.
  6. Crea el token y cópialo en ese momento: Cloudflare solo lo muestra una vez.

Con ese token, quien lo robe podrá editar registros DNS de un solo dominio. No podrá borrar la zona, cambiar los servidores de nombres ni tocar otros dominios.

Un detalle con IP dinámica: no filtres por IP de origen

Cloudflare permite restringir un token a determinadas IP de origen. Es buena idea para un servidor con IP fija, pero con una IP dinámica juega en tu contra: cuando tu IP cambia, la petición para actualizar el DNS llega desde la IP nueva, que no está en la lista, y la actualización falla justo cuando más la necesitas. Si tu IP no es fija, protege el token con permisos mínimos y caducidad, no con filtro por IP.

Cómo comprobar el token

Cloudflare tiene un punto de la API para verificar un token. Desde PowerShell, sustituyendo el token por el tuyo:

Invoke-RestMethod -Uri https://api.cloudflare.com/client/v4/user/tokens/verify -Headers @{ Authorization = 'Bearer TU_TOKEN' }

Si es válido, la respuesta indica que el token está activo. No pegues ese comando con el token real en chats, foros ni capturas de pantalla.

Dónde guardar el token en Windows

  • Mejor: en un almacén cifrado por el sistema. SyncMyIP guarda las credenciales cifradas con DPAPI de Windows: el dato queda ligado a tu usuario y a tu equipo y no se puede leer en claro copiando el archivo a otro sitio.
  • Aceptable con cuidado: un archivo con el token protegido con permisos NTFS que solo lea tu usuario, fuera de carpetas sincronizadas con la nube.
  • Evítalo: escribirlo en el código, en un script que subes a un repositorio, en un correo, en un documento compartido o en variables de entorno de un equipo que usa más gente.

Qué hacer si se filtra

  1. Entra en Tokens de API y elimina el token comprometido, o usa la opción de regenerarlo para obtener un valor nuevo.
  2. Revisa el registro de auditoría de la cuenta y los registros DNS por si alguien ha cambiado algo.
  3. Crea un token nuevo con los mismos permisos mínimos y actualiza la herramienta que lo usaba.

Refuerza también la cuenta

Un token seguro no sirve de mucho si alguien entra en tu cuenta de Cloudflare. Activa la verificación en dos pasos, usa una contraseña única y no compartas el acceso. Y recuerda que el DNS apunta a tu casa: repasa también la seguridad de servidores caseros con IP dinámica y firewall.

Siguiente paso

Con el token listo, la configuración completa está en configurar Cloudflare DDNS en Windows 11. Si prefieres programar tú el cliente, tienes un ejemplo en cómo crear un cliente DDNS casero en Python. Y si usas la versión Pro de SyncMyIP, puedes recibir un aviso por Telegram o webhook cada vez que cambie tu IP.