Información general sobre los API de informes de actividad

Espacio de nombres: microsoft.graph

Azure Active Directory (Azure AD) realiza un seguimiento de la actividad del usuario y crea informes que le permiten comprender la forma en que los usuarios obtienen acceso a los servicios de Azure AD y los usan. Use la API de Microsoft Graph para Azure AD para analizar los datos de estos informes y crear soluciones personalizadas que se adapten a las necesidades específicas de su organización.

Las directivas de retención de datos de Azure AD administran la disponibilidad de estos informes de actividad. Para más información, consulte directivas de retención de datos.

¿Qué son los registros de actividad de Azure AD?

Azure AD proporciona tres 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

¿Qué licencias necesito?

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.

Por ejemplo, necesita una licencia de Azure AD Premium P1 para obtener acceso a los informes de auditoría de autoservicio de contraseña. Para obtener más información, vea Licencias de Azure AD.

Para los informes de inicios de sesión, se necesita una licencia de Azure AD Premium.

Para obtener más información, vea Precios de Azure AD.

Siguientes pasos