本文將說明如何在 Azure Active Directory (Azure AD) 中註冊 Power BI Web 應用程式。 若要允許您的應用程式存取 Power BI REST API,您必須向 Azure Active Directory註冊應用程式。 這可讓您建立應用程式的身分識別,並指定其對於 Power BI REST 資源的權限。 如需 Power BI 權限的清單,請參閱 Power BI permissions (Power BI 權限)

重要您需要有 Azure Active Directory 和組織使用者以及 Power BI 服務帳戶,才能註冊 Power BI 應用程式。

有兩種方式可以註冊您的 Web 應用程式,分別是使用 Power BI 應用程式註冊工具,或在 Azure 管理入口網站進行註冊。 由於 Power BI 應用程式註冊工具只需填寫幾個欄位,所以算是最簡簡單的途徑。 如果您要變更應用程式,可透過 Azure 管理入口網站來完成。

使用 Power BI App 註冊工具註冊 Web 應用程式

您必須在 Azure Active Directory 中註冊 Web 應用程式,才能建立應用程式的身分識別,以及指定 Power BI REST 資源的權限。 當您註冊 Web 應用程式時,會收到 用戶端識別碼用戶端秘密金鑰。 應用程式會使用此 用戶端識別碼 ,向正對其要求權限的使用者識別自己的身分。 Web 應用程式會使用用戶端秘密 金鑰 ,安全地向 Power BI 服務識別自己的身分。

以下是使用[Power BI App 註冊工具] 註冊 Web 應用程式的方法:

  1. 請前往 dev.powerbi.com/apps。
  2. Power BI 應用程式註冊工具中,遵循下列四個步驟:

步驟 1 -選擇 登入 來登入您的 Azure AD 帳戶。 您會在 [歡迎使用] 列看到您的名稱。

步驟 2 – 輸入 App 的相關資訊。

  • 應用程式名稱:您的應用程式名稱。
  • 應用程式類型:選擇原生應用程式。
  • 重新導向 URI:在 Web 應用程式中,重新導向 URI 會提供 AAD 所要驗證之特定應用程式的詳細資訊。 重新導向 URI 範例會類似:http://localhost/redirect。
  • 首頁:您 Web 應用程式的首頁或登入頁面。

步驟 3 – 選擇要存取的 API。 如需 Power BI 存取權限的詳細資訊,請參閱 Power BI Permissions (Power BI 權限)

步驟 4 -若要註冊您的應用程式,請按一下 [註冊應用程式]。 在 Azure AD 中註冊應用程式之後,您會得到用戶端識別碼用戶端密碼金鑰。 請確認您已複製用戶端識別碼和用戶端秘密金鑰。 您稍後可以從 Azure 管理入口網站取得用戶端識別碼或用戶端秘密金鑰。 請參閱如何在 Azure 管理入口網站取得用戶端識別碼如何取得用戶端秘密金鑰

您現在可以使用 App 的用戶端識別碼和用戶端密碼。 下一節說明如何使用 Azure 管理入口網站註冊 Web 應用程式。

向 Azure 管理入口網站註冊 Web 應用程式

當您註冊 Web 應用程式時,會收到 用戶端識別碼 和用戶端秘密 金鑰。 應用程式使用這個用戶端識別碼,向要求權限的對象使用者識別自己的身分。 Web 應用程式使用用戶端秘密金鑰安全地向 Power BI 服務識別其身分。

若要了解如何使用 Azure AD 用戶端識別碼和用戶端密碼金鑰來驗證 Web 應用程式,請參閱驗證 Web 應用程式

以下是註冊用戶端應用程式的方法:

  1. 接受 Microsoft Power BI API 條款
  2. 登入您的 Microsoft Azure 訂用帳戶,網址是:https://manage.windowsazure.com。
  3. 在左側服務面板中,選擇 [ACTIVE DIRECTORY]。
  4. 按一下任何一個 Active Directory。

  5. 按一下 [應用程式] 。

  6. 按一下 [新增] 。

  7. 在 [告訴我們您的應用程式] 中輸入 名稱,再針對類型選擇 [Web 應用程式和/或 Web API] ,然後按一下 下一步 圖示。

  8. 在 [應用程式屬性] 中輸入登入 URL應用程式識別碼 URI登入 URL 是您的 Web 應用程式 URL,例如 https://localhost:44307。 應用程式識別碼 URI 是您的 Azure 租用戶 URI,後面接著您的應用程式名稱。 例如 https://yourtenant.onmicrosoft.com/YourWebApp。

  9. 按一下 [完成] 圖示。

  10. 在應用程式頁面中,選擇 [設定]。 [設定] 頁面包含您應用程式的用戶端識別碼金鑰

    步驟 10

  11. 在 Web 應用程式中,您需要用戶端秘密 金鑰。 在 [金鑰] 區段中選取持續時間。 [儲存] 後即會顯示金鑰。 請務必複製此金鑰,否則日後巡覽至組態頁面時將無法再加以使用。

  12. 在 [組態] 頁面上,按一下 [加入應用程式] 。

  13. 在 [其他應用程式的權限] 中,選擇 [Power BI 服務]。

    重要:若 [其他應用程式的權限] 清單中未顯示 [Power BI 服務],您必須註冊 Power BI 服務。 若要註冊 Power BI 服務,您的 Azure Active Directory (AAD) 租用戶中至少須有一個組織使用者。 如果沒有 Azure Active Directory (AAD) 租用戶,請參閱 Create an Azure Active Directory tenant (建立 Azure Active Directory 租用戶),以建立 Azure AD 租用戶,並在 Azure AD 租用戶中建立組織使用者。

  14. 按一下頁面右下角的 [完成] 圖示。

  15. 在 [其他應用程式的權限] 群組,展開
    [委派的權限] 下拉式清單,然後選擇您的應用程式可以呼叫哪些作業。 如需 Power BI 權限的詳細資訊,請參閱 Power BI Permissions (Power BI 權限)

  16. 按一下 [儲存]。

    重要 在 Web 應用程式中,您需要用戶端祕密金鑰。 [儲存] 後即會顯示用戶端秘密 金鑰 。 請務必複製此金鑰,否則日後巡覽至組態頁面時將無法再加以使用。

如何取得用戶端應用程式識別碼

當您註冊 Web 應用程式時,會收到 用戶端識別碼。 應用程式使用這個用戶端識別碼,向要求權限的對象使用者識別自己的身分。

以下是取得用戶端應用程式識別碼的方法:

  1. 登入您的 Microsoft Azure 訂用帳戶,網址是:https://manage.windowsazure.com。
  2. 在左側服務面板中,選擇 [ACTIVE DIRECTORY]。
  3. 選擇任何一個 Active Directory。
  4. 按一下 [應用程式]。
  5. 選擇應用程式。
  6. 在應用程式頁面中,選擇 [設定]。
  7. 在 [設定] 頁面中,複製 用戶端識別碼

    步驟 1.3

如何取得用戶端密碼

在 Web 應用程式中,您需要用戶端秘密 金鑰。 當您註冊 Web 應用程式時,Azure AD 會產生金鑰 (請參閱上方步驟 11)。 在 [金鑰] 區段中選取持續時間。 儲存之後即會顯示金鑰。 請務必複製此金鑰,否則日後巡覽至組態頁面時將無法再加以使用。

另請參閱

Power BI 權限
Azure Active Directory 租用戶和組織使用者
Power BI 服務帳戶
驗證 Web 應用程式
Power BI REST API 概觀
有其他問題嗎? 試試 Power BI 社群