La marca blanca sustituye la identidad de OpenWAF por la de tu agencia. Tiene tres partes independientes, todas en Marca blanca y todas gestionadas por administradores de toda la organización:
| Parte | Qué ven tus clientes |
|---|---|
| Marca | Tu nombre, tu logotipo, tu color de acento y tu correo de soporte |
| Dominio del panel | El panel en dash.tuagencia.com, con tu marca |
| Servidores de nombres propios | ns1.tuagencia.com y ns2.tuagencia.com en lugar de *.ns.openwaf.dev |
Marca
La marca se usa:
- en el panel, cuando se abre en tu dominio del panel;
- en los correos de entrada que se envían desde ese panel;
- en los correos de la puerta de acceso de tus dominios;
- en la página de bloqueo con marca de tus dominios.
En Marca blanca › Marca, escribe el Nombre visible, el Color de acento (#rrggbb) y el Correo de soporte, y pulsa Guardar marca. En Logotipo, elige un fichero SVG o PNG y pulsa Subir logotipo.
openwaf-cloud ctl brand set name="Acme Digital" accent=#2456e8 [email protected] --reason "Marca"
openwaf-cloud ctl brand showSube el logotipo desde el panel o la API.
curl -X PUT "https://dash.openwaf.dev/v1/orgs/$ORG/brand" \
-H "Authorization: Bearer $OPENWAF_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Acme Digital", "accent": "#2456e8", "support_email": "[email protected]"}'
curl -X PUT "https://dash.openwaf.dev/v1/orgs/$ORG/brand/logo" \
-H "Authorization: Bearer $OPENWAF_TOKEN" \
-H "Content-Type: image/svg+xml" \
--data-binary @logo.svg- Nombre visible: hasta 100 caracteres, sin saltos de línea ni corchetes angulares.
- Color de acento:
#rrggbb. El panel avisa cuando el texto blanco de los botones no alcanzaría el contraste WCAG AA (4,5:1) sobre ese color. - Logotipo: SVG o PNG, hasta 256 KB (PNG de hasta 4096×4096 píxeles). Los SVG se sanean: se quitan scripts, manejadores de eventos y referencias externas, así que revisa el resultado tras subirlo. Guarda el nombre y el color antes que el logotipo.
Dominio del panel
Sirve el panel en un nombre de host que controles, por ejemplo dash.tuagencia.com.
En Marca blanca › Dominio propio del panel, escribe el Nombre de host y pulsa Guardar dominio. Usa un subdominio: un CNAME no puede estar en la raíz de un dominio.
En el proveedor de DNS de
tuagencia.com, crea el registro que se indica:dash.tuagencia.com. CNAME custom.openwaf.dev.Si tu proveedor de DNS ofrece un proxy para los registros (como la nube naranja de Cloudflare), desactívalo en este.
Pulsa Comprobar ahora. Cuando el CNAME resuelve, el estado pasa de Pendiente a Activo y OpenWAF emite el certificado HTTPS automáticamente (Let's Encrypt). No hay que subir nada.
Los mismos pasos desde la CLI: openwaf-cloud ctl whitelabel domain dash.tuagencia.com --reason "…" y después openwaf-cloud ctl whitelabel verify. En la API: PUT /v1/orgs/{org}/whitelabel/domain con {"host": "…"} y después POST /v1/orgs/{org}/whitelabel/domain/verify.
Cómo se comporta:
- En tu dominio solo se entra con el código por correo. Google y GitHub solo se ofrecen en
dash.openwaf.dev. - Los correos de entrada pedidos en tu dominio llevan tu marca solo para quien ya es miembro de tu organización; a cualquier otra persona le llega el correo estándar de OpenWAF. El enlace del correo abre siempre
dash.openwaf.dev; el código de 6 cifras sirve en cualquiera de los dos. - OpenWAF vuelve a comprobar el CNAME cada hora. Si ya no apunta a
custom.openwaf.dev, el dominio pasa a Error y deja de servir el panel hasta que corrijas el registro y lo compruebes de nuevo. - Un nombre de host dentro de un dominio activo de otra organización de OpenWAF se rechaza con
409 host_taken.
Para dejar de usarlo, pulsa Quitar dominio; después puedes borrar el CNAME.
Servidores de nombres propios
Da a tus clientes servidores de nombres con tu nombre. Hace falta un registro TXT de propiedad y registros de dirección en tu dominio: consulta Servidores de nombres propios.