# Configuración efectiva

> El sitio que recibe un nombre en el borde, tal como lo reciben los nodos: ajustes de la zona y del nombre, origen, reglas y redirecciones.

La configuración efectiva de un nombre es el sitio que reciben los nodos de borde para él: los ajustes de la zona con los valores propios del nombre mezclados, su origen, las reglas de borde y de límite de peticiones que le llegan y sus reglas de redirección. Sale del mismo código que construye la configuración de los nodos, así que lo que ves es lo que se sirve.

**Panel**

Dominio → **Nombres** → **Configuración efectiva** junto al nombre. Los valores marcados como **Valor propio** están personalizados para el nombre; el resto se hereda del dominio.
**CLI**

```sh
openwaf-cloud ctl zones effective example.com api.example.com
```
**API**

```sh
curl -sS "https://dash.openwaf.dev/v1/orgs/$ORG/zones/example.com/hosts/api.example.com/effective" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"
```
**MCP**

`effective_config` con `{"zone": "example.com", "host": "api.example.com"}`.


Cualquier rol que pueda leer la zona puede leerla. La respuesta lleva la versión de la zona en `ETag`.

## La respuesta

```json
{
  "zone_id": "…",
  "host": "api.example.com",
  "proxied": true,
  "items": [
    {"pool": "", "variant": false, "site": {"domain": "api.example.com", "mode": "active", "waf_level": "high", "…": "…"}}
  ]
}
```

| Campo | Significado |
|---|---|
| `proxied` | Si el nombre tiene un registro con proxy. Con `false`, `site` es una vista previa de lo que recibiría el nombre, sin origen. |
| `items` | Una entrada por cada grupo de nodos de borde que sirve la zona. La mayoría de las zonas tienen una sola. |
| `site` | El sitio completo: ajustes del WAF, `upstream_url`, `rules` (IP, país, excepciones del WAF, reglas de límite por ruta), `rate_rules` (solo las activadas que se aplican al nombre), redirecciones, caché, control de rastreadores IA… |

Un nombre que no es la zona ni está por debajo recibe `404 host_not_in_zone`.
