# Servidores de nombres propios

> Da a tus clientes servidores de nombres bajo tu propio dominio (ns1/ns2.tuagencia.com) que responden con los servidores DNS de OpenWAF.

Con servidores de nombres propios (de marca blanca), las zonas delegadas de tu organización publican
`ns1.tuagencia.com` y `ns2.tuagencia.com` en lugar de la pareja `*.ns.openwaf.dev`, y tus clientes ponen esos nombres
en sus registradores. Los nombres resuelven a los servidores DNS públicos de OpenWAF, así que nada más cambia.
Necesitas el rol `admin` en toda la organización.

## Configurarlos

1. **Declara los nombres.** En **Marca blanca › Servidores de nombres propios**, escribe el
   **Primer servidor de nombres** y el **Segundo servidor de nombres** (dos nombres distintos, por ejemplo
   `ns1.tuagencia.com` y `ns2.tuagencia.com`) y pulsa **Guardar servidores**.

   Desde la CLI: `openwaf-cloud ctl whitelabel nameservers ns1.tuagencia.com ns2.tuagencia.com --reason "…"`. Desde la
   API: `PUT /v1/orgs/{org}/whitelabel/nameservers` con `{"ns": ["ns1.tuagencia.com", "ns2.tuagencia.com"]}`.

2. **Demuestra que controlas el dominio.** Crea el registro TXT que se indica en el DNS de `tuagencia.com`:

   ```text
   _openwaf-ns.tuagencia.com.  TXT  "openwaf-ns-…"
   ```

   El valor es el token de tu organización; lo muestran el panel y `openwaf-cloud ctl whitelabel show`.

3. **Apunta los nombres a los servidores DNS de OpenWAF.** Crea registros `A` y `AAAA` para los dos nombres con las
   direcciones que muestra el panel (la API las devuelve en `required_ips`). Si el propio `tuagencia.com` está delegado
   en estos servidores de nombres, crea además **registros glue** con las mismas direcciones en el registrador de
   `tuagencia.com`.

4. **Actívalos.** Pulsa **Comprobar ahora** (`openwaf-cloud ctl whitelabel verify`, o
   `POST /v1/orgs/{org}/whitelabel/nameservers/verify`). OpenWAF comprueba el registro TXT y que los dos nombres
   resuelven a las direcciones requeridas; entonces el estado pasa a **Activo**.


## Qué cambia cuando están activos

- Todas las zonas delegadas de la organización publican tus servidores de nombres en sus registros `NS`.
- La [comprobación de la delegación](https://developers.openwaf.dev/es/dns/delegate-a-zone/#follow) acepta tus servidores de nombres además de la pareja
  `*.ns.openwaf.dev` de la organización, así que los dominios ya delegados siguen funcionando mientras tus clientes
  hacen el cambio.
- Los dominios nuevos muestran tus servidores de nombres en **Añadir dominio** y en **DNS › Configuración**.

Los nombres activos pertenecen a tu organización: ninguna otra puede reclamarlos. Siguen reservados para tu
organización **30 días** después de que dejes de usarlos (cambio, eliminación o baja de la organización), porque los
dominios de tus clientes pueden seguir delegados en ellos. Declarar nombres sin activarlos no reserva nada.

## Dejar de usarlos

Pulsa **Quitar servidores** (o `openwaf-cloud ctl whitelabel nameservers - --reason "…"`). Tus dominios vuelven a
publicar la pareja predeterminada. Pasa los dominios de tus clientes a la pareja predeterminada en sus registradores
**antes** de borrar los registros de tus servidores de nombres.