設定 Power BI Embedded

適用於： 應用程式擁有資料 使用者擁有資料

如果您想要開始使用 Power BI Embedded 與其他人共用報表，請使用 Power BI 內嵌式分析設定工具來開始使用。 本文會說明如何操作。

若要使用 Power BI 內嵌式分析，您必須在 Azure 中註冊 Microsoft Entra 應用程式。 Microsoft Entra 應用程式會建立 Power BI REST 資源的權限，以便讓您存取 Power BI REST API。

必要條件

若要設定 Power BI 內嵌式分析環境，您需要下列其中一項：

• Microsoft Entra 租用戶和組織 (主要) 使用者
• Power BI Pro 帳戶

開始之前

在您註冊應用程式之前，請先決定下列哪一個解決方案最符合您的需求：

• 為您的客戶
• 為您的組織

為您的客戶內嵌

如果您建立專為您的客戶設計的應用程式，請使用為您的客戶內嵌解決方案 (又稱「應用程式擁有資料」)。 使用者不需要登入 Power BI 或具有 Power BI 授權，就可以使用您的應用程式。 您的應用程式會使用主要使用者帳戶 (用於登入 Power BI 的 Power BI Pro 授權) 或服務主體來針對 Power BI 進行驗證。

「為您的客戶內嵌」解決方案通常是由獨立軟體廠商 (ISV) 以及為協力廠商建立應用程式的開發人員所使用。

為您的組織內嵌

如果您建立需要使用者使用其認證來針對 Power BI 進行驗證的應用程式，請使用為您的組織內嵌解決方案 (又稱「使用者擁有資料」)。

「為您的組織內嵌」解決方案通常是由企業與大型組織所使用，且適用於內部使用者。

如需這兩種解決方案的詳細資訊，請參閱什麼是 Power BI 內嵌式分析解決方案？ (部分機器翻譯)。

設定您的環境

在了解這兩個內嵌選項後，您可以使用設定工具來建立 Power BI Embedded 環境。

如果您想要手動設定環境，請略過下列各節中的步驟。 改為遵循本文稍後的手動註冊中的步驟。

重要

如果您要為 GCC 內嵌，請遵循手動註冊中的指示。

若要使用工具來設定您的環境，請移至 Power BI 內嵌式分析設定工具 (英文)。 選取您想要的內嵌選項。

步驟 1 - 登入 Power BI

1. 在設定工具的步驟 1 底下，選取 [登入]。 此步驟會將您登入 Power BI。 如果系統提示您挑選帳戶，請使用屬於 Power BI 租用戶的使用者來登入。 Microsoft Entra 應用程式會註冊到此使用者底下。

   

   注意

   如果您已經登入，請驗證您在登入時所使用的使用者是您想要用來建立 Microsoft Entra 應用程式的使用者。 若要變更使用者，請選取 [登出]。工具重新啟動之後，請使用正確的使用者登入。

2. 選取 [下一步] 以移至下一個步驟。

   

步驟 2 - 註冊您的應用程式

在此步驟中，您會在 Azure 中註冊 Microsoft Entra 應用程式。 Microsoft Entra 應用程式會建立 Power BI REST 資源的權限，以便讓您存取 Power BI REST API。 您稍後一律可以變更這些設定。

對客戶進行內嵌

1. 若要為您的客戶註冊您的應用程式，請填寫下列欄位：

   • 應用程式名稱 - 為您的應用程式命名。

   • API 存取 - 選取應用程式所需的 Power BI API (又稱範圍)。 您可以選取 [全選] 來選取所有 API。 如需 Power BI 存取權限的詳細資訊，請參閱 Microsoft 身分識別平台端點中的權限和同意。

   

2. 選取註冊。

3. 您 Microsoft Entra 應用程式的 [應用程式識別碼] 會顯示在 [摘要] 方塊中。 複製此值以供稍後使用。

   

為組織內嵌

