Crear un Tenant
Crear un tenant aprovisiona todo lo necesario para que sea utilizable de inmediato: su propio realm de identidad, su primera empresa, un rol de Administrador que cubre todos los productos y el primer usuario administrador asignado a ese rol. Cuando el asistente finaliza, ese administrador puede iniciar sesión en los productos de Beak de inmediato — no se requiere ningún paso de configuración adicional.
Antes de comenzar
Necesita acceso de administrador de plataforma a la consola de administración, y tener a mano lo siguiente:
- Identidad del tenant — El nombre para mostrar y un slug compatible con URL.
- Métodos de inicio de sesión — Si el tenant permite contraseñas locales, SSO o ambos.
- Primera empresa — El nombre de la organización a la que pertenecen los usuarios del tenant.
- Primer administrador — Nombre, correo electrónico y una contraseña inicial.
Crear el tenant
Abra Tenants y haga clic en New Tenant. El asistente consta de cuatro pasos.
1. Identidad
| Campo | Notas |
|---|---|
| Nombre para mostrar | El nombre del tenant tal como aparece en toda la consola. |
| Slug | Identificador compatible con URL, derivado automáticamente del nombre para mostrar hasta que se edite. Se utiliza en la URL de inicio de sesión del tenant y en su realm de identidad, por lo que no puede cambiarse después. |
| Dominio personalizado | Opcional. El nombre de host en el que se sirve la página de inicio de sesión personalizada del tenant. |
| Beak AI Tenant ID | ID numérico opcional utilizado por los servicios de Beak AI de nivel inferior. |
2. Autenticación
Elija qué métodos de inicio de sesión permite el tenant:
- Contraseña local — Los usuarios inician sesión con credenciales almacenadas en el propio realm de identidad del tenant.
- SSO — Los usuarios se federan a través de un proveedor de identidad externo. Al seleccionar esta opción, también se solicita la ruta de redirección del IdP.
Puede seleccionar ambos, en cuyo caso cada usuario se marca como local o SSO individualmente en el momento de su creación. Esta elección también determina si el asistente solicita una contraseña de administrador en el paso 4.
3. Empresa
Cada tenant necesita al menos una empresa. Las empresas delimitan el alcance de los usuarios y roles de un tenant, por lo que el tenant no puede tener usuarios hasta que exista una.
| Campo | Notas |
|---|---|
| Nombre de la empresa | Obligatorio. Se predetermina al nombre para mostrar del tenant, que es el caso habitual para un tenant de una sola empresa. |
| Descripción | Opcional. |
| Dominios de correo electrónico | Opcional, separados por comas. Enruta una dirección de correo electrónico de inicio de sesión al proveedor de identidad de esta empresa — un usuario que ingrese someone@acme.com se asocia a la empresa que reclama acme.com. |
Junto con la empresa, Beak crea un rol de Administrador con alcance en ella, que otorga acceso a todos los productos registrados actualmente en la plataforma. El administrador del siguiente paso recibe este rol.
4. Administrador de la aplicación
El primer administrador del tenant.
| Campo | Notas |
|---|---|
| Nombre / Apellido | Obligatorio. |
| Correo electrónico | Obligatorio. Esta es su identidad de inicio de sesión y lo que Beak registra como administrador de la aplicación del tenant. |
| Contraseña | Obligatoria solo cuando el tenant permite el inicio de sesión local. Compártala de forma segura; el administrador debe cambiarla en el primer inicio de sesión. Se oculta para un tenant solo con SSO, donde el proveedor de identidad gestiona la credencial. |
Haga clic en Create tenant. Todo lo anterior se aprovisiona como una unidad única — si alguna parte falla, no se crea nada, por lo que puede corregir los datos e intentarlo de nuevo.
Qué se crea
- Tenant — Con su propio realm de identidad y cliente de inicio de sesión.
- Configuración predeterminada — Bases de personalización de marca, política de seguridad y MFA que puede ajustar después.
- Primera empresa — Incluida su organización en el backend de identidad.
- Rol de Administrador — Con alcance en esa empresa, que cubre todos los productos registrados.
- Administrador de la aplicación — Un usuario en el tenant, en esa empresa, que posee el rol de Administrador.
Administrador de la aplicación vs. administrador de IAM
Estas son dos cosas diferentes y la distinción es importante:
- Administrador de la aplicación — Un usuario dentro del tenant. Tiene derechos de administrador en todos los productos de Beak del tenant e inicia sesión a través de la página de inicio de sesión del tenant. Este es quien crea el asistente.
- Administrador de IAM — Mostrado como
Tenant Adminen las páginas de Usuarios y Administradores. Un usuario de la consola que gestiona la configuración del tenant en la propia consola de administración de Beak IAM.
El administrador creado por el asistente es un administrador de la aplicación. Si esa persona también necesita acceso a la consola de administración de IAM, créela por separado en la página Administrators.
Cambiar el administrador de la aplicación
Abra la página de detalles del tenant y edite la tarjeta Application Admin. Ingrese la dirección de correo electrónico de un usuario existente en ese tenant y guarde — los derechos de administrador siguen a esa dirección la próxima vez que el usuario inicie sesión.
Nota: Esto no crea un usuario. La dirección debe coincidir con alguien ya aprovisionado en la página Users. Úsela solo para transferir el rol a un usuario existente diferente.
Después de crear el tenant
- Agregar usuarios — En la página Users, asignando cada uno a una empresa y uno o más roles.
- Refinar roles — Ajuste el rol de Administrador, o agregue roles más específicos, en la página Roles.
- Personalizar la página de inicio de sesión — Consulte Login Branding & Custom Domains.
- Elegir cómo se abren los productos — En una nueva pestaña del navegador o en la actual. Consulte Product Launch Behavior.
- Agregar empresas — Si el tenant cubre más de una organización.
Solución de problemas
| Síntoma | Causa |
|---|---|
Tenant slug already exists | El slug ya está en uso. Los slugs son únicos en toda la plataforma. |
| El nombre de la empresa se reporta como ya en uso | Otra empresa en este tenant ya tiene ese nombre. |
| La contraseña es rechazada | No cumple con la política de contraseñas del realm. El mensaje indica el motivo. |
| Un error del proveedor de identidad | No se pudo acceder al backend de identidad. No se creó nada — intente de nuevo cuando esté disponible. |
| El rol de Administrador no muestra productos | Aún no hay productos registrados en la plataforma. Regístrelos en Role Services y luego edite el rol para incluirlos. |
Mejores Prácticas
- Mantenga el slug estable — Está integrado en la URL de inicio de sesión del tenant y en el realm de identidad, y no puede cambiarse después de la creación. Acuérdelo antes de comenzar.
- Use una empresa por organización — Agregue una segunda empresa solo cuando el tenant cubra genuinamente organizaciones separadas, ya que las empresas delimitan tanto a los usuarios como a los roles.
- Configure los dominios de correo electrónico desde el principio — Controlan el enrutamiento de inicio de sesión de correo electrónico a organización, y agregarlos después implica volver a probar ese enrutamiento.
- Trate la contraseña inicial como temporal — Compártala a través de un canal seguro y haga que el administrador la cambie en el primer inicio de sesión.
- Revise el rol de Administrador después de agregar productos — Captura los productos registrados en el momento de la creación; los productos recién registrados no se agregan retroactivamente.
- Mantenga deliberados los roles de administrador de la aplicación y administrador de IAM — Otorgue acceso a la consola de IAM solo a las personas que administran la configuración del tenant, no a todos los administradores de productos.