Ir al contenido

Gestionar tenants

La página Tenants es donde se crean, revisan, editan y eliminan los tenants de identidad de un workspace. Ábrala desde Tenants en la barra lateral.

Todos los miembros del workspace pueden abrir la página. Solo los Admin pueden crear, editar o eliminar un tenant.

El título de la página es Tenants, con la descripción “Create, monitor, and manage identity tenants for this workspace.” (Cree, supervise y gestione los tenants de identidad de este workspace.) Es una sola página con secciones apiladas, de arriba abajo:

  1. Un banner de periodo de prueba, solo cuando corresponde. Consulte Estado de los tenants.
  2. Create a tenant: tres tarjetas.
  3. Tenant topology: una imagen en directo de los tenants.
  4. Manage existing tenants: la tabla Tenant overview.
Tarjeta Subtítulo Guía
Okta Workforce identity Conectar Okta
Auth0 Customer identity Conectar Auth0
Entra ID Microsoft ecosystem Conectar Microsoft Entra ID

Los Admin eligen Connect en una tarjeta. Los Member y los Viewer ven “Only workspace admins can create tenants.” (Solo los administradores del workspace pueden crear tenants.) y un botón Admin Access Required deshabilitado en cada tarjeta.

Cada plan permite un número de tenants por workspace.

Plan Tenants por workspace
Pro 3
Max 10
Super 25

La página Tenants no le avisa cuando el workspace ha llegado al límite, y los botones Connect siguen activos. Usted se entera del límite al enviar el formulario de creación: “Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” (No se ha podido crear el tenant: el plan permite hasta N tenants por workspace, y este workspace ya tiene M. Suba de plan para añadir más.) Elimine un tenant o suba de plan. Consulte Planes y facturación.

La tarjeta Manage existing tenants (“Review configured tenants, update integrations, and remove tenants when decommissioning access.”, es decir, revise los tenants configurados, actualice las integraciones y quite tenants al retirar el acceso) contiene la tabla Tenant overview.

Control Qué hace
Search tenants… Filtra por nombre o tipo de tenant. La tabla vuelve a la página 1.
Cabeceras de columna Name, Type, Created Seleccione una cabecera para ordenar. Selecciónela de nuevo para invertir el orden.
Distintivo Type Muestra okta, auth0 o microsoft. Un tenant de Entra ID aparece como microsoft.
Columna Actions Botones de icono, descritos más abajo.
Botones de página, Previous page, Next page La tabla muestra 5 tenants por página. El pie muestra Showing X to Y of N tenants.

Las acciones son botones de icono con un texto emergente (tooltip). No hay ningún botón de texto ni ningún menú.

Icono Tooltip Se muestra en Quién puede usarlo
Lápiz Edit Todas las filas Los Admin. Los demás ven el tooltip “Admin access required to edit tenant” (Se requiere acceso de administrador para editar el tenant) y un botón deshabilitado.
Gráfico de líneas API Metrics Solo las filas de Auth0 Todos. Consulte Métricas de la API de Auth0.
Papelera Delete tenant Todas las filas Los Admin. Los demás ven el tooltip “Admin access required to delete tenant” (Se requiere acceso de administrador para eliminar el tenant) y un botón deshabilitado.
Qué ve Significado
No tenants added yet con “Add a tenant using the options above to get started.” (Todavía no se ha añadido ningún tenant. Añada uno con las opciones de arriba para empezar.) El workspace no tiene tenants.
No tenants match your search con “Try a different name or tenant type.” (Ningún tenant coincide con su búsqueda. Pruebe con otro nombre u otro tipo de tenant.) El cuadro de búsqueda deja fuera todos los tenants.

La tarjeta Tenant topology (“Animated view of tenant integrations connected to the Identiguard control plane.”, es decir, una vista animada de las integraciones de tenants conectadas al plano de control de Identiguard) es una imagen, no un control. No se puede seleccionar nada en ella, y no tiene leyenda ni tooltips.

