Información general sobre los API de informes de actividad
Espacio de nombres: microsoft.graph
Microsoft Entra ID realiza un seguimiento de la actividad del usuario y crea informes que le ayudan a comprender cómo los usuarios acceden y usan Microsoft Entra servicios. Use microsoft Graph API para Microsoft Entra ID para analizar los datos de estos informes y crear soluciones personalizadas adaptadas a las necesidades específicas de su organización.
La disponibilidad de estos informes de actividad se rige por las directivas de retención de datos Microsoft Entra. Para más información, consulte directivas de retención de datos.
¿Qué son los registros de actividad Microsoft Entra?
Microsoft Entra ID proporciona los siguientes tipos de informes de actividad:
- Auditorías del directorio
- Inicios de sesión
Auditorías del directorio
El informe de auditoría del directorio le proporciona acceso al historial de cada una de las tareas realizadas en su inquilino. El informe de auditoría del directorio le proporciona registros de las actividades del sistema con fines de cumplimiento. Entre otros, los datos proporcionados le permiten solucionar escenarios comunes, como:
- ¿Quién concedió acceso de grupo de administradores a un usuario de directorio?
- ¿Qué usuarios inician sesión en una aplicación obtenida recientemente?
- ¿Cuántos restablecimientos de contraseña se realizaron en el directorio?
Inicios de sesión
El informe de inicios de sesión le permite determinar quién realizó las tareas que se informan en las auditorías del directorio. El informe de inicios de sesión le permite responder preguntas como:
- ¿Cuál es el patrón de inicio de sesión de un usuario?
- ¿Cuántos usuarios iniciaron sesión durante la semana pasada?
- ¿Cuál es el estado de estos inicios de sesión?
¿Qué puedo hacer con las API de registro de auditoría en Microsoft Graph?
Estas son algunas solicitudes populares para trabajar con datos de registro de auditoría:
| Operación | URL |
|---|---|
| OBTENER actividades de usuario de inquilino | GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits |
| OBTENER inicios de sesión de usuario de inquilino | GET https://graph.microsoft.com/v1.0/auditLogs/signIns |
Requisitos de licencia
Los informes de actividades están disponibles para las características para las que tenga licencia. Si tiene una licencia para una característica específica, también tendrá acceso a sus informes. Para obtener más información sobre los requisitos de licencia para los distintos informes de actividad, consulte Microsoft Entra registros de auditoría: Requisitos de licencia y rol.
Contenido relacionado
- Empiece a trabajar con los siguientes recursos que representan los distintos informes de actividad:
- tipo de recurso directoryAudit.
- tipo de recurso signIn.
- tipo de recurso provisioningObjectSummary.