啟用管理 API 的服務主體認證

服務主體是一種驗證方法，可用來讓 Microsoft Entra 應用程式存取 Microsoft Fabric 內容和 API。

當你建立 Microsoft Entra 應用程式時，會建立一個服務主體物件。服務主體物件，也簡稱為服務主體，允許 Microsoft Entra ID 驗證您的應用程式。一旦認證完成，應用程式即可存取 Microsoft Entra 租戶資源。

啟用服務主體身份驗證

要啟用 Fabric API 的服務主體認證，請依照以下步驟操作：

建立一個 Microsoft Entra 應用程式。如果你已經有想用的 Microsoft Entra 應用程式，可以跳過這個步驟。記得 app ID，這是你後續步驟需要的。

這很重要

確保你使用的應用程式在 Azure 入口網站沒有設定任何需要管理員同意的 Fabric 權限。看看如何檢查你的應用程式是否有這些權限。
建立一個新的 Microsoft Entra 安全群組，並確保選擇 Security 作為群組類型。如果你已經有想使用的 Microsoft Entra 安全群組，可以跳過這個步驟。
將你的應用程式 ID 加入你建立的安全群組。要達成這個目標：
1. 進入 Azure 入口網站 > 的 Microsoft Entra ID > 群組，選擇你在 步驟 2 建立的安全群組。
2. 選擇 新增會員。
啟用 Fabric 管理設定：
1. 登入 Fabric 系統管理入口網站。你需要是 Fabric 管理員才能看到租戶設定頁面。
2. 在 管理員 API 設定中，選擇你想啟用的管理員 API 類型的交換器：
  - 服務主體可以存取唯讀的管理 API （參見支援的 Power BI 管理 API）
  - 服務主體可以存取用於更新的管理員 API （參見支援的 Fabric 管理 API）
切換設定為 [啟用]。
選擇 「特定安全群組 」單選按鈕。在下方的文字欄位，新增你在 步驟 2 建立的安全群組。
選取 ，然後套用。

目前以下唯讀管理 API 支援服務主體認證。

使用服務主體認證呼叫唯讀管理員 API 的應用程式，在 Azure 入口網站 中不得 設定任何 Power BI 需要管理員同意的權限。要檢查分配的權限：

服務主體可存取用於更新的管理 API，該設定適用於 Fabric 管理 API，例如 Workspaces - 還原 Workspace API。

要了解特定 Fabric 管理 API 是否支援服務主體認證，請參考 Microsoft Fabric REST API 參考中的該 API 文件。請尋找「Microsoft Entra 支援身份」的章節，該區塊顯示是否支援服務主體認證。

此頁面對您有幫助嗎？