Compartir a través de


Recopilar registros de auditoría mediante la API de administración de Office 365

El flujo de sincronización del registro de auditoría se conecta a la API de referencia de actividad de administración de Office 365 para recopilar datos de telemetría, como usuarios únicos e inicios para las aplicaciones. Los flujos utilizan una acción HTTP para acceder a la API. En este artículo, configurará el registro de la aplicación para la acción HTTP y las variables de entorno necesarias para ejecutar los flujos.

Nota

El Kit de inicio del Centro de excelencia (CoE) funciona sin estos flujos. Sin embargo, si no usa los flujos, la información de uso, como los inicios de la aplicación y los usuarios únicos, están en blanco en el panel de Power BI.

Requisitos previos

  1. Complete los pasos descritos en Configuración del Kit de inicio de CoE y Configuración de componentes de inventario.
  2. Cree sus entornos.
  3. Inicie sesión con la identidad correcta.

Propina

Configure los flujos de registro de auditoría solo si eligió flujos en la nube como mecanismo para el inventario y la telemetría.

Antes de configurar los flujos de registro de auditoría

Antes de comenzar, asegúrese de que se cumplen los siguientes requisitos previos adicionales:

Nota

Para conceder derechos a su aplicación para acceder a las API de administración de Office 365, puede utilizar los servicios de autenticación que ofrecen las API a través de Microsoft Entra ID.

Crear un registro de la aplicación Microsoft Entra para acceder a la API de administración de Office 365

Con estos pasos, puede configurar un registro de aplicaciones de Microsoft Entra para una llamada HTTP en un flujo de Power Automate a fin de conectarse al registro de auditoría. Más información: Introducción a las API de administración de Office 365.

  1. Inicie sesión en el portal Azure.

  2. Vaya a Microsoft Entra ID>Registros de aplicaciones.

    Captura de pantalla que muestra la ubicación del servicio Azure Registros de aplicaciones.

  3. Seleccione + Nuevo registro.

  4. Escriba un nombre, como Administración de Microsoft 365, pero no cambie ninguna otra configuración. Después, haga clic en Registrar.

  5. Seleccione Permisos de API>+Agregar un permiso.

    Captura de pantalla que muestra la ubicación del botón Agregar un permiso del menú Permisos de API.

  6. Seleccione API de administración de Office 365 y configure los permisos de la siguiente manera:

    1. Seleccione Permisos de aplicación y, después, ActivityFeed.Read.

      Captura de pantalla que muestra la configuración ActivityFeed.Read en la página Solicitar permisos de API del menú Permisos de API.

    2. Seleccione Agregar permisos.

  7. Seleccione Conceder consentimiento de administrador para <su organización>. Obtenga más información sobre los requisitos previos para configurar el contenido del administrador.

    Los permisos de API ahora reflejan los permisos ActivityFeed.Read delegados con un estado de Concedido para <su organización>.

  8. Seleccione Certificados y secretos.

  9. Seleccione + Nuevo secreto de cliente.

  10. Agregue una descripción y vencimiento de acuerdo con las directivas de su organización. A continuación, seleccione Agregar.

  11. Copie y pegue el valor de ID de la aplicación (cliente) en un documento de texto, como un archivo del bloc de notas.

  12. Seleccione Información general y copie y pegue los valores de id. de la aplicación (cliente) y del directorio (inquilino) en el mismo documento de texto.

    Importante

    Asegúrese de tener en cuenta qué identificador único global (GUID) corresponde a cada valor. Necesitará estos valores cuando vaya a configurar el conector personalizado.

Actualizar variables de entorno

Use variables de entorno para elegir la API de administración de Office 365 heredada o Graph API. Almacene el identificador de cliente y el secreto para el registro de la aplicación en variables de entorno. En función del tipo de nube para la acción HTTP, configure los puntos de conexión de los servicios de audiencia y autoridad utilizando variables de entorno. El tipo de nube puede ser comercial, US Government Community Cloud (GCC), US GCC High o US Department of Defense (DoD). Actualice las nuevas variables de entorno antes de activar los flujos.

