# Entorno y opciones globales

> Las variables de entorno y las opciones que entiende cualquier orden de openwaf-cloud ctl, y las opciones de las consultas y de los cambios.

## Entorno

| Variable | Significado |
|---|---|
| `OPENWAF_API_URL` | Dirección de la API: `https://dash.openwaf.dev`. También `--api`. Debe ser `http` o `https`, sin credenciales ni parámetros. Defínela siempre: el valor por defecto es una dirección local. |
| `OPENWAF_TOKEN` | El token de API (`owf_…`). |
| `OPENWAF_TOKEN_FILE` | Ruta de un fichero con el token, en su lugar. Debe ser un fichero normal, tuyo y sin permisos para el grupo ni para otros (`chmod 600`). Contiene solo el token o una línea `NOMBRE_TOKEN=valor` (admite el prefijo `export ` y comillas); se ignoran las líneas vacías y los comentarios `#`; debe haber exactamente un token. |
| `OPENWAF_ORG` | Organización por nombre o id. También `--org`. Por defecto, la del token. |

Define solo una de `OPENWAF_TOKEN` y `OPENWAF_TOKEN_FILE`. El token nunca se acepta como argumento y se oculta en los mensajes de error. Las órdenes que no llaman a la API con token, como `origin-tls ca`, no lo leen.

## Opciones de cualquier orden

| Opción | Significado |
|---|---|
| `--api <url>` | Dirección de la API; tiene prioridad sobre `OPENWAF_API_URL`. |
| `--org <nombre\|id>` | Organización; tiene prioridad sobre `OPENWAF_ORG`. |
| `-h`, `--help` | Imprimir el uso y las opciones de la orden. |

## Opciones de las consultas

| Opción | Significado |
|---|---|
| `--json` | Imprimir la respuesta de la API tal cual. |
| `--limit N`, `--before X` | Paginación, en las órdenes que listan historial (`zones history`, `audit`). `--before` recibe una versión o un id de entrada. |

## Opciones de los cambios

| Opción | Significado |
|---|---|
| `--reason "…"` | Obligatoria. De 1 a 500 caracteres, sin saltos de línea. |
| `--dry-run` | Solo simular. |
| `--yes` | No pedir confirmación (obligatoria sin terminal). |
| `--wait[=120s]` | Esperar a que todos los nodos de borde apliquen la versión nueva (cambios de zona). |

[Cambios: simulación y confirmación](https://developers.openwaf.dev/es/cli/changes/) explica cómo funcionan juntas y [Argumentos, salida y códigos de salida](https://developers.openwaf.dev/es/cli/output-and-exit-codes/), la sintaxis de los argumentos.