Elemento Significado
Cabecera “Avg requests per minute per tenant (last 24h)” (media de solicitudes por minuto por tenant, últimas 24 h) Lo que miden las etiquetas de los tenants
Distintivo Live view (verde) o Refreshing… Si las cifras están cargadas o cargándose
Nodo central Identiguard, “N connected tenant(s)”, “control plane” El workspace, con el número de tenants
Un nodo de color por tenant, con su nombre y “X req/min” El tenant y su tráfico
Nodo Alex AI arriba a la derecha El estado del servicio Ask Alex: “AI service · Online” (verde), “AI service · Offline” (rojo) o “AI service · Checking…” (ámbar). Muestra “Last seen <hora>” (visto por última vez) cuando se conoce.
“+N more tenants not shown in this preview.” (N tenants más no se muestran en esta vista previa.) La imagen dibuja 12 tenants como máximo
“No connected tenants to display yet.” (Todavía no hay tenants conectados que mostrar.) El workspace no tiene tenants

La topología no es una vista de estado. Un tenant con credenciales rotas se ve igual que uno en buen estado, salvo que puede mostrar “0 req/min”. Consulte Estado de los tenants.

Elija el icono de lápiz (Edit) de una fila para abrir Edit Tenant. Solo los Admin pueden abrirla.

La página tiene una o dos tarjetas:

  • Tenant Configuration (“Update tenant details, subscriptions, and monitoring preferences.”, es decir, actualice los detalles, las suscripciones y las preferencias de monitorización del tenant), con los botones Save Changes y Cancel. La tienen todos los proveedores.
  • Credentials, con su propio botón Validate & save credentials. Solo Okta y Entra ID.

Save Changes guarda todo lo que hay en Tenant Configuration. El botón muestra Saving… mientras trabaja. Si todo va bien, vuelve a la página Tenants. Si falla, aparece un banner titulado Error en la parte superior de la página Edit. Back to Tenants y Cancel salen sin guardar.

Secciones por proveedor:

Sección Okta Auth0 Entra ID
Basic Details Sí Sí Sí
Event Subscriptions Sí Sí Sí
Reporting permissions (optional) No No Sí
Agent Monitoring Sí No No
Tarjeta Credentials Sí No Sí

Todos los proveedores tienen Tenant Name y Customer Name (texto de ejemplo “Select or type a customer”, con sugerencias del workspace). El nombre del tenant sigue las mismas reglas que en la creación: obligatorio, 100 caracteres como máximo, sin saltos de línea.

No se puede cambiar el dominio ni el directorio de un tenant, con ningún proveedor. Elimine el tenant y créelo de nuevo.

Okta añade:

  • Environment: Production o Development.

Entra ID añade:

  • Poll Interval (Minutes): de 5 a 1440 (24 horas). El formulario de creación se detiene en 60, así que aquí es donde se define un intervalo más largo.

Auth0 muestra valores de solo lectura:

Elemento Qué muestra
Auth0 Domain El dominio del tenant
Provisioning Manual o Deployed via Terraform
Log stream endpoint Solo la URL del endpoint. El token no se vuelve a mostrar nunca.
Texto “Identiguard stores no Auth0 API credentials for this tenant.” (Identiguard no almacena credenciales de la API de Auth0 para este tenant.) El log stream se gestiona en el panel de Auth0 o en su configuración de Terraform. Para cambiar el dominio, elimine el tenant y créelo de nuevo.
Tenants manuales “Connection details are read-only. To change the domain or credentials, delete and recreate the tenant.” (Los datos de conexión son de solo lectura. Para cambiar el dominio o las credenciales, elimine el tenant y créelo de nuevo.)
Tenants de Terraform Un recuadro identiguard.tf con View Terraform configuration y Hide Terraform configuration, y un botón Copy (aviso emergente “Terraform configuration copied to clipboard”). Una nota indica que el token de ingesta no está en este archivo. Se mostró una sola vez en la creación. Si se pierde, elimine el tenant y créelo de nuevo.
Recorridos sintéticos Un resumen de los recorridos del tenant, o “Synthetic journey monitoring is available on Max and Super plans.” (La monitorización de recorridos sintéticos está disponible en los planes Max y Super.) cuando los recorridos no están activados para el workspace. Consulte Recorridos.