1. 若要為您的組織註冊您的應用程式，請填寫下列欄位：

   • 應用程式名稱 - 為您的應用程式命名。

   • 首頁 URL - 輸入您的首頁 URL。

   • 重新導向 URL - 選取重新導向選項。 當使用者登入時，系統會將其重新導向至此位址，而您的應用程式會收到 Azure 傳來的驗證碼。 為此 URL 選擇下列其中一個選項：

     • 使用預設 URL - 這個選項會自動建立並下載內嵌式分析應用程式範例。 預設的 URL 為 http://localhost:13526/。
     • 使用自訂 URL - 如果您已經擁有內嵌式分析應用程式，也知道您想要作為重新導向 URL 的位址，便適合使用此選項。

   • API 存取 - 選取應用程式所需的 Power BI API (又稱範圍)。 選取 [全選] 來選取所有 API。 如需 Power BI 存取權限的詳細資訊，請參閱 Microsoft 身分識別平台端點中的權限和同意。

2. 選取註冊。

3. Microsoft Entra 應用程式的 [應用程式識別碼] 與 [應用程式祕密] 值會顯示在 [摘要] 方塊中。 請複製這些值以供稍後使用。

步驟 3 - 建立工作區 (選擇性)

在 Power BI 服務中建立工作區：

• 如果您已經有 Power BI 工作區，請選取 [略過]。

• 若要建立工作區，請輸入工作區的名稱，然後選取 [建立工作區]。 您的工作區名稱與識別碼會出現在 [摘要] 方塊中。 請複製這些值以供稍後使用。

  提示

  您必須使用工具建立工作區，才能讓內嵌式分析範例應用程式如預期般運作。

步驟 4 - 匯入內容 (選擇性)

選取下列其中一個選項：

• 如果您有自己的 Power BI 應用程式，可以選取 [略過]。

• 如果您想要使用範例報表建立範例 Power BI 應用程式，請選取 [範例 Power BI 報表]，然後選取 [匯入]。

• 如果您想要使用自己的報表建立範例 Power BI 應用程式，請選取 [上傳 .pbix 檔案]，瀏覽並找到您的檔案，然後選取 [匯入]。

步驟 5 - 授與權限 (僅限「為您的客戶內嵌」)

選取 [授與權限]，然後在對話方塊中選取 [接受]。 此步驟可讓您的 Microsoft Entra 應用程式使用您已登入的使用者，來存取選取的 API (又稱範圍)。 此使用者也稱為主要使用者。

下載範例應用程式 (選擇性)

如果您建立了 Power BI 的工作區，並使用此工具將內容上傳到其中，您現在可以選取 [下載範例應用程式]。

注意

即使您略過選擇性階段，您仍然可以下載範例 Power BI 應用程式。 不過，所下載應用程式中的程式碼會缺少註冊期間填入的屬性。 例如，如果您未建立工作區，則範例應用程式不會包含「工作區識別碼」。

請務必記得複製 [摘要] 方塊中的所有資訊。 Power BI 內嵌環境已可供使用。

手動註冊

如果您未使用 Power BI 內嵌式分析設定工具，請使用本節中的程序手動註冊 Microsoft Entra 應用程式。 但只有在您要建立下列其中一種解決方案時，才採取這些步驟：

• 「為您的組織內嵌」應用程式
• 搭配「服務主體」的「為您的客戶內嵌」應用程式

如需如何在 Microsoft Entra ID 中註冊應用程式的詳細資訊，請參閱使用 Microsoft 身分識別平台來註冊應用程式。

1. 登入 Azure 入口網站。

2. 在頁面的右上角選取您的帳戶，以選取您的 Microsoft Entra 租用戶。

3. 選取 應用程式註冊。 如果您沒看到此選項，請進行搜尋。

4. 在 [應用程式註冊] 中，選取 [新增註冊]。

5. 填寫下列欄位：

   • 名稱 - 為您的應用程式命名。

   • 支援的帳戶類型 - 選取可以使用應用程式的人員。

6. (選擇性) 在 [重新導向 URI] 方塊中，新增重新導向 URL。

7. 選取註冊。 註冊應用程式之後，系統會將您導向至應用程式的概觀頁面，您可以在此頁面取得「應用程式識別碼」。

相關內容

更多問題嗎？ 嘗試在 Power BI 社群提問。