# CLI

> openwaf-cloud ctl gestiona zonas, registros DNS, ajustes de borde, reglas y certificados desde la línea de órdenes, con simulación y confirmación en cada cambio.

`openwaf-cloud ctl` es el cliente de línea de órdenes de OpenWAF. Solo habla con la API pública con un token de API, así que tiene exactamente los permisos de ese token y pasa por la misma validación, el mismo versionado y la misma auditoría que el panel. Está pensada para operaciones automatizadas y repetibles: cada cambio lleva un motivo, se simula antes enseñando sus diferencias y puede esperar a que todos los nodos de borde lo apliquen.

```sh
export OPENWAF_API_URL=https://dash.openwaf.dev
export OPENWAF_TOKEN_FILE=~/.config/openwaf/token
openwaf-cloud ctl zones list
openwaf-cloud ctl zones set example.com waf_level=high --reason "Subir el nivel del WAF" --wait
```

- [Primeros pasos](https://developers.openwaf.dev/es/cli/get-started/): consigue la CLI, dale un token y ejecuta tu primera orden.
- [Cambios: simulación y confirmación](https://developers.openwaf.dev/es/cli/changes/): `--reason`, `--dry-run`, `--yes` y `--wait`.
- [Argumentos, salida y códigos de salida](https://developers.openwaf.dev/es/cli/output-and-exit-codes/): argumentos `clave=valor`, `--json` y qué significa cada código de salida.
- [Entorno y opciones globales](https://developers.openwaf.dev/es/cli/reference/options/): `OPENWAF_API_URL`, `OPENWAF_TOKEN`, `OPENWAF_TOKEN_FILE`, `OPENWAF_ORG`.
- [zones](https://developers.openwaf.dev/es/cli/reference/zones/): alta, consulta, ajustes, fusiones, vueltas atrás y borrado de zonas.
- [records](https://developers.openwaf.dev/es/cli/reference/records/): registros DNS, incluida la importación de ficheros BIND.


## Órdenes

| Familia | Qué cubre |
|---|---|
| [`zones`](https://developers.openwaf.dev/es/cli/reference/zones/) | Zonas, sus ajustes de borde, historial, diferencias, vueltas atrás, propagación y fusiones. |
| [`records`](https://developers.openwaf.dev/es/cli/reference/records/) | Registros DNS. |
| [`rules`](https://developers.openwaf.dev/es/cli/reference/rules/) | Reglas de borde: IP, país, excepciones del WAF y límites sencillos. |
| [`ratelimit`](https://developers.openwaf.dev/es/cli/reference/ratelimit/) | Límites de peticiones por ruta de una zona o de un nombre. |
| [`certs`](https://developers.openwaf.dev/es/cli/reference/certs/) | Certificados del borde y estado del certificado de cada sitio. |
| [`origin-certs` y `origin-tls`](https://developers.openwaf.dev/es/cli/reference/origin-certs/) | Certificados de origen de la OpenWAF Origin CA y TLS hacia el origen. |
| [`cache`](https://developers.openwaf.dev/es/cli/reference/cache/) | Purgas de caché. |
| [`ai`](https://developers.openwaf.dev/es/cli/reference/ai/) | Agentes y rastreadores de IA, MCP Shield, el catálogo de bots de IA y la preparación para agentes. |
| [`rum`](https://developers.openwaf.dev/es/cli/reference/rum/) | Medición de usuarios reales (Core Web Vitals). |
| [`dns`](https://developers.openwaf.dev/es/cli/reference/dns/) | Qué responde el DNS del borde para una zona delegada. |
| [`audit`](https://developers.openwaf.dev/es/cli/reference/audit/) | La auditoría de la organización. |
| [`clients`](https://developers.openwaf.dev/es/cli/reference/clients/) | Los clientes finales de una agencia. |
| [`brand`](https://developers.openwaf.dev/es/cli/reference/brand/) | La marca de la organización. |
| [`whitelabel`](https://developers.openwaf.dev/es/cli/reference/whitelabel/) | Tu propio dominio del panel y tus servidores de nombres. |

> **Nota: Mensajes en español**
>
> La CLI escribe su ayuda, sus tablas y sus mensajes en español. Las órdenes, las opciones, las claves y el JSON de `--json` son los mismos en cualquier idioma.