La página Edit de Auth0 no tiene nada para el metric stream ni para los Action logs. Consulte Conectar Auth0.

Esta sección es la forma de cambiar qué eventos envía un tenant después de la creación. Tiene el mismo selector que el formulario de creación, bajo la etiqueta Subscribed Event Types.

Control Qué hace
Search event types… Filtra la lista. Se muestra cuando la lista tiene más de 10 tipos.
Select Recommended Solo Auth0. Sustituye toda la selección por el conjunto recomendado.
Select All Marca todos los tipos. Mientras busca, pasa a ser Select All Visible.
Clear All Lo desmarca todo.
N of M selected El recuento actual. Debe haber al menos un tipo marcado.

Lo que hace el guardado es distinto para cada proveedor:

Proveedor Texto en pantalla Efecto de Save Changes
Okta “Updating this list changes the Okta event hook immediately.” (Actualizar esta lista cambia de inmediato el event hook de Okta.) Identiguard reescribe al instante el event hook en la org de Okta.
Entra ID “Updating this list changes the Microsoft subscription immediately.” (Actualizar esta lista cambia de inmediato la suscripción de Microsoft.) Identiguard consulta el nuevo conjunto de flujos a partir de la consulta siguiente.
Auth0 “Updating this list changes which Auth0 log events are ingested. Takes effect immediately; no changes are made in Auth0.” (Actualizar esta lista cambia qué eventos de log de Auth0 se ingieren. Tiene efecto de inmediato. No se hace ningún cambio en Auth0.) Solo cambia lo que Identiguard conserva. El stream de Auth0 sigue enviando todo lo que tiene configurado.

Para los pasos de la tarea, consulte Cambiar qué eventos envía un tenant.

Reporting permissions (optional) comprueba el registro de la aplicación en directo cada vez que se carga la página. La instrucción en pantalla dice “Add these as application permissions on the app registration in the Entra admin centre, then select Grant admin consent.” (Añádalos como permisos de aplicación en el registro de la aplicación, en el centro de administración de Entra, y después seleccione Grant admin consent.)

Cada una de las seis filas muestra Granted (concedido) o Not granted (no concedido):

Permiso Se usa para También cuenta como concedido con
Reports.Read.All Cobertura de MFA (también necesita Entra ID P1) AuditLog.Read.All
RoleManagement.Read.Directory Recuento de Global Administrator RoleManagement.Read.All o Directory.Read.All
Policy.Read.All Inventario de Conditional Access
Application.Read.All Caducidad de las credenciales de aplicaciones Directory.Read.All
SecurityEvents.Read.All Microsoft Secure Score
IdentityRiskyUser.Read.All Usuarios de riesgo actuales

Para corregir una fila Not granted:

  1. En el centro de administración de Entra, abra el registro de la aplicación y vaya a API permissions.
  2. Añada el permiso de aplicación de Microsoft Graph que falta.
  3. Elija Grant admin consent.
  4. Recargue la página Edit. No hay botón de actualización.

Agent Monitoring (“Track AD and LDAP agent health on a recurring schedule.”, es decir, supervise periódicamente el estado de los agentes de AD y LDAP) tiene dos paneles: Monitor AD Agents y Monitor LDAP Agents. Necesita el scope de Okta okta.agentPools.read.

Para activar o desactivar un monitor, o para cambiar su intervalo:

  1. Abra Tenants y elija el icono de lápiz (Edit) del tenant de Okta.
  2. En Agent Monitoring, marque o desmarque Monitor AD Agents y Monitor LDAP Agents.
  3. Para cada monitor marcado, elija Check Interval (minutes): 5, 10, 15, 30, 60 o 120. Mientras un monitor está desmarcado, el texto de ayuda dice “Enable monitoring to configure the check interval.” (Active la monitorización para configurar el intervalo de comprobación.)
  4. Elija Save Changes.
  5. Abra de nuevo la página Edit, o mire la tarjeta del tenant en el Dashboard, y lea Status: y Last check:.

