Conectar Microsoft Entra ID
Identiguard lee Entra ID a través de Microsoft Graph. Usted registra una aplicación en el directorio del cliente, le concede permisos de solo lectura y facilita sus datos a Identiguard. Después, Identiguard consulta Microsoft Graph con el intervalo que usted elija.
Antes de empezar
Sección titulada «Antes de empezar»Se necesita:
- Un rol en Entra ID que pueda registrar aplicaciones y conceder el consentimiento de administrador.
- El rol Admin en el workspace de Identiguard. 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.
- Un hueco de tenant libre en el plan. Consulte el límite de tenants del plan.
1. Registrar una aplicación en Entra ID
Sección titulada «1. Registrar una aplicación en Entra ID»- En el centro de administración de Entra, vaya a App registrations → New registration.
- Póngale un nombre, como
Identiguard, y regístrela. - Copie el Directory (tenant) ID y el Application (client) ID.
- En Certificates & secrets, cree un secreto de cliente y copie su Value. No copie el Secret ID.
2. Conceder permisos
Sección titulada «2. Conceder permisos»En API permissions, añada los siguientes como permisos de aplicación de Microsoft Graph y después elija Grant admin consent.
Para la monitorización
Sección titulada «Para la monitorización»| Permiso | Qué habilita |
|---|---|
IdentityRiskyUser.Read.All |
Usuarios de riesgo |
IdentityRiskEvent.Read.All |
Detecciones de riesgo, como la difusión de contraseñas (password spray) y las credenciales filtradas |
AuditLog.Read.All |
Auditorías del directorio e inicios de sesión |
IdentityRiskyServicePrincipal.Read.All |
Riesgo de identidades de carga de trabajo. Necesita la licencia Workload ID Premium. |
ServiceHealth.Read.All |
La página de estado de Entra ID |
Para los informes (opcional)
Sección titulada «Para los informes (opcional)»La página Edit del tenant comprueba estos seis permisos y muestra cada uno como Granted (concedido) o Not granted (no concedido).
| Permiso | Sección del informe | 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 |
Conceda solo aquello con lo que el cliente se sienta cómodo. Un permiso que falta elimina ese único flujo o esa sección del informe, y nada más.
3. Crear el tenant en Identiguard
Sección titulada «3. Crear el tenant en Identiguard»- Abra el workspace y vaya a Tenants.
- En Create a tenant, busque la tarjeta Entra ID (subtítulo Microsoft ecosystem) y elija Connect. Se abre la página Add New Entra ID Tenant.
- Rellene el formulario. Todos los campos se describen en la tabla siguiente.
- En Event Subscriptions, marque los flujos que quiere recoger. No hay nada marcado cuando se abre la página, y debe marcar al menos uno.
- Elija Create Entra ID Tenant. El botón muestra Creating… mientras Identiguard trabaja.
Los campos
Sección titulada «Los campos»| Sección | Campo | Reglas |
|---|---|---|
| Basic Details | Tenant Name | Obligatorio. 100 caracteres como máximo. Sin saltos de línea ni caracteres de control. |
| Basic Details | Customer Name | Opcional para Entra ID. El campo sugiere nombres de cliente ya usados en el workspace. |
| Basic Details | Azure AD Tenant ID | Obligatorio. El Directory (tenant) ID. Debe ser un UUID, como xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. |
| Basic Details | Poll Interval (minutes) | Obligatorio. De 5 a 60 en este formulario. El valor predeterminado es 5. |
| Basic Details | Client ID | Obligatorio. El Application (client) ID. Debe ser un UUID. |
| Credentials | Client Secret | Obligatorio. El Value del secreto del registro de la aplicación. |
| Event Subscriptions | Subscribed Event Types | Al menos un flujo. |
No hay campo Environment para Entra ID.
Los flujos
Sección titulada «Los flujos»El formulario enumera cinco flujos. Select All marca los cinco y Clear All los desmarca.
| Etiqueta del flujo en el formulario | Necesita |
|---|---|
| Risky users: accounts Entra has flagged as at risk (usuarios de riesgo: cuentas que Entra ha marcado como en riesgo) | IdentityRiskyUser.Read.All |
| Risk detections: password spray, leaked credentials, atypical travel and 19 more (detecciones de riesgo: difusión de contraseñas, credenciales filtradas, viaje atípico y 19 más) | IdentityRiskEvent.Read.All |
| Directory audits: role & PIM changes, consent grants, MFA tampering, CA policy changes (needs AuditLog.Read.All) (auditorías del directorio: cambios de roles y PIM, concesiones de consentimiento, manipulación de MFA, cambios en políticas de CA) | AuditLog.Read.All |
| Sign-ins: risky sign-ins and Conditional Access failures (needs AuditLog.Read.All + P1) (inicios de sesión: inicios de sesión de riesgo y fallos de Conditional Access) | AuditLog.Read.All y Entra ID P1 |
| Workload identity risk: risky service principals and their risk detections (riesgo de identidades de carga de trabajo: service principals de riesgo y sus detecciones de riesgo) | La licencia Microsoft Entra Workload ID Premium, además de IdentityRiskyServicePrincipal.Read.All y IdentityRiskEvent.Read.All |
Qué ocurre al crear el tenant
Sección titulada «Qué ocurre al crear el tenant»- Identiguard pide un token a Microsoft con el ID del tenant, el ID de cliente y el secreto. No se guarda nada si Microsoft no los acepta.
- En un workspace en periodo de prueba, esta comprobación también reserva el directorio para ese periodo de prueba. Un directorio de Entra solo se puede usar en un periodo de prueba.
- Vuelve a la página Tenants.
- Los primeros eventos llegan después de la primera consulta.
Comprobar qué permisos están concedidos
Sección titulada «Comprobar qué permisos están concedidos»- Abra Tenants.
- En Tenant overview, elija el icono de lápiz (Edit) del tenant de Entra ID.
- Lea Reporting permissions (optional). Cada fila muestra Granted o Not granted.
- Si una fila muestra Not granted, añada ese permiso en el centro de administración de Entra, en API permissions, y elija Grant admin consent.
- Recargue la página Edit. Identiguard lee los permisos de Microsoft cada vez que se carga la página. No hay botón de actualización.
A tener en cuenta
Sección titulada «A tener en cuenta»- Los eventos de Entra ID llegan según el intervalo de consulta, no al instante. Dígalo en una demo.
- Los secretos de cliente caducan. Anote la fecha de caducidad en el calendario del cliente y consulte Rotar credenciales.
- No se puede cambiar el directorio más adelante. Para pasar a otro directorio, elimine el tenant y créelo de nuevo.
- Eliminar el tenant no cambia nada dentro de Entra ID. Revoque usted mismo el secreto del registro de la aplicación si ya no lo necesita.
- Para cambiar los flujos o el intervalo de consulta más adelante, consulte Gestionar tenants.
Solución de problemas
Sección titulada «Solución de problemas»Los errores de campo se muestran en rojo debajo del campo. Los demás errores se muestran como un aviso emergente rojo. Un aviso que empieza por Failed to create tenant: (No se ha podido crear el tenant) procede del servidor.
Validación del formulario
Sección titulada «Validación del formulario»| Qué ve | Por qué | Qué hacer |
|---|---|---|
| “Only workspace admins can create tenants.” y un botón Admin Access Required deshabilitado | Su rol es Member o Viewer | Pida a un Admin del workspace que cree el tenant. |
| “Tenant name cannot be empty” (El nombre del tenant no puede estar vacío), “Tenant name must be 100 characters or fewer” (El nombre del tenant debe tener 100 caracteres como máximo) o “Tenant name cannot contain line breaks or control characters” (El nombre del tenant no puede contener saltos de línea ni caracteres de control) | El nombre del tenant incumple una regla | Corrija el nombre. |
| “Azure AD Tenant ID is required” (El Azure AD Tenant ID es obligatorio) o “Must be a valid Azure AD Tenant ID (UUID format)” (Debe ser un Azure AD Tenant ID válido, con formato UUID) | El ID del tenant está en blanco o no es un UUID | Copie el Directory (tenant) ID del resumen del registro de la aplicación. |
| “Application (Client) ID is required” (El Application (Client) ID es obligatorio) o “Must be a valid Application (Client) ID (UUID format)” (Debe ser un Application (Client) ID válido, con formato UUID) | El ID de cliente está en blanco o no es un UUID | Copie el Application (client) ID del resumen del registro de la aplicación. |
| “Client Secret is required” (El secreto de cliente es obligatorio) | El secreto está en blanco | Pegue el Value del secreto, no el Secret ID. |
| “Poll interval must be at least 5 minutes” (El intervalo de consulta debe ser de al menos 5 minutos) o “Poll interval cannot exceed 60 minutes” (El intervalo de consulta no puede superar los 60 minutos) | El intervalo está fuera del rango del formulario de creación | Introduzca un número de 5 a 60. Más adelante puede definir un intervalo más largo en la página Edit. |
| “At least one event type must be selected” (Debe seleccionarse al menos un tipo de evento) | No hay ningún flujo marcado | Marque al menos un flujo. |
| “Invalid event type submitted” (Se ha enviado un tipo de evento no válido) | La página envió un flujo que no está en la lista permitida | Recargue la página y seleccione de nuevo los flujos. |
Errores de creación
Sección titulada «Errores de creación»| Qué ve | Por qué | Qué hacer |
|---|---|---|
| “Failed to create tenant: Microsoft rejected these credentials. Check the directory (tenant) ID, client ID and client secret.” (Microsoft ha rechazado estas credenciales. Compruebe el ID del directorio (tenant), el ID de cliente y el secreto de cliente.) | Microsoft rechazó la solicitud de token | Compruebe los tres valores. Puede que el secreto haya caducado, o que haya pegado el Secret ID en lugar del Value. |
| “Failed to create tenant: Could not verify these credentials with Microsoft. Try again in a few minutes.” (No se han podido verificar estas credenciales con Microsoft. Inténtelo de nuevo en unos minutos.) | Microsoft no respondió | Inténtelo de nuevo en unos minutos. |
| “Failed to create tenant: Microsoft Entra did not accept this client ID and client secret for that tenant, so it cannot be added. Check them and try again.” (Microsoft Entra no ha aceptado este ID de cliente y este secreto de cliente para ese tenant, así que no se puede añadir. Compruébelos e inténtelo de nuevo.) | Workspace en periodo de prueba. Microsoft rechazó las credenciales durante la comprobación del periodo de prueba. | Compruebe los tres valores, como en el caso anterior. |
| “Failed to create tenant: Identiguard could not reach Microsoft Entra to check these credentials. Try again in a few minutes.” (Identiguard no ha podido contactar con Microsoft Entra para comprobar estas credenciales. Inténtelo de nuevo en unos minutos.) | Workspace en periodo de prueba. Microsoft no respondió. | Inténtelo de nuevo en unos minutos. |
| “Failed to create tenant: This Microsoft Entra tenant has already been used in another Identiguard trial, so it cannot be added to a new one. Choose a plan on the Billing page to add it, or contact Identiguard support.” (Este tenant de Microsoft Entra ya se ha usado en otro periodo de prueba de Identiguard, así que no se puede añadir a uno nuevo. Elija un plan en la página Billing para añadirlo, o contacte con el soporte de Identiguard.) | Workspace en periodo de prueba. Otro periodo de prueba ya usó este directorio. | Elija un plan de pago, o contacte con el soporte de Identiguard. |
| “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 plan permite hasta N tenants por workspace, y este workspace ya tiene M. Suba de plan para añadir más.) | El workspace ha llegado al límite de tenants de su plan | Elimine un tenant que ya no necesite, o suba de plan. Consulte Planes y facturación. |
| “Forbidden: You do not have permission to create tenants.” (Prohibido: no tiene permiso para crear tenants.) | Su rol cambió mientras la página estaba abierta | Pregunte a un Admin del workspace. |
| “Failed to create tenant: Bad Request” (Solicitud incorrecta) | El servidor rechazó el formulario | Revise de nuevo todos los campos. Escale si continúa. |
| “Failed to create tenant: API error” (Error de API) o “An unexpected error occurred: …” (Se ha producido un error inesperado) | Un error inesperado | Inténtelo de nuevo y después escale al equipo de producto. |
| “Failed to create tenant: Server configuration error…” (Error de configuración del servidor) | Un problema de la plataforma | Escale a un operador de la plataforma. |
Después de la creación
Sección titulada «Después de la creación»| Qué ve | Por qué | Qué hacer |
|---|---|---|
| No hay confirmación después de elegir Create Entra ID Tenant | La página Tenants no muestra un mensaje de confirmación | Busque la nueva fila en Tenant overview. |
| Todavía no hay eventos | Entra ID se consulta periódicamente, no envía los eventos por sí mismo | Espere un intervalo de consulta. |
| Un aviso emergente “<nombre del tenant> connection unhealthy” (conexión con problemas) con “Microsoft Graph rejected one or more enabled streams while others polled fine. Re-check the app registration permissions/licence for the subscribed event types.” (Microsoft Graph ha rechazado uno o varios flujos habilitados mientras otros se han consultado bien. Revise los permisos y la licencia del registro de la aplicación para los tipos de evento suscritos.) | A un flujo suscrito le falta su permiso o su licencia. Causas típicas: inicios de sesión sin P1, riesgo de identidades de carga de trabajo sin Workload ID Premium, o AuditLog.Read.All no concedido. |
Conceda el permiso y el consentimiento de administrador, o desmarque ese flujo. Consulte Cambiar qué eventos envía un tenant. |
| Un aviso emergente “<nombre del tenant> connection unhealthy” con “Microsoft Graph credentials rejected. Re-check the client ID and secret.” (Credenciales de Microsoft Graph rechazadas. Revise el ID de cliente y el secreto.) | Microsoft rechazó todos los flujos. El secreto ha caducado o se revocó. | Rotar credenciales. |
| Not granted en un permiso de informes | El permiso no se ha añadido, o no se ha concedido el consentimiento de administrador | Añada el permiso de aplicación, elija Grant admin consent y después recargue la página Edit. |
| “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 la página. |