Gestión de Inquilinos
Gestión de Inquilinos es la página de nivel de sistema donde los administradores de plataforma aprovisionan y mantienen las organizaciones inquilinas. Cada inquilino es un espacio de trabajo aislado con sus propios usuarios, datos, micro-servicios y configuración. Los administradores del sistema usan esta página para crear inquilinos, ajustar límites de suscripción, gestionar proveedores OAuth y revisar métricas de salud.
Acceso a la Página
Sección titulada «Acceso a la Página»- Ruta:
/tenants - Ruta de Menú: Configuración → Sistema → Gestión de Inquilinos
- Audiencia principal: Solo administradores del sistema. Estas páginas se acceden mediante el inicio de sesión de administrador del sistema en
system.portal.net— no el portal del tenant.
Qué puedes hacer aquí
Sección titulada «Qué puedes hacer aquí»- Ver todas las organizaciones inquilinas con nombre, subdominio, estado, contacto y fecha de creación.
- Crear un nuevo inquilino con su identidad principal, nivel de suscripción y estado inicial.
- Ver la página de detalle completa del inquilino incluyendo métricas de salud, acceso a micro-servicios, proveedores OAuth, marca y facturación.
- Editar la configuración del inquilino como límites de suscripción, política de autenticación, modo de datos y configuración de cuentas externas.
- Eliminar un inquilino (eliminación suave — recuperable mediante el botón Mostrar Eliminados).
- Filtrar inquilinos por estado y nivel de suscripción; buscar por nombre o subdominio.
Tareas comunes
Sección titulada «Tareas comunes»- Abre Configuración → Sistema → Gestión de Inquilinos en
system.portal.net. - Usa el campo Buscar o el filtro de estado para localizar el inquilino objetivo.
- Haz clic en la acción Ver de una fila para abrir la página de detalle completa del inquilino.
- Desde la página de detalle, haz clic en Editar Configuración para actualizar los límites de suscripción o la configuración.
- Para crear un nuevo inquilino, haz clic en Crear Inquilino en el encabezado de la página y completa los campos requeridos.
- Guarda los cambios y verifica que el inquilino aparezca con el estado y subdominio esperados.
- El Subdominio se establece en la creación y no puede cambiarse después de guardar. Elígelo cuidadosamente — forma la URL del inquilino (ej.,
acme.portal.net). - Los inquilinos del sistema están marcados con un icono de escudo y no pueden eliminarse ni desactivarse. Se usan para la administración de la plataforma.
- Los inquilinos eliminados de forma suave están ocultos de la lista por defecto. Activa Mostrar Eliminados para verlos y restaurarlos.
- Cambiar el Modo de Datos de un inquilino de Independiente a Administrado reduce los permisos de los usuarios del portal en las categorías de datos gestionadas por ERP a solo lectura. Esto no puede revertirse automáticamente.
- El estado del inquilino afecta el acceso de los usuarios: solo los inquilinos Activos permiten el inicio de sesión completo de los usuarios.
- La pestaña Acceso a Microservicios por tenant en la página de detalle del tenant se oculta cuando Configuración del Sistema → Modo de Acceso a Microservicios está configurado como Todos los servicios activos para todos los tenants. En ese modo, cada microservicio activo se expone automáticamente a cada tenant y se omite la tabla de concesiones por tenant.
Crear un Inquilino
Sección titulada «Crear un Inquilino»Haz clic en Crear Inquilino en el encabezado de la página. Se abre un formulario de página completa con múltiples secciones para identidad, suscripción y configuración.
| Campo | Requerido | Tipo | Descripción | Predeterminado | Validación |
|---|---|---|---|---|---|
| Nombre del Inquilino | Sí | Texto | Nombre para mostrar de la organización inquilina | — | 2–100 caracteres |
| Subdominio | Sí | Texto | Identificador único de subdominio para la URL del inquilino | — | Solo letras minúsculas, números y guiones; 2–63 caracteres; disponibilidad verificada en tiempo real |
| Estado Inicial | No | Selección | Estado de activación al crear: Activo, Demo, Suspendido, Desactivado, Cancelado | Activo | — |
| Duración del Demo (Días) | No | Número | Número de días antes de que expire un inquilino Demo (solo visible cuando el Estado Inicial es Demo) | 30 | 1–365 |
| Nombre de Contacto | No | Texto | Persona de contacto principal del inquilino | — | — |
| Correo de Contacto | No | Correo electrónico | Dirección de correo del contacto principal | — | Formato de correo válido |
| Nivel de Suscripción | No | Selección | Plan: Gratis, Básico, Profesional, Empresarial | — | — |
| Máximo de Usuarios | No | Número | Número máximo de usuarios del portal permitidos | — | 1–10.000 |
| Máximo de Micro-Servicios | No | Número | Número máximo de micro-servicios que el inquilino puede habilitar | — | 0–100 |
| Vencimiento de Suscripción | No | Fecha | Fecha de vencimiento de la suscripción; dejar vacío para sin vencimiento | — | Debe ser una fecha futura |
| Permitir Inicio de Sesión Local | No | Interruptor | Habilitar inicio de sesión con usuario/contraseña además de OAuth | Apagado | — |
| Requerir Verificación de Correo | No | Interruptor | Requerir que los usuarios verifiquen su correo electrónico al primer inicio de sesión | Apagado | — |
| Inquilino Está Activo | No | Interruptor | Controla si el inquilino está activo y accesible | Encendido | — |
| Modo de Datos | No | Selección | Independiente (datos gestionados localmente) o Administrado (impulsado por ERP, solo lectura para usuarios del portal) | Independiente | — |
| Habilitar Cuentas Externas | No | Interruptor | Permite que las cuentas de clientes accedan al portal B2B | Apagado | — |
| Modo de Vinculación de Cuentas | No | Selección | Independiente o Vinculado a Socios Comerciales (usa direcciones de la API de BP) | Independiente | Visible solo cuando Cuentas Externas está habilitado |
| País | No | Selección | País principal para el cálculo de impuestos | — | — |
| Nombre del Contacto de Facturación | No | Texto | Nombre usado en las facturas | — | — |
| Correo del Contacto de Facturación | No | Correo electrónico | Correo para la correspondencia de facturación | — | Formato de correo válido |
| Configuración de Marca (JSON) | No | Área de texto | JSON opcional con colores personalizados, URLs de logo y título de la app | — | Formato JSON válido |
Pasos:
- Haz clic en Crear Inquilino en el encabezado de la página.
- Completa Nombre del Inquilino y Subdominio. Una verificación en tiempo real confirma que el subdominio está disponible.
- Opcionalmente establece el Estado Inicial — elige Demo e ingresa una Duración del Demo si es un inquilino de prueba.
- Completa los datos de contacto: Nombre de Contacto y Correo de Contacto.
- Configura Suscripción y Límites: selecciona un nivel de suscripción, establece el máximo de usuarios y micro-servicios, y opcionalmente fija una fecha de vencimiento.
- Configura Configuración del Inquilino: habilita el inicio de sesión local, la verificación de correo, o cambia el estado activo.
- Opcionalmente configura el Modo de Datos, las cuentas externas y la información de facturación.
- Haz clic en Crear. El sistema navega a la página de detalle del nuevo inquilino.
Editar un Inquilino
Sección titulada «Editar un Inquilino»Abre las acciones de fila de un inquilino y selecciona Ver para abrir la página de detalle, luego haz clic en Editar Configuración para actualizar la configuración. Alternativamente, haz clic directamente en el nombre del inquilino para ver la página de detalle.
Editar Configuración del Inquilino abre el mismo formulario que Crear Inquilino precargado con los valores actuales del inquilino, con Subdominio en solo lectura.
Mismos campos que Crear un Inquilino, con las siguientes diferencias:
- El Subdominio es de solo lectura después de la creación y no puede cambiarse.
- El Estado Inicial es reemplazado por los controles Estado e Inquilino Está Activo.
- Todos los demás campos son editables.
La tarjeta Configuración también expone un interruptor Modo de Usuario Estricto:
| Campo | Requerido | Tipo | Descripción | Predeterminado | Validación |
|---|---|---|---|---|---|
| Modo de Usuario Estricto | No | Interruptor | Cuando se habilita, los inicios de sesión SSO rechazan a usuarios desconocidos a menos que tengan una invitación pendiente. Recomendado. | Desactivado (editable). Forzado a Activado y deshabilitado para el tenant del sistema — el diálogo muestra “Siempre aplicado para el tenant del sistema” debajo de la etiqueta. | — |
Eliminar un Inquilino
Sección titulada «Eliminar un Inquilino»Abre las acciones de fila de un inquilino y selecciona Eliminar. Los inquilinos del sistema no pueden eliminarse y no mostrarán la acción Eliminar.
- Abre las acciones de fila (menú de tres puntos) en la fila del inquilino objetivo.
- Selecciona Eliminar.
- Lee la confirmación: “¿Está seguro de que desea eliminar [nombre]? El inquilino será desactivado y ocultado de la lista. Puede restaurarlo más tarde activando Mostrar Eliminados.”
- Haz clic en Eliminar Inquilino para confirmar — el inquilino se elimina de forma suave y se retira de la vista de lista predeterminada.
Para restaurar un inquilino eliminado:
- Activa el interruptor Mostrar Eliminados en la barra de filtros.
- Localiza el inquilino en la lista.
- Abre las acciones de fila y selecciona Restaurar.
Nota: Los inquilinos del sistema (marcados con el icono de escudo) no pueden eliminarse. La acción Eliminar está oculta para esas filas.
Páginas Relacionadas
Sección titulada «Páginas Relacionadas»- Claves API de Servicio — claves API de plataforma para autenticación servicio a servicio
- Precios de Modelos IA — precios por modelo usados en los cálculos de presupuesto de IA del inquilino