你当前正在访问 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),请确保具备:

供应商安装说明

注意

此连接器使用 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” 按钮。

    部署到 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 市场中的相关解决方案