Conector de Google Workspace (G Suite) (mediante Azure Functions) para Microsoft Sentinel
El conector de datos de Google Workspace proporciona la capacidad de ingerir eventos de la actividad de Google Workspace en Microsoft Sentinel a través de la API de REST. El conector proporciona la capacidad de obtener eventos, lo que ayuda a examinar los posibles riesgos de seguridad, analizar la colaboración del equipo, diagnosticar problemas de configuración, realizar un seguimiento de quién inicia sesión y cuándo, analizar la actividad del administrador, comprender cómo los usuarios crean y comparten contenido, y más eventos de revisión en la organización.
Este contenido se genera automáticamente. Para los cambios, póngase en contacto con el proveedor de soluciones.
Atributos del conector
| Atributo del conector | Descripción |
|---|---|
| Código de la aplicación de funciones de Azure | https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp |
| Tabla de Log Analytics | GWorkspace_ReportsAPI_admin_CL GWorkspace_ReportsAPI_calendar_CL GWorkspace_ReportsAPI_drive_CL GWorkspace_ReportsAPI_login_CL GWorkspace_ReportsAPI_mobile_CL GWorkspace_ReportsAPI_token_CL GWorkspace_ReportsAPI_user_accounts_CL |
| Soporte de reglas de recopilación de datos | No se admite actualmente. |
| Compatible con | Microsoft Corporation |
Ejemplos de consultas
Eventos de Google Workspace: todas las actividades
GWorkspaceActivityReports
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de administrador
GWorkspace_ReportsAPI_admin_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de calendario
GWorkspace_ReportsAPI_calendar_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de Drive
GWorkspace_ReportsAPI_drive_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de inicio de sesión
GWorkspace_ReportsAPI_login_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de dispositivos móviles
GWorkspace_ReportsAPI_mobile_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de tokens
GWorkspace_ReportsAPI_token_CL
| sort by TimeGenerated desc
Eventos de Google Workspace: actividad de cuentas de usuario
GWorkspace_ReportsAPI_user_accounts_CL
| sort by TimeGenerated desc
Requisitos previos
Para realizar la integración con Google Workspace (G Suite) (mediante Azure Functions), asegúrese de tener:
- Permisos de Microsoft.Web/sites: se requieren permisos de lectura y escritura en Azure Functions para crear una aplicación de funciones. Consulte la documentación para obtener más información sobre Azure Functions.
- Credenciales y permisos de la API de REST: GooglePickleString es necesario para la API de REST. Consulte la documentación para obtener más información sobre la API. Busque las instrucciones para obtener las credenciales en la sección de configuración siguiente. También puede comprobar todos los requisitos y seguir las instrucciones de aquí.
Instrucciones de instalación del proveedor
Nota
Este conector usa Azure Functions para conectarse a la API de informes de Google para extraer sus registros en Microsoft Sentinel. Esto podría generar costes adicionales de ingesta de datos. Consulte la página de precios de Azure Functions para obtener más información.
(Paso opcional) Almacene de manera segura las claves o tokens de autorización del área de trabajo y de la API en Azure Key Vault. Azure Key Vault proporciona un mecanismo seguro para almacenar y recuperar valores de clave. Siga estas instrucciones para usar Azure Key Vault con una aplicación de funciones de Azure Functions.
NOTA: este conector de datos depende de un analizador basado en una función de Kusto para que funcione según lo previsto, el cual se implementa como parte de la solución. Para ver el código de función en Log Analytics, abra la hoja Registros de Log Analytics/Microsoft Sentinel, haga clic en Functions y busque el alias GWorkspaceReports y cargue el código de función, en la segunda línea de la consulta, escriba los nombres de host de los dispositivos GWorkspaceReports y cualquier otro identificador único para la secuencia de registro. La función normalmente tarda entre 10 y 15 minutos en activarse después de la instalación o actualización de la solución.
PASO 1: Asegurarse de los requisitos previos para obtener la cadena de Google Pickle
- Python 3 o superior está instalado.
- La herramienta de administración de paquetes pip está disponible.
- Un dominio de Google Workspace con acceso de API habilitado.
- Una cuenta de Google en ese dominio con privilegios de administrador.
PASO 2: Pasos de configuración para la API de informes de Google
- Inicie sesión en la consola de Google Cloud con las credenciales https://console.cloud.google.com del área de trabajo Administración.
- Con la opción de búsqueda (disponible en el centro superior), busque API y servicios
- Desde API y servicios - > API habilitados y servicios, habilite API del SDK de administración para este proyecto.
- Vaya a API y servicios - >Pantalla de consentimiento de OAuth. Si aún no está configurado, cree una pantalla de consentimiento de OAuth con los pasos siguientes:
- Proporcione el nombre de la aplicación y otra información obligatoria.
- Agregue dominios autorizados con el acceso a la API habilitado.
- En la sección Ámbitos, agregue el ámbito API del SDK de administración.
- En la sección Usuarios de prueba, asegúrese de que se agregue la cuenta de administrador del dominio.
- Vaya a API y servicios - >Credenciales y cree el identificador de cliente de OAuth 2.0.
- Haga clic en Crear credenciales en la parte superior y seleccione Id. de cliente de Oauth.
- Seleccione Aplicación web en la lista desplegable Tipo de aplicación.
- Proporcione un nombre adecuado para la aplicación web y agregue http://localhost:8081/ como uno de los URI de redireccionamiento autorizados.
- Cuando haya hecho clic en Crear, descargue el JSON desde el elemento emergente que aparece. Cambie el nombre de este archivo a "credentials.json".
- Para capturar la cadena de Google Pickle, ejecute el script de Python desde la misma carpeta donde se guarda credentials.json.
- Cuando aparezca el elemento emergente para iniciar sesión, use las credenciales de la cuenta de administrador de dominio para iniciar sesión.
Nota: Este script solo se admite en el sistema operativo Windows. 7. En la salida del paso anterior, copie la cadena de Google Pickle (se encuentra entre comillas simples) y téngala a la mano. Se necesitará en el paso de implementación de la aplicación de funciones.
PASO 3: Elija UNA de las dos opciones de implementación siguientes para implementar el conector y la función de Azure asociada
IMPORTANTE: Antes de implementar el conector de datos de Workspace, tenga a mano el identificador y la clave principal del área de trabajo (se pueden copiar con las indicaciones siguientes), así como la cadena GooglePickleString de Workspace.
Opción 1: Plantilla de Azure Resource Manager (ARM)
Use este método para la implementación automatizada del conector de datos de Google Workspace mediante una plantilla de ARM.
Haga clic en el botón Implementar en Azure que aparece a continuación.
Seleccione la suscripción, el grupo de recursos y la ubicación que prefiera.
Escriba el identificador del área de trabajo, la clave del área de trabajo y GooglePickleString e implemente.
Marque la casilla de verificación Acepto los términos y condiciones establecidos anteriormente.
Haga clic en Comprar para iniciar la implementación.
Opción 2: Implementación manual de Azure Functions
Siga estas instrucciones paso a paso para implementar el conector de datos de Google Workspace manualmente con Azure Functions (implementación mediante Visual Studio Code).
1. Implementación de una aplicación de funciones
NOTA: Deberá preparar VS Code para el desarrollo de funciones de Azure.
Descargue el archivo Aplicación de funciones de Azure. Extraiga el archivo en su equipo de desarrollo local.
Inicie VS Code. Elija Archivo en el menú principal y seleccione Abrir carpeta.
Seleccione la carpeta de nivel superior de los archivos extraídos.
Seleccione el icono de Azure en la barra de actividades y después, en el área Azure: Functions, seleccione el botón de implementación en la aplicación de funciones. Si aún no ha iniciado sesión, seleccione el icono de Azure en la barra de actividades y después en el área Azure: Functions, seleccione Iniciar sesión en Azure. Si ya había iniciado sesión, vaya al paso siguiente.
Escriba la siguiente información cuando se le indique:
a. Seleccionar carpeta: elija una carpeta de su área de trabajo o busque una que contenga su aplicación de funciones.
b. Seleccionar la suscripción: elija la suscripción que desee usar.
c. Seleccionar Crear aplicación de funciones en Azure (no elija la opción Opciones avanzadas)
d. Escribir un nombre único global para la aplicación de funciones: escriba un nombre que sea válido en una ruta de acceso de la dirección URL, El nombre que escriba se valida para asegurarse de que es único en Azure Functions. (por ejemplo, GWorkspaceXXXXX).
e. Seleccionar un entorno de ejecución: elija Python 3.8.
f. Seleccione una ubicación para los nuevos recursos. Para mejorar el rendimiento y reducir los costos, elija la misma región donde se encuentra Microsoft Sentinel.
Se inicia la implementación. Una vez que se haya creado la aplicación de función se mostrará una notificación y se aplicará el paquete de implementación.
Vaya a Azure Portal para la configuración de la aplicación de funciones.
2. Configuración de la aplicación de funciones
En la aplicación de funciones, seleccione el nombre de la aplicación de funciones y, después, Configuración.
En la pestaña Configuración de la aplicación, seleccione ** Nueva configuración de la aplicación**.
Agregue cada una de las siguientes opciones de configuración de la aplicación individualmente, con sus respectivos valores de cadena (distingue mayúsculas de minúsculas): GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri (opcional)
(Opcional) cambie los retrasos predeterminados si fuera necesario.
NOTA: se han agregado los siguientes valores predeterminados para retrasos de ingesta para diferentes conjuntos de registros de Google Workspace en función de la documentación de Google. Estos se pueden modificar en función de los requisitos del entorno. Retraso de capturas: retraso de capturas de calendario de 10 minutos; retraso de capturas de chat de 6 horas; retraso de capturas de cuentas de usuario de 1 día; retraso de capturas de inicio de sesión de 3 horas; 6 horas
Use logAnalyticsUri para invalidar el punto de conexión de la API de Log Analytics para la nube dedicada. Por ejemplo, para la nube pública, deje el valor vacío; para el entorno de nube Azure GovUS, especifique el valor con el siguiente formato:
https://<CustomerId>.ods.opinsights.azure.us.Una vez especificada toda la configuración de la aplicación, haga clic en Guardar.
Pasos siguientes
Para obtener más información, vaya a la solución relacionada en Azure Marketplace.