Una agencia gestiona muchos clientes finales desde una sola organización. Los clientes son subcuentas dentro de la organización: cada dominio puede pertenecer a un cliente, y los miembros y tokens de API limitados a un cliente solo ven y gestionan los dominios de ese cliente. Los dominios de todos los clientes usan la misma pareja de servidores de nombres, así que todos tus clientes reciben las mismas instrucciones.
Crear un cliente
Necesitas el rol tech o superior, en toda la organización.
Abre Clientes › Nuevo cliente. Escribe el nombre y, si quieres, un Correo de contacto y una Nota interna (solo la ve tu organización).
openwaf-cloud ctl clients add "Zapatos Acme" [email protected] --reason "Cliente nuevo"curl -X POST "https://dash.openwaf.dev/v1/orgs/$ORG/clients" \
-H "Authorization: Bearer $OPENWAF_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Zapatos Acme", "contact_email": "[email protected]"}'Los nombres de cliente son únicos dentro de la organización (hasta 200 caracteres, sin comas ni saltos de línea); las notas admiten hasta 2000 caracteres. Los administradores pueden editar y borrar clientes.
Asignar un dominio a un cliente
Elige el cliente al añadir el dominio, o cámbialo después. La asignación es un cambio versionado de la zona. Necesitas el rol tech o superior, en toda la organización.
Abre el Resumen del dominio, busca Cliente, elige el cliente y pulsa Cambiar el cliente.
openwaf-cloud ctl zones set-client example.com "Zapatos Acme" --reason "Es de Zapatos Acme"
openwaf-cloud ctl zones set-client example.com - --reason "Sin cliente"curl -X PATCH "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE" \
-H "Authorization: Bearer $OPENWAF_TOKEN" \
-H "Content-Type: application/json" \
-H "X-Change-Reason: Es de Zapatos Acme" \
-d '{"client_id": "'"$CLIENT"'"}'Envía {"client_id": null} para dejarlo sin cliente.
add_zone acepta un client_id (consulta list_clients) al dar de alta el dominio.
Dar de alta muchos dominios a la vez
Alta en bloque crea un dominio delegado por línea a partir de una lista pegada o de un fichero CSV:
domain,client
example.com,Zapatos Acme
example.org,Zapatos Acme
example.net- Cada línea es
dominio[,cliente]; la cabeceradomain,clientes opcional y#empieza un comentario. - Si una línea nombra un cliente que no existe, se crea.
- Las líneas son independientes: una que falla (por ejemplo con
zone_exists) no detiene las demás, y el resultado muestra lo ocurrido en cada línea. - Hasta 1000 dominios por subida. En subidas de hasta 50 dominios se importan además los registros públicos de cada uno; en las mayores, búscalos después desde los registros de cada dominio.
El equivalente en la API es POST /v1/orgs/{org}/zones/bulk con el CSV como cuerpo de la petición.
Dar acceso a la gente de un cliente
Invita a un miembro limitado al cliente o crea un token de API limitado a él. Los miembros y tokens limitados a un cliente solo pueden tener el rol tech o readonly. Con ese alcance:
- solo ven los dominios de su cliente, y los dominios que añaden quedan asignados a él;
- no ven la lista de miembros de la organización, otros clientes ni los tokens ajenos;
- con
tech, pueden leer la auditoría de los dominios de su cliente.
Consulta Miembros del equipo y Tokens de API.
Borrar un cliente
Los administradores pueden borrar un cliente que no tenga dominios. Pasa antes sus dominios a otro cliente (o a ninguno); si no, el borrado se rechaza con 409 client_has_zones. Los miembros, invitaciones y tokens de API limitados al cliente se borran con él.
Tu marca
Muestra la marca de tu agencia en lugar de la de OpenWAF, abre el panel en tu propio dominio y da a tus clientes servidores de nombres con tu nombre: consulta Panel de marca blanca.