使用 Microsoft Entra ID 設定使用者驗證

發行項
04/22/2024

重要

在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後，Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。

當我們更新文件和培訓內容時，某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。

為您的副手新增驗證允許使用者登入，從而使您的副手能夠存取受限資源或資訊。

本文介紹如何將 Microsoft Entra ID 設定為您的服務提供者。若要大致了解其他服務提供者和使用者驗證，請參閱設定使用者驗證。

如果您擁有租用戶管理權限，則可以設定 API 權限。否則，您需要請租用戶管理員為您完成此操作。

先決條件

了解如何在主題中使用使用者驗證。

在 Azure 入口網站中完成前幾個步驟，並完成 Copilot Studio 中的最後兩個步驟。

建立應用程式註冊

使用與您的副手位於相同租用戶中的管理帳戶登入 Azure 入口網站。
若要移至應用程式註冊 ，請選取圖示或在頂端搜尋欄中搜尋。
選取新增註冊然後輸入註冊的名稱。

稍後使用副手的名稱會很有幫助。例如，如果您的副手名為「Contoso 銷售説明」，您可以將應用程式註冊命名為「ContosoSalesReg」。
在支援的帳戶類型底下，選取任何組織目錄中的帳戶 (任何 Microsoft Entra ID 目錄 - 多租用戶) 和個人 Microsoft 帳戶 (例如 Skype、Xbox)。
將重新導向 URI 區段保留空白。在後續步驟中輸入資訊。
選取註冊。
註冊完成之後，移至概觀。
複製應用程式 (用戶端) 識別碼，並在暫存檔案中將其貼上。在後續步驟中會需要它。

新增重新導向 URL

移至驗證，然後選取新增平台。
在平台設定底下，選取新增平台，然後選取 Web。
在重新導向 URI 底下，輸入 https://token.botframework.com/.auth/web/redirect 和 https://europe.token.botframework.com/.auth/web/redirect。

注意

Copilot Studio 中的驗證設定窗格可能會顯示以下重新導向 URL：https://unitedstates.token.botframework.com/.auth/web/redirect 使用該 URL 會使驗證失敗; 請改用 URI。

在隱含授與和混合流程區段中，開啟存取權杖 (用於隱含流程) 和識別碼權杖 (用於隱含和混合流程)。
選取設定。

產生用戶端密碼

移至憑證及密碼。
在用戶端密碼區段底下，選取新增用戶端密碼。
(選用) 輸入描述。如果保留空白，則系統會提供。
選取到期期間。選取與您的副手生命週期相關的最短期間。
選取新增以建立密碼。
將密碼的值儲存在安全的暫存檔案中。當您稍後設定副手驗證時，將會需要它。

提示

複製用戶端密碼的值之前，不要離開此頁面。如果這樣做，則會對該值進行模糊處理，並且必須產生新的用戶端密碼。

設定手動驗證

在 Copilot Studio 導覽功能表的設定底下，選取安全性。接著選取驗證卡片。
選取手動 (適用於任何通道，包括 Teams)，然後開啟要求使用者登入。
輸入以下屬性值：
- 服務提供者：選取 Microsoft Entra ID。
- 用戶端識別碼：輸入您稍早從 Azure 入口網站複製的應用程式 (用戶端) 識別碼。
- 用戶端密碼：輸入先前從 Azure 入口網站產生的用戶端密碼。
- 範圍：輸入 profile openid。
選取儲存完成設定。

設定 API 權限

移至 API 權限。
選取代表 <租用戶名稱> 授與管理員同意，然後選取是。如果該按鈕不可用，則可能需要請租用戶管理員為您輸入。

注意

為了避免使用者逐一對每個應用程式表示同意，全域系統管理員、應用程式系統管理員或雲端應用程式系統管理員可以將租用戶範圍的同意授與您的應用程式註冊。
選取新增權限，然後選取 Microsoft Graph。
選取委派的權限。
展開 OpenId 權限，並開啟 OpenId 和設定檔。
選取新增權限。

為您的副手定義自訂範圍

範圍可讓您判斷使用者和管理角色以及存取權限。您可以為在後續步驟中建立的畫布應用註冊建立自訂範圍。

移至公開 API 並選取新增範圍。

設定下列屬性。您可以讓其他屬性保持空白。

屬性	數值
範圍名稱	輸入對您的環境有意義的名稱，例如 `Test.Read`
誰可以同意？	選取管理員和使用者
管理員同意顯示名稱	輸入對您的環境有意義的名稱，例如 `Test.Read`
管理員同意描述	輸入 `Allows the app to sign the user in.`
州/省	選取已啟用

選取新增範圍。

在 Microsoft Copilot Studio 中設定驗證

在 Copilot Studio 的設定底下，選取安全性，然後選取驗證。
選取手動 (用於自訂網站)。
開啟要求使用者登入。

設定下列屬性。

屬性	數值
服務提供者	選取 Microsoft Entra ID
用戶端識別碼	輸入先前在 Azure 入口網站中複製的應用程式 (用戶端) 識別碼
Client secret	輸入先前在 Azure 入口網站中產生的用戶端密碼
範圍	輸入 `profile openid`

選取儲存。

提示

權杖交換 URL 是用來結算所要求存取權杖的代表 (OBO) 權杖。如需詳細資訊，請參閱為您的自訂網站設定單一登入。

測試您的副手

發佈您的副手。
在測試副手窗格中，向副手發送訊息。
當副手回應時，選擇登入。

新的瀏覽器索引標籤會開啟，並要求您登入。
登入，然後複製顯示的驗證碼。
將程式碼貼到副手聊天中以完成登入程式。

共用方式為