了解如何在 Azure Active Directory (Azure AD) 內註冊應用程式,以用來內嵌 Power BI 內容。

您可以向 Azure AD 註冊應用程式,讓您的應用程式存取 Power BI REST API。 這可讓您建立應用程式的身分識別,並指定其對於 Power BI REST 資源的權限。

重要事項:

註冊 Power BI 應用程式之前,您需要有 Azure Active Directory 租用戶和組織使用者。 如果您尚未以租用戶中的使用者來註冊 Power BI,則無法順利完成應用程式註冊。

有兩種方式可以註冊您的應用程式。 第一種方法是使用 Power BI 應用程式註冊工具,或者,您也可以直接在 Azure 入口網站中這樣做。 由於 Power BI 應用程式註冊工具只需填寫幾個欄位,所以算是最簡簡單的途徑。 如果您要變更應用程式,這可透過 Azure 入口網站來完成。

使用 Power BI 應用程式註冊工具來註冊

您必須在 Azure Active Directory 中註冊應用程式,才能建立應用程式的身分識別,以及指定對於 Power BI REST 資源的權限。 當您註冊應用程式時,例如主控台應用程式或網站,您會收到識別碼,應用程式會利用此識別碼,向要求權限的使用者表明自己的身分。

以下是使用 Power BI 應用程式註冊工具來註冊應用程式的方法:

  1. 請前往 dev.powerbi.com/apps

  2. 選取 [使用您的現有帳戶登入]。

  3. 提供 [應用程式名稱]。

  4. [應用程式類型] 選擇取決於您使用的應用程式類型。

    • 若是 Web 應用程式或 Web API,請使用 [伺服器端 Web 應用程式]。
    • 若是在用戶端裝置上執行的應用程式,請使用 [原生應用程式]。 如果您要針對非 Power BI 使用者來內嵌內容,而不論實際應用程式是什麼,「您也會選擇」原生應用程式。
  5. 輸入 [重新導向 URL] 和 [首頁 URL] 的值。 任何有效的 URL 都可運作。

    注意:

    只有當您選擇 [伺服器端 Web 應用程式] 作為應用程式類型時,才可使用 [首頁 URL]。

  6. 選擇此應用程式將能存取的 API。 如需 Power BI 存取權限的詳細資訊,請參閱 Power BI Permissions (Power BI 權限)

  7. 選取 [註冊應用程式]。

    接著會提供用戶端識別碼給您。 如果您選取 [伺服器端 Web 應用程式],則還會收到用戶端祕密。 以後需要的話,這些都可以從 Azure 入口網站中擷取。

現在,您可以在自訂應用程式中,使用已註冊的應用程式來與 Power BI 服務互動。

使用 Azure 入口網站註冊

註冊應用程式的另一個選項是直接在 Azure 入口網站中進行。 若要註冊您的應用程式,請遵循下列步驟。

  1. 接受 Microsoft Power BI API 條款

  2. 登入Azure 入口網站

  3. 在頁面的右上角選取您的帳戶,以選擇您的 Azure AD 租用戶。

  4. 在左側導覽窗格中,選擇 [更多服務],選取 [應用程式註冊],然後選取 [新增應用程式註冊]。

  5. 遵循提示並建立新的應用程式。

    • 若是 Web 應用程式,請提供 [登入 URL],也就是應用程式的基底 URL,可供使用者登入,例如 http://localhost:12345。
    • 若是原生應用程式,請提供 [重新導向 URI],供 Azure AD 用來傳回權杖回應。 輸入您的應用程式專用的值,例如 http://MyFirstAADApp

如需如何在 Azure Active Directory 中註冊應用程式的詳細資訊,請參閱整合應用程式與 Azure Active Directory

如何取得用戶端識別碼

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

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

  1. 登入Azure 入口網站

  2. 在頁面的右上角選取您的帳戶,以選擇您的 Azure AD 租用戶。

  3. 在左側導覽窗格中,選擇 [更多服務],然後選取 [應用程式註冊]。

  4. 選取您想要擷取用戶端識別碼的應用程式。

  5. 您會看到以 GUID 列出的 [應用程式識別碼]。 這就是應用程式的用戶端識別碼。

後續步驟

內嵌在 Power BI 之中
如何內嵌 Power BI 儀表板、報告和圖格
Power BI 權限
建立 Azure Active Directory 租用戶

有其他問題嗎? 嘗試在 Power BI 社群提問