你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 Microsoft Sentinel 的 Google Workspace (G Suite)（使用 Azure Functions）连接器

Google Workspace 数据连接器能够通过 REST API 将 Google 工作区活动事件引入 Microsoft Sentinel。 连接器能够获取事件，帮助检查潜在的安全风险、分析团队的协作情况、诊断配置问题、跟踪登录人员和登录时间、分析管理员活动、了解用户创建和共享内容的方式，以及查看组织中的更多事件。

这是自动生成的内容。 有关更改，请联系解决方案提供商。

连接器属性

连接器属性	说明
Azure 函数应用代码	https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp
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
数据收集规则支持	目前不支持
支持的服务	Microsoft Corporation

查询示例

Google Workspace 事件 - 所有活动

GWorkspaceActivityReports

| sort by TimeGenerated desc

Google Workspace 事件 - 管理员活动

GWorkspace_ReportsAPI_admin_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 日历活动

GWorkspace_ReportsAPI_calendar_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 驱动器活动

GWorkspace_ReportsAPI_drive_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 登录活动

GWorkspace_ReportsAPI_login_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 移动活动

GWorkspace_ReportsAPI_mobile_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 令牌活动

GWorkspace_ReportsAPI_token_CL

| sort by TimeGenerated desc

Google Workspace 事件 - 用户帐户活动

GWorkspace_ReportsAPI_user_accounts_CL

| sort by TimeGenerated desc

先决条件

若要集成 Google Workspace (G Suite)（使用 Azure Functions），请确保具备：

• Microsoft.Web/sites 权限：必须对 Azure Functions 拥有读写权限才能创建函数应用。 请参阅文档以详细了解 Azure Functions。
• REST API 凭据/权限：REST API 需要 GooglePickleString。 请参阅文档详细了解 API。 有关获取凭据的说明，请参阅下面的配置部分。 也可以查看所有要求，并按照此处的说明进行操作。

供应商安装说明

注意

此连接器使用 Azure Functions 连接到 Google Reports API，以将其日志拉取到 Microsoft Sentinel 中。 这可能会导致额外的数据引入成本。 有关详细信息，请参阅 Azure Functions 定价页。

（可选步骤）将工作区和 API 授权密钥或令牌安全地存储在 Azure 密钥保管库中。 Azure Key Vault 提供了一种存储和检索键值的安全机制。 按照这些说明，将 Azure Key Vault 与 Azure 函数应用结合使用。

注意：此数据连接器依赖于基于 Kusto 函数的分析程序才能按预期工作，该函数作为解决方案的一部分进行部署。 若要查看 Log Analytics 中的函数代码，请打开 Log Analytics/Microsoft Sentinel 的“日志”边栏选项卡，单击“函数”，搜索别名 GWorkspaceReports 并加载函数代码，或者单击此处，在查询的第二行输入 GWorkspaceReports 设备的主机名，以及日志流的任何其他唯一标识符。 安装/更新解决方案后，该函数通常需要 10-15 分钟才能激活。

步骤 1 - 确保满足获取 Google Pickel 字符串的先决条件

1. 已安装 Python 3 或更高版本。
2. pip 包管理工具可用。
3. 启用了 API 访问的 Google Workspace 域。
4. 该域中具有管理员权限的 Google 帐户。

步骤 2 - Google Reports API 的配置步骤

1. 使用工作区管理员凭据 https://console.cloud.google.com 登录到 Google 云控制台。
2. 使用搜索选项（位于顶部中间），搜索“API 和服务”
3. 从“API 和服务”->“已启用的 API 和服务”中，为此项目启用“管理员 SDK API”。
4. 转到“API 和服务”->“OAuth 许可屏幕” 如果尚未配置，请使用以下步骤创建 OAuth 许可屏幕：
   1. 提供应用名称和其他必需信息。
   2. 添加启用了 API 访问的授权域。
   3. 在“范围”部分，添加“管理员 SDK API”范围。
   4. 在“测试用户”部分中，确保已添加域管理员帐户。
