嵌入式分析访问令牌

适用范围:️ 应用拥有数据 用户拥有数据

使用 Power BI 内容(如报表、仪表板和磁贴)需要访问令牌。 根据解决方案,此令牌可以是 Microsoft Entra 令牌嵌入令牌或两者兼有。

客户解决方案的嵌入 中,应用程序生成一个嵌入令牌,用于授予 Web 用户对 Power BI 内容的访问权限。

注释

在使用对客户解决方案的嵌入时,可以使用任何身份验证方法来允许访问您的网络应用程序。

组织解决方案的嵌入 中,Web 应用用户使用自己的凭据对 Microsoft Entra ID 进行身份验证。 你的客户有权访问他们在 Power BI 服务上有权访问的 Power BI 内容。

Microsoft Entra 令牌

对于 为客户嵌入为组织嵌入解决方案 的情况,需要一个 Microsoft Entra 令牌。 所有 REST API 操作都需要 Microsoft Entra 令牌,并且在一小时后过期。

  • 客户解决方案的嵌入 中,Microsoft Entra 令牌用于生成嵌入令牌。

  • 组织解决方案的嵌入 中,Microsoft Entra 令牌用于访问 Power BI。

可以通过以下方式之一获取 Microsoft Entra 令牌:

嵌入令牌

嵌入用于客户 解决方案时,Web 应用需要知道用户可以访问哪些 Power BI 内容。 使用 嵌入令牌 REST API 生成嵌入令牌,该令牌指定以下信息:

  • Web 应用用户可以访问的内容

  • Web 应用用户的访问级别(查看创建编辑

有关详细信息,请参阅 生成嵌入令牌时的注意事项

身份验证流

本部分介绍 客户嵌入组织嵌入解决方案的不同身份验证流。

客户解决方案的嵌入使用非交互式身份验证流。 在 供客户使用的嵌入式解决方案 中,用户无需登录 Microsoft Entra ID 即可访问 Power BI。 相反,Web 应用程序使用保留的 Microsoft Entra 身份,通过 Microsoft Entra ID 进行身份验证并生成嵌入令牌。 保留标识可以是 服务主体主用户

  • 服务主体 Web 应用使用 Microsoft Entra 服务主体对象 对 Microsoft Entra ID 进行身份验证,并获取 仅限应用的Microsoft Entra 令牌。 Microsoft Entra ID 建议使用此 仅限应用的 身份验证方法。

    使用服务主体时,需要在 Power BI 服务管理员设置中启用 Power BI API 访问。 启用访问权限允许 Web 应用访问 Power BI REST API。 若要在工作区上使用 API 操作,服务主体账号必须是工作区 的成员 或管理员。

  • 主用户 Web 应用使用用户帐户对 Microsoft Entra ID 进行身份验证,并获取 Microsoft Entra 令牌。 主用户帐户需要拥有 Power BI ProPremium Per User (PPU) 许可证。

    使用主用户帐户时,需要定义应用的 委托权限 (也称为范围)。 主用户或 租户管理员 在使用 Power BI REST API 时必须同意使用这些权限。

针对 Microsoft Entra ID 成功进行身份验证后,Web 应用会生成 嵌入令牌 ,以允许用户访问特定的 Power BI 内容。

注释

  • 要使用为客户嵌入解决方案,需要具备 A、EM 或 P SKU 的容量。
  • 若要 迁移到生产环境,需要一个容量。

下图显示了 为客户解决方案嵌入 的身份验证流。

为客户 Power BI 嵌入式分析解决方案嵌入的身份验证流示意图。

  1. Web 应用用户使用身份验证方法针对 Web 应用进行身份验证。

  2. Web 应用使用服务主体或主用户来对 Microsoft Entra ID 进行身份验证。

  3. Web 应用从 Microsoft Entra ID 获取 Microsoft Entra 令牌,并使用它来访问 Power BI REST API。 选择的身份验证方法授予对 Power BI REST APIS 的访问权限,具体取决于身份验证方法是服务主体还是主用户。

  4. Web 应用调用 嵌入令牌 REST API 操作并请求嵌入令牌。 嵌入令牌指定可嵌入哪些 Power BI 内容。

  5. REST API 将嵌入令牌返回到 Web 应用。

  6. Web 应用将嵌入令牌传递给用户的 Web 浏览器。

  7. Web 应用用户使用嵌入令牌访问 Power BI。

更多问题? 尝试询问 Power BI 社区