Puede almacenar su id. de cliente en texto sin formato en la variable de entorno Registros de auditoría: secreto de cliente. Sin embargo, no se recomienda este enfoque. En su lugar, cree y almacene el secreto de cliente en Azure Key Vault y haga referencia a él en la variable de entorno Registros de auditoría: cliente de Azure Secret .

Nota

El flujo que utiliza esta variable de entorno está configurado con una condición para esperar la variable de entorno Registros de auditoría: secreto de cliente o Registros de auditoría: secreto de Azure del cliente. Sin embargo, no tendrá que editar el flujo para trabajar con Azure Key Vault.

Nombre. Description valor
Registros de auditoría: usar Graph API Parámetro que controla si se debe usar la Graph API para consultar eventos.

No (predeterminado)

El flujo de sincronización usa la API de administración de Office 365 heredada.

Registros de auditoría - Público El parámetro de público para las llamadas HTTP.
  • Comercial (predeterminado): https://manage.office.com
  • GCC: https://manage-gcc.office.com
  • GCC High: https://manage.office365.us
  • DoD: https://manage.protection.apps.mil
Registros de auditoría: público El campo de autoridad en las llamadas HTTP.
  • Comercial (predeterminado): https://login.windows.net
  • GCC: https://login.windows.net
  • GCC High: https://login.microsoftonline.us
  • DoD: https://login.microsoftonline.us
Registros de auditoría - ClientID El ID de cliente del registro de aplicación. El id. de cliente de la aplicación del paso Crear un registro de aplicaciones de Microsoft Entra para la API de administración de Office 365.
Registros de auditoría - Secreto del cliente El secreto de cliente de registro de la aplicación (no el identificador de secreto, sino el valor real) en texto sin formato.

El secreto de cliente de la aplicación del paso Crear un registro de aplicaciones de Microsoft Entra para la API de administración de Office 365.

Déjelo en blanco si usa Azure Key Vault para almacenar su ID y secreto de cliente.

Registros de auditoría - Secreto del cliente de Azure Referencia de Azure Key Vault del secreto de cliente del registro de aplicaciones.

La referencia de Azure Key Vault para el secreto de cliente de la aplicación del paso Crear un registro de aplicaciones de Microsoft Entra para la API de administración de Office 365.

Si está almacenando su ID de cliente en texto plano en la variable de entorno Registros de auditoría: secreto del cliente, deje esta variable vacía. Esta variable espera la referencia de Azure Key Vault, no el secreto. Más información en: Usar variables de entorno para secretos de Azure Key Vault.

Iniciar una suscripción para auditar el contenido del registro

  1. Vaya a make.powerapps.com.

  2. Seleccione Solución.

  3. Abra la solución Centro de excelencia - Componentes principales.

  4. Activar el flujo Admin | Registros de auditoría | Suscripción a la API de administración de Office 365. Ejecute el flujo escribiendo start como la operación que se va a ejecutar.

    Captura de pantalla que muestra la ubicación del botón Ejecutar en la barra de navegación y la operación de inicio en el panel de flujo de ejecución.

  5. Abra el flujo y compruebe que se pasa la acción para iniciar la suscripción.

Importante

Si previamente ha habilitado la suscripción, verá un mensaje (400) La suscripción ya está habilitada. Este mensaje significa que la suscripción ya está habilitada. Puede ignorar este mensaje y continuar con la configuración.

Si no ve el mensaje anterior o una respuesta (200), es probable que se produzca un error en la solicitud. Podría haber un error con su configuración que impide que el flujo funcione. Los problemas comunes por verificar son:

Activar flujos

  1. Vaya a make.powerapps.com.

  2. Seleccione Solución.

  3. Abra la solución Centro de excelencia - Componentes principales.

  4. Active el flujo Administrador | Registros de auditoría | Actualizar datos (V2). Este flujo actualiza la tabla de Power Apps con información sobre la última ola. También agrega metadatos a los registros del registro de auditoría.

  5. Active el flujo Administrador | Registros de auditoría | Sincronizar registros de auditoría (V2). Este flujo se ejecuta según una programación horaria y recopila eventos del registro de auditoría en la tabla registro de auditoría.

Proporcionar comentarios

Si encuentra un problema con el Kit de inicio de CoE, informe de un error en la solución en aka.ms/coe-starter-kit-issues.