5. 转到“API 和服务”->“凭据”并创建 OAuth 2.0 客户端 ID
   1. 单击顶部的“创建凭据”，然后选择“Oauth 客户端 ID”。
   2. 从“应用程序类型”下拉列表中选择“Web 应用程序”。
   3. 为 Web 应用提供合适的名称，并添加 http://localhost:8081/ 作为授权重定向 URI 之一。
   4. 单击“创建”后，从显示的弹出窗口下载 JSON。 将此文件重命名为“credentials.json”。
6. 若要提取 Google Pickel 字符串，请从保存 credentials.json 的同一文件夹中运行 python 脚本。
   1. 弹出登录窗口时，请使用域管理员帐户凭据登录。

注意：此脚本仅在 Windows 操作系统上受支持。 7. 从上一步的输出中，复制（包含在单引号中的）Google Pickle 字符串并保存备用。 在函数应用部署步骤中将需要该字符串。

步骤 3 - 从以下两个部署选项中选择一个来部署连接器和关联的 Azure 函数

重要提示：在部署 Workspace 数据连接器之前，请准备好工作区 ID 和工作区主密钥（可从下面复制），以及 Workspace GooglePickleString。

选项 1 - Azure 资源管理器 (ARM) 模板

使用此方法利用 ARM 模板自动部署 Google Workspace 数据连接器。

1. 单击下面的“部署到 Azure” 按钮。

   

2. 选择首选的“订阅”、“资源组”和“位置”。

3. 输入工作区 ID、工作区密钥、GooglePickleString 并部署。

4. 选中“我同意上述条款和条件”复选框。

5. 单击“购买”进行部署。

选项 2 - 手动部署 Azure Functions

请按照以下分步说明操作，使用 Azure Functions 手动部署 Google Workspace 数据连接器（通过 Visual Studio Code 进行部署）。

1. 部署函数应用

注意：需要为 Azure 函数开发准备 VS 代码。

1. 下载 Azure 函数应用文件。 将存档提取到本地开发计算机。

2. 启动 VS Code。 在主菜单中选择“文件”，然后选择“打开文件夹”。

3. 从提取的文件中选择顶级文件夹。

4. 在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“部署到函数应用”按钮。 如果尚未登录，请在活动栏中选择 Azure 图标，然后在“Azure: Functions”区域中选择“登录到 Azure”。如果已登录，请转到下一步。

5. 根据提示提供以下信息：

   a. 选择文件夹：从工作区中选择一个文件夹，或浏览到包含函数应用的文件夹。

   b. 选择订阅：选择要使用的订阅。

   c. 选择“在 Azure 中创建新的函数应用”（不要选择“高级”选项）

   d. 为函数应用输入全局唯一名称：键入在 URL 路径中有效的名称。 将对你键入的名称进行验证，以确保其在 Azure Functions 中是唯一的。 （例如 GWorkspaceXXXXX）。

   e. 选择运行时：选择 Python 3.8。

   f. 选择新资源的位置。 为了提高性能、降低成本，请选择 Microsoft Sentinel 所在的同一区域。

6. 将开始部署。 创建函数应用并应用了部署包之后，会显示一个通知。

7. 转到 Azure 门户，获取函数应用配置。

2. 配置函数应用

1. 在函数应用中选择“函数应用名称”，然后选择“配置”。

2. 在“应用程序设置”选项卡中，选择“新建应用程序设置”。

3. 分别添加以下每个应用程序设置及其相应的字符串值（区分大小写）：GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri（可选）

4. （可选）根据需要更改默认延迟。

   注意：已根据 Google 文档，为 Google Workspace 中的不同日志集添加了以下引入延迟默认值。 可以根据环境要求修改这些值。 提取延迟 - 10 分钟日历提取延迟 - 6 小时聊天提取延迟 - 1 天用户帐户提取延迟 - 3 小时登录提取延迟 - 6 小时

5. 使用 logAnalyticsUri 替代专用云的 log Analytics API 终结点。 例如，如果使用的是公有云，将值留空；如果使用的是 Azure GovUS 云环境，则指定以下格式的值：https://<CustomerId>.ods.opinsights.azure.us。

6. 输入所有应用程序设置后，单击“保存”。

后续步骤

有关详细信息，请转到 Azure 市场中的相关解决方案。