Abrir la página Edit ejecuta una comprobación nueva de cada monitor que esté activado. Para el significado de cada estado, consulte Estado de los tenants.

La tarjeta Credentials (“Rotate the client secret (and optionally the client ID) used to connect to Okta.” o “…to Microsoft.”, es decir, rote el secreto de cliente y, si lo desea, el ID de cliente que se usan para conectar) es un formulario aparte. Save Changes no lo envía.

Elemento Detalle
Título Rotate credentials “New credentials are verified against Okta before being saved.” (Las credenciales nuevas se verifican con Okta antes de guardarse.) (o Microsoft)
Client ID (optional) Texto de ejemplo “Enter new client ID (leave blank to keep current)” (Introduzca el nuevo ID de cliente. Déjelo en blanco para conservar el actual.)
Client Secret Texto de ejemplo “Enter new client secret”
Botón Validate & save credentials Muestra Validating… mientras comprueba
Alerta Verified “Credentials updated and verified against Okta.” (Credenciales actualizadas y verificadas con Okta.) o “…against Microsoft.”
Alerta Credentials rejected El motivo. No se ha guardado nada.
Alerta Monitoring paused Se muestra cuando un monitor se ha puesto en pausa por sí mismo. Consulte Estado de los tenants.

Para los pasos, consulte Rotar credenciales.

  1. Abra Tenants y elija el icono de lápiz (Edit).
  2. En Basic Details, cambie Tenant Name o Customer Name. Para Okta también puede cambiar Environment.
  3. Elija Save Changes.

Cambiar el intervalo de consulta de Entra ID

Sección titulada «Cambiar el intervalo de consulta de Entra ID»
  1. Abra Tenants y elija el icono de lápiz (Edit) del tenant de Entra ID.
  2. En Basic Details, defina Poll Interval (Minutes) entre 5 y 1440.
  3. Elija Save Changes.

Un intervalo más largo significa que los eventos llegan más tarde.

Solo los Admin pueden eliminar un tenant. La eliminación no se puede deshacer. Quita de Identiguard los datos almacenados del tenant: su historial de eventos, sus informes y el estado de sus monitores. También revoca los tokens de ingesta del tenant.

  1. Abra Tenants.
  2. En Tenant overview, elija el icono de papelera (Delete tenant) de la fila.
  3. Lea el cuadro de diálogo Delete tenant: <nombre>. Indica qué quita Identiguard y qué no en el lado del proveedor.
  4. Elija el botón rojo Delete tenant, o Cancel.
  5. Acepte el mensaje de confirmación del navegador.

El cuadro de diálogo se cierra y la tabla se actualiza.

Proveedor Qué hace Identiguard Qué debe hacer usted después
Okta Desactiva y quita el event hook de Okta, y después elimina el tenant. El cuadro de diálogo muestra el Event Hook ID para que pueda comprobar la limpieza en Okta. Puede mostrar “Loading…” o “Event Hook ID not available” (ID del event hook no disponible). Quite la integración de Identiguard en Okta si el cliente se marcha.
Auth0, manual Nada en Auth0. Identiguard no almacena credenciales de Auth0 y no puede quitar los streams. Elimine el log stream, y el metric stream si lo hay, en el panel de Auth0.
Auth0, Terraform Nada en Auth0. Ejecute terraform destroy, o elimine el log stream en Auth0.
Entra ID Deja de consultar Microsoft Graph. No se cambia nada dentro del tenant de Entra ID. Revoque el secreto del registro de la aplicación si ya no lo necesita.

