使用 Office 365 管理 API 收集审核日志

审核日志同步流连接到 Office 365 管理活动 API 参考以收集遥测数据,如应用的唯一用户和启动。 流使用 HTTP 操作访问 API。 在本文中,您将设置 HTTP 操作的应用程序注册以及运行流所需的环境变量。

备注

Center of Excellence(CoE)初学者工具包在没有这些流的情况下工作。 但是,如果不使用流,则应用启动和唯一用户等使用情况信息在 Power BI 仪表板中为空。

必备条件

  1. 完成 设置 CoE 初学者工具包设置清单组件中的步骤。
  2. 创建环境
  3. 使用正确的身份登录。

提示

仅当您选择云端流作为库存和遥测机制时,才设置审核日志流程。

设置审核日志流之前

在开始之前,请确保满足以下附加先决条件:

备注

要授予应用程序访问 Office 365 管理 API 的权限,可以使用 API 通过 Microsoft Entra ID 提供的身份验证服务。

为 Office 365 管理 API 访问创建 Microsoft Entra 应用注册

按照以下步骤为 Power Automate 流中的 HTTP 调用设置 Microsoft Entra 应用注册,以连接审核日志。 在开始使用 Office 365 管理 API 中了解更多信息。

  1. 登录到 Azure 门户

  2. 转到 Microsoft Entra ID>应用注册

    显示应用注册 Azure 服务位置的屏幕截图。

  3. 选择 + 新建注册

  4. 输入名称(如 Microsoft 365 管理),但不更改任何其他设置。 然后选择注册

  5. 选择 API 权限>+ 添加权限

    显示 API 权限菜单的“添加权限”按钮位置的屏幕截图。

  6. 选择 Office 365 管理 API,按如下方式配置权限:

    1. 选择 应用程序权限,然后选择 ActivityFeed.Read

      显示 API 权限菜单的“请求 API 权限”页上的 ActivityFeed.Read 设置的屏幕截图。

    2. 选择添加权限

  7. 选择为<您的组织>授予管理员同意。 详细了解设置管理员内容的 先决条件

    现在,API 权限反映的是已授权的 ActivityFeed.Read 权限,状态为<向您的组织>授予

  8. 选择证书和密码

  9. 选择 + 新客户端密码

  10. 根据您组织的策略添加描述和到期时间。 然后选择添加

  11. 将应用程序(客户端)ID 复制并粘贴到记事本文件等文本文档中。

  12. 选择概述,并将应用程序(客户端)ID 和目录(租户)ID 值复制并粘贴到同一文本文档。

    重要提示

    请确保记下哪个全局唯一标识符(GUID)对应于每个值。 在配置自定义连接器时,您将需要这些值。

更新环境变量

使用环境变量选择旧版 Office 365 管理 API 或图形 API。 在环境变量中存储应用注册的客户端 ID 和机密。 根据 HTTP 操作的云类型,使用环境变量设置 Audience 和授权服务终结点。 云类型可以是商业、美国政府社区云(GCC)、美国 GCC High 或美国国防部(DoD)。 在打开流之前更新新的 环境变量

您可以在审核日志 - 客户端密钥环境变量中以纯文本形式存储客户密钥。 但是,我们不建议使用此方法。 而是在 Azure Key Vault 中创建和存储客户端密码,并在 审核日志 - 客户端 Azure 机密 环境变量中引用它。

备注

为使用此环境变量的流配置了一个条件,以获取审核日志 - 客户端密码审核日志 - 客户端 Azure 密码环境变量。 但是,您不需要编辑流即可使用 Azure Key Vault。

名称 描述 价值
审计日志 - 使用图形 API 控制是否使用图形 API 查询事件的参数。

(默认)

同步流使用传统 Office 365 管理 API。

审核日志 - 访问群体 HTTP 调用的访问群体参数。
  • 商业(默认):https://manage.office.com
  • GCC:https://manage-gcc.office.com
  • GCC High:https://manage.office365.us
  • DoD:https://manage.protection.apps.mil
审核日志 - 权限 HTTP 调用中的授权字段。
  • 商业(默认):https://login.windows.net
  • GCC:https://login.windows.net
  • GCC High:https://login.microsoftonline.us
  • DoD:https://login.microsoftonline.us
审核日志 - ClientID 应用程序注册客户端 ID。 来自为 Office 365 管理 API 访问创建 Microsoft Entra 应用注册步骤的应用程序客户端 ID。
审核日志 - 客户端密码 纯文本形式的应用程序注册客户端密码(不是密码 ID,而是实际值)。

来自为 Office 365 管理 API 访问创建 Microsoft Entra 应用注册步骤的应用程序客户端密码。

如果使用 Azure Key Vault 存储客户端 ID 和密钥,请将此变量留空。

审核日志 - 客户端 Azure 密码 应用程序注册客户端密钥的 Azure Key Vault 参考。

来自为 Office 365 管理 API 访问创建 Microsoft Entra 应用注册步骤的应用程序客户端密码的 Azure Key Vault 参考。

如果您在审核日志 - 客户端密钥环境变量中以纯文本形式存储客户端 ID,请将此变量留空。 此变量需要 Azure Key Vault 引用,而不是机密。 了解更多信息,请参阅将环境变量用于 Azure Key Vault 密码

开启订阅审核日志内容

  1. 转到 make.powerapps.com

  2. 选择解决方案

  3. 打开卓越中心 - 核心组件解决方案。

  4. 打开 管理员 |审核日志 |Office 365 管理 API 订阅 流。 输入 start 作为要运行的操作来启动流程。

    屏幕截图显示导航栏中“运行”按钮的位置以及“运行流”窗格中的启动操作。

  5. 打开流并验证启动订阅的操作是否已通过。

重要提示

如果您之前启用了订阅,您将看到 (400) 订阅已启用消息。 此消息表示订阅已启用。 您可以忽略此消息,继续安装。

如果没有看到上述消息或 (200) 响应,请求可能会失败。 您的设置可能存在错误,导致流无法正常工作。 要检查的常见问题包括:

打开流

  1. 转到 make.powerapps.com

  2. 选择解决方案

  3. 打开卓越中心 - 核心组件解决方案。

  4. 打开管理 | 审核日志 | 更新数据 (V2) 流。 此流会用上次启动的信息更新 Power Apps 表。 它还将元数据添加到审核日志记录中。

  5. 打开管理员 | 审核日志 | 同步审核日志 (V2) 流。 该流每小时运行一次,并将审核日志事件收集到审核日志表中。

提供反馈

如果发现 CoE 初学者工具包出现问题,请在 aka.ms/coe-starter-kit-issues 针对解决方案提交 bug。