本文介绍了如何在 Azure Active Directory (Azure AD) 中注册 Power BI Web 应用。 若要允许你的应用程序访问 Power BI REST API,需要将应用程序注册到 Azure Active Directory。 此操作能够为应用程序建立标识,并指定对 Power BI REST 资源的权限。 有关 Power BI 权限的列表,请参阅 Power BI 权限

重要提示 注册 Power BI 应用之前,需要 Azure Active Directory 和组织用户以及 Power BI 服务帐户

可通过两种方式注册 Web 应用:使用 Power BI 应用注册工具或在 Azure 管理门户中注册。 Power BI 应用注册工具只需填充几个字段即可,是最简单的注册方式。 如果你想对应用程序进行更改,可以通过 Azure 管理门户完成此操作。

使用 Power BI 应用注册工具注册 Web 应用

需要在 Azure Active Directory 中注册你的 Web 应用,以便为应用程序建立标识,并指定对 Power BI REST 资源的权限。 注册 Web 应用程序时,你将收到客户端 ID客户端密钥。 应用程序使用客户端 ID 向其请求权限的用户标识其自身。 Web 应用使用客户端密钥Power BI 服务安全标识其自身。

下面介绍了如何使用 Power BI 应用注册工具注册 Web 应用:

  1. 请转到 dev.powerbi.com/apps。
  2. Power BI 应用注册工具中,按照以下四个步骤进行操作:

步骤 1 - 选择登录以登录到 Azure AD 帐户。 “欢迎使用”行中将显示你的名称。

步骤 2 - 输入有关你的应用的信息。

  • 应用名称:你的应用的名称。
  • 应用类型:选择“本机应用”。
  • 重定向 URI:对于 Web 应用,重定向 URI 可为 AAD 提供有关其将进行身份验证的特定应用程序的更多详细信息。 示例重定向 URI 如下所示:http://localhost/redirect。
  • 主页:Web 应用的主页或登录页面。

步骤 3 - 选择要访问的 API。 有关 Power BI 访问权限的详细信息,请参阅 Power BI 权限

步骤 4 -单击注册应用以注册你的应用。 在 Azure AD 中注册应用后,你将收到客户端 ID客户端密钥。 请务必复制该客户端 ID 和客户端密钥。 稍后可在 Azure 管理门户中获取客户端 ID 或客户端密钥。 参阅如何在 Azure 管理门户中获取客户端 ID如何获取客户端密钥

现在可将该客户端 ID 和客户端密钥用于你的应用。 下一部分演示如何使用 Azure 管理门户 注册 Web 应用程序。

使用 Azure 管理门户注册 Web 应用

注册 Web 应用程序时,你将收到客户端 ID 和客户端密钥。 应用程序使用客户端 ID 向其请求权限的用户标识其自身。 Web 应用使用客户端密钥Power BI 服务安全标识其自身。

若要了解如何使用 Azure AD 客户端 ID 和客户端密钥对 Web 应用程序进行身份验证,请参阅对 Web 应用进行身份验证

下面介绍了如何注册客户端应用:

  1. 接受 Microsoft Power BI API 条款
  2. 在 https://manage.windowsazure.com 登录到你的 Microsoft Azure 订阅。
  3. 在左侧服务面板中,选择 ACTIVE DIRECTORY
  4. 单击任意 Active Directory。

  5. 单击应用程序

  6. 单击添加

  7. 介绍你的应用程序中,输入名称,然后选择 Web 应用程序和/或 Web API 类型,然后单击下一步图标。

  8. 应用属性中,输入登入 URL应用 ID URI登录 URL 是 Web 应用 URL,例如 https://localhost:44307。 应用 ID URI 是 Azure 租户 URI,后跟应用名称。 例如,https://yourtenant.onmicrosoft.com/YourWebApp。

  9. 单击完成图标。

  10. 在应用程序页中,选择配置配置页上显示了应用的客户端 ID密钥

    步骤 10

  11. 对于 Web 应用,你需要客户端密钥。 在密钥部分中,选择持续时间。 保存后将显示密钥。 请务必复制该密钥:否则,将来导航到配置页时将不再可使用该密钥。

  12. 配置页上,单击添加应用程序

  13. 对其他应用程序的权限中,选择 Power BI 服务

    重要提示如果在其他应用程序的权限列表中没有 Power BI 服务,则需要注册 Power BI 服务。 若要注册 Power BI 服务,需要 Azure Active Directory (AAD) 租户中存在至少一个组织用户。 如果没有 Azure Active Directory (AAD) 租户,请参阅创建 Azure Active Directory 租户,以创建 Azure AD 租户,并在该 Azure AD 租户中创建组织用户。

  14. 单击位于页面右下角的完成图标。

  15. 对其他应用程序的权限组中,下拉
    委派权限,然后选择允许你的应用调用的操作。 有关 Power BI 权限的详细信息,请参阅 Power BI 权限

  16. 单击保存

    重要说明:对于 Web 应用,需要使用客户端密钥保存后将显示客户端密钥。 请务必复制该密钥:否则,将来导航到配置页时将不再可使用该密钥。

如何获取客户端应用 ID

注册 Web 应用时,你将收到客户端 ID。 应用程序使用客户端 ID 向其请求权限的用户标识其自身。

下面介绍了如何获取客户端应用 ID:

  1. 在 https://manage.windowsazure.com 登录到你的 Microsoft Azure 订阅。
  2. 在左侧服务面板中,选择“ACTIVE DIRECTORY”。
  3. 选择任意 Active Directory。
  4. 单击“应用程序”。
  5. 选择应用程序。
  6. 在应用程序页中,选择配置
  7. 配置页中,复制客户端 ID

    步骤 1.3

如何获取客户端密钥

对于 Web 应用,你需要客户端密钥。 注册 Web 应用时,Azure AD 将生成一个密钥(请参见上面的步骤 11)。 在密钥部分中,选择持续时间。 保存后将显示密钥。 请务必复制该密钥:否则,将来导航到配置页时将不再可使用该密钥。

另请参阅

Power BI 权限
Azure Active Directory 租户和组织用户
Power BI 服务帐户
对 Web 应用进行身份验证
Power BI REST API 概述
更多问题? 尝试参与 Power BI 社区