Force delete tenant no es una opción permanente. Aparece solo dentro del cuadro de diálogo, y solo después de que una eliminación normal falle porque Identiguard no ha podido quitar el event hook de Okta. En la práctica se aplica únicamente a los tenants de Okta.

  1. Una eliminación normal falla con “Failed to delete tenant: Failed to remove Okta event hook.” (No se ha podido eliminar el tenant: no se ha podido quitar el event hook de Okta.)
  2. El cuadro de diálogo muestra un recuadro rojo Could not remove the Okta event hook: “Looks like the event hook has already been deleted on Okta, or Okta is not responding. You can force delete this tenant instead - its stored data (including event history) will be removed from Identiguard without making any further changes in Okta.” (Parece que el event hook ya se ha eliminado en Okta, o que Okta no responde. En su lugar puede forzar la eliminación de este tenant. Sus datos almacenados, incluido el historial de eventos, se quitarán de Identiguard sin hacer más cambios en Okta.)
  3. El botón cambia a Force delete tenant. Elíjalo.
  4. Acepte el mensaje de confirmación del navegador.
  5. En Okta, vaya a Workflows → Event Hooks. Si el hook IG_Tenant_ de este tenant todavía existe, desactívelo y elimínelo usted mismo.
Qué ve Por qué Qué hacer
“Could not load tenants.” (No se han podido cargar los tenants.) La lista de tenants no se cargó Recargue la página. Compruebe que todavía tiene acceso al workspace.
“Only workspace admins can create tenants.” y Admin Access Required Su rol es Member o Viewer Pregunte a un Admin del workspace.
Lápiz o papelera deshabilitados con “Admin access required to edit tenant” o “Admin access required to delete tenant” Su rol es Member o Viewer Pregunte a un Admin del workspace.
No hay icono de gráfico de líneas en una fila API Metrics solo existe para los tenants de Auth0 Nada.
Un tenant de Entra ID muestra microsoft El distintivo Type muestra el tipo almacenado Nada. Busque microsoft para encontrar los tenants de Entra ID.
No hay ningún mensaje después de crear o editar un tenant La página Tenants no muestra una confirmación Compruebe la fila en Tenant overview.
“Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” El límite de tenants del plan Elimine un tenant o suba de plan.
“0 req/min” en todos los tenants de la topología No hay eventos en 24 horas, o las cifras de tráfico no se cargaron Recargue la página y después compruebe el Dashboard.
“AI service · Offline” en la topología El servicio Ask Alex no responde Consulte Ask Alex.

Estos mensajes aparecen en el banner Error de la parte superior de la página Edit.

Qué ve Por qué Qué hacer
“At least one event type must be selected” (Debe seleccionarse al menos un tipo de evento) No hay nada marcado en Subscribed Event Types Marque al menos uno.
“Invalid Microsoft event type submitted” o “Invalid Auth0 event type submitted” (Se ha enviado un tipo de evento de Microsoft o de Auth0 no válido) La página envió un tipo que no está en la lista permitida Recargue la página y seleccione de nuevo.
“Customer name cannot be empty” (El nombre del cliente no puede estar vacío) Se borró Customer Name Introduzca el cliente.
“At least one field (…) must be provided for update.” (Debe indicarse al menos un campo para actualizar.) El formulario se envió sin nada que cambiar Cambie un valor y después guarde.
“Failed to update Okta event hook: <mensaje de Okta>” (No se ha podido actualizar el event hook de Okta) Okta rechazó la actualización del hook. Causas habituales: el secreto ha caducado, o falta un scope. Rote primero las credenciales y después guarde de nuevo.
“Okta event hook ID missing from configuration; recreate the event hook before updating.” (Falta el ID del event hook de Okta en la configuración. Vuelva a crear el event hook antes de actualizar.) El tenant no tiene un ID de hook almacenado Elimine el tenant y créelo de nuevo. No hay ninguna pantalla para volver a crear solo el hook.
“Okta tenant configuration missing encrypted secrets; recreate the event hook before updating.” (A la configuración del tenant de Okta le faltan los secretos cifrados.), “Failed to decrypt Okta credentials. Please recreate the event hook and try again.” (No se han podido descifrar las credenciales de Okta.) o “Okta configuration is missing client details; please recreate the tenant.” (A la configuración de Okta le faltan los datos del cliente. Vuelva a crear el tenant.) Las credenciales almacenadas no se pueden usar Elimine el tenant y créelo de nuevo. Escale al equipo de producto.
“Failed to update Auth0 tenant: <mensaje>”, “Failed to update Microsoft tenant: <mensaje>” (No se ha podido actualizar el tenant) o “An unexpected error occurred: …” (Se ha producido un error inesperado) Un error del servidor Inténtelo de nuevo y después escale.
“Forbidden: Insufficient permissions. Admin role required to update tenant.” (Prohibido: permisos insuficientes. Se requiere el rol Admin para actualizar el tenant.) Usted no es Admin Pregunte a un Admin del workspace.
“Editing is not supported for this tenant type.” (La edición no es compatible con este tipo de tenant.), “Tenant not found” (Tenant no encontrado) o “Internal Server Error” (Error interno del servidor) Un error inesperado Escale al equipo de producto.
“Could not load reporting permissions.” (No se han podido cargar los permisos de informes.) La comprobación de permisos no se cargó Recargue la página.
“Could not read the app registration permissions. Check the tenant credentials.” (No se han podido leer los permisos del registro de la aplicación. Compruebe las credenciales del tenant.) Identiguard no pudo iniciar sesión para leer el registro de la aplicación Rotar credenciales y después recargue.
Not granted en un permiso de informes Falta el permiso, o no se ha concedido el consentimiento de administrador Añada el permiso, elija Grant admin consent y recargue la página.
“Synthetic journey monitoring is available on Max and Super plans.” Los recorridos no están activados para el workspace Hace falta el plan Max o Super, y que un operador de la plataforma active los recorridos para el workspace.
Una casilla de agentes bloqueada con “Monitoring paused after repeated failures - rotate the credentials below to resume.” (Monitorización en pausa tras fallos repetidos. Rote las credenciales de abajo para reanudarla.) El monitor se puso en pausa por sí mismo Rotar credenciales.
Alerta Credentials rejected Las credenciales nuevas no superaron la comprobación Consulte Rotar credenciales.
Qué ve Por qué Qué hacer
“Failed to delete tenant: Failed to remove Okta event hook.” y el recuadro Could not remove the Okta event hook Okta se negó o no respondió. Puede que el hook ya esté eliminado, que las credenciales estén revocadas o que Okta esté caído. Elija Force delete tenant. Después quite el hook en Okta a mano si todavía existe.
“Failed to delete tenant: Failed to cleanup tenant event history.” (No se ha podido limpiar el historial de eventos del tenant.), “Failed to delete tenant: Failed to cleanup tenant monitor state.” (No se ha podido limpiar el estado de los monitores del tenant.) o “Failed to delete tenant: Failed to delete tenant report artifacts.” (No se han podido eliminar los archivos de informes del tenant.) Falló un paso interno de limpieza. Para estos casos no se ofrece la eliminación forzada. Inténtelo de nuevo. Si se repite, escale al equipo de producto.
“Failed to delete tenant: API Error”, “An unexpected error occurred.” o “Failed to delete tenant.” (No se ha podido eliminar el tenant.) Un error inesperado del servidor Inténtelo de nuevo y después escale.
“Forbidden: Insufficient permissions. Admin role required.” (Prohibido: permisos insuficientes. Se requiere el rol Admin.) Usted no es Admin Pregunte a un Admin del workspace.
“Event Hook ID not available” en el cuadro de diálogo El tenant no tiene un ID de hook almacenado Solo a título informativo. Puede eliminar igualmente.
Auth0 muestra fallos de entrega en el stream después de la eliminación El stream sigue apuntando al endpoint revocado Elimine el stream en Auth0, o ejecute terraform destroy.