使用者認證讓使用者能登入,讓你的代理能代表他們存取受限制的資源或資訊。 使用者可透過 Microsoft Entra ID 或 OAuth 2.0 身份提供者(如 Google 或 Facebook)登入。
Note
對於使用手動驗證的 Microsoft Teams 部署,請參閱 在 Teams 中為代理程式設定使用 Microsoft Entra ID 的 SSO(單一登入)中的部署需求。
您可以在編輯主題時向主題新增使用者驗證。
Important
認證設定的變更只有在你發佈代理程式後才會生效。 在對代理人進行認證變更前,請提前規劃。
選擇驗證選項
Note
在選擇驗證選項前,請先檢視以下 Power BI 整合限制。 使用 Microsoft 認證(Entra ID)的 Copilot Studio 代理無法嵌入使用 iframe 視覺化的 Power BI 報表中。
Copilot Studio 支援多種認證選項。 選擇並設定符合您需求的選項。
前往 Agent 的設定,然後選擇安全性。
選取驗證。
選擇驗證選項並依需求設定。 下列是可用的驗證選項:
選取 [儲存]。
無驗證
無驗證代表您的 Agent 在與 Agent 互動時,不要求您的使用者登入。 未經鑑別的設定代表您的 Agent 只能存取公共資訊和資源。 傳統聊天機器人預設設定為不需要驗證。
當 Power Platform 管理中心設定資料 政策 需要驗證時,這個選項就無法使用。
Caution
選擇無驗證選項允許任何擁有連結的人與您的機器人或 Agent 聊天和互動。
我們建議您啟用驗證,尤其是在您於組織內部使用機器人或代理程式,或供特定使用者使用時,並搭配其他安全性與治理控制。
使用 Microsoft 進行驗證
Important
若要透過內建的 Teams + Microsoft 365 管道發佈,請使用 Authenticate with Microsoft。 如果你的認證設定阻擋了該通道,請檢查 agent status。 若是 Teams 中的手動驗證部署,請遵循另外的 Teams SSO 和應用程式資訊清單需求。
此外,Authenticate with Microsoft 選項對於整合 Dynamics 365 Customer Service 的代理商來說,並不適用。
此設定能為 Teams、SharePoint、Power Apps 及 Microsoft Copilot 自動設定 Microsoft Entra ID 驗證,無需手動設定。 在 Teams 中,除非你的代理程式需要擴充範圍,否則使用者不會被要求登入。
如果你需要在其他頻道進行認證,請選擇 手動驗證。
如果您選取「使用 Microsoft 驗證」,在 Web 應用程式和 Teams 方案中,主題製作畫布都可以使用下列變數:
User.IdUser.DisplayName
在網頁應用程式中,User.IsLoggedIn 和額外的設定檔變數也可使用。 在 Teams 方案中,此選項無法使用 User.IsLoggedIn。 如需深入了解,請參閱驗證變數。
User.AccessToken 無法與此選項搭配使用。 如果你需要認證令牌,請使用 手動驗證。
如果你從手動認證改成使用 Microsoft 認證,參考User.AccessToken會變成未知變數。 在 Teams 計畫中,對 User.IsLoggedIn 的參照也會變成 未知 變數。 發佈 Agent 之前,請先修正所有主題錯誤。
手動驗證
Copilot Studio 支援以下認證服務提供者,採用 Authenticate manually選項:
- Microsoft Entra ID V2 搭配聯邦憑證
- 具有憑證的 Microsoft Entra ID V2
- Microsoft Entra ID V2 搭配用戶端密鑰
- Microsoft Entra ID
- 通用 OAuth 2:任何符合 OAuth 2.0 標準的身份提供者
如果選擇手動驗證,以下變數將可在主題創作畫布中使用:
User.IdUser.DisplayNameUser.AccessTokenUser.IsLoggedIn
如需這些變數的詳細資訊,請參閱「將使用者驗證新增至主題」。
Note
- 驗證變更只有在你發佈代理程式後才會生效。
- 可在 Power Platform 中使用對應的管理控制項來控制此設定。 開啟此控制項後,就無法在 Copilot Studio 中開啟或關閉「手動驗證」選項。 控制項始終開啟,且手動驗證選項在 Copilot Studio 中無法修改。
必要的使用者登入和 Agent 共用
「要求使用者登入」設定決定使用者是否需要登入才能與助理交談。 為需要存取敏感或受限制資訊的客服人員開啟此設定。
此選項不可用於無驗證和透過 Microsoft 進行驗證選項。
Note
當 Power Platform 管理中心的資料政策設定為需要驗證時,你無法關閉這個選項。 如需詳細資訊,請參閱 設定客服專員的資料原則。
如果您關閉此選項,您的 Agent 不會要求使用者登錄,直到您遇到需要使用者登入的主題。
當您打開此選項時,會建立一個名為要求使用者登入的系統主題。 此主題僅與手動驗證設定相關。 若要在支援的 Teams 聊天中自動登入,請使用「使用 Microsoft 驗證」。
「要求使用者登入」主題會自動針對任何與代理對話而未經過驗證的使用者觸發。 如果使用者無法登入,主題會重新導向至升級系統主題。
主題是唯讀的,因此無法自訂。 若要查看它,請選取前往創作畫布。
控制誰可以與組織中的 Agent 聊天
你的代理驗證類型與 「要求使用者登入 」設定的組合,決定你是否能 共享代理 ,以控制組織中誰能與它聊天。 驗證設定不會影響共用 Agent 以進行協作。
無需驗證:任何擁有該代理連結(或能在你網站上找到)的用戶都可以與其聊天。 您無法控制組織中的哪些使用者可以與 Agent 聊天。
使用 Microsoft 驗證:Agent 會在 Teams、SharePoint、Power Apps 和 Microsoft Copilot 中使用 Microsoft Entra ID 驗證。 使用者已經登入,所以你不需要另外設定「要求使用者登入」。 您可以使用代理共用功能來控制組織中誰可以與代理聊天。
手動驗證:
如果服務提供者是Microsoft Entra ID,你可以開啟要求用戶登入來控制組織中誰能透過代理共享與客服人員聊天。
如果服務提供者是 通用 OAuth 2,你可以開啟或關閉 強制使用者登入 。 打開後,登入的使用者可以與 Agent 聊天。 您無法控制組織中哪些特定使用者可以透過代理共享與代理聊天。
當 Agent 的驗證設定無法控制誰可以與其聊天時,如果您在 Agent 的概述頁面上選擇共用,則會顯示一條訊息,通知您任何人都可以與您的 Agent 聊天。
手動驗證欄位
下表描述了您在設定手動驗證時可能遇到的欄位。 您看到的具體欄位取決於您選擇的服務提供者。
| 欄位名稱 | Description |
|---|---|
| 授權 URL 範本 | 識別提供者所定義之授權的 URL 範本。 例如, https://login.microsoftonline.com/common/oauth2/v2.0/authorize |
| 授權 URL 查詢字串範本 | 授權的查詢範本,由您的識別提供者所提供。 查詢字串範本中的鍵會視識別提供者而不同 (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State})。 |
| 用戶端識別碼 | 從識別提供者取得的用戶端識別碼。 |
| 客戶端密碼 | 您的用戶端密碼會在建立識別提供者應用程式註冊時取得。 |
| 用戶端憑證金鑰保存庫網址 (URL) | 存放客戶端憑證的 KeyVault 網址。 需要使用憑證進行 Microsoft Entra ID 認證。 |
| 授與類型 | 你想使用的 OAuth 2.0 授權類型。 |
| 是否需要 x5c 宣告 | 指定權杖要求中是否需要 x5c 宣告。 需要使用憑證進行 Microsoft Entra ID 認證。 |
| 登入網址 (URL) | 使用者被引導登入的網址。 |
| 重新整理本文範本 | 重新整理本文的範本 (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret})。 |
| 重新整理 URL 查詢字串範本 | 權杖 URL 的重新整理 URL 查詢字串分隔符號,通常是問號 (?)。 |
| 重新整理 URL 範本 | 要進行重新整理的 URL 範本; 例如,https://login.microsoftonline.com/common/oauth2/v2.0/token。 |
| 資源網址 | 請求權杖所對應的資源 URL。 |
| 範疇清單分隔符號 | 範圍清單的分隔符號字元。 此欄位不支援空格。1 |
| 範圍 | 您希望使用者登入後擁有的範圍清單。 使用範圍清單分隔符號來分隔多個範圍。1僅設定必要的範圍,並遵循最小權限存取控制原則。 |
| 服務提供者 | 您要用來進行驗證的服務提供者。 了解更多請參閱 OAuth 通用提供者。 |
| 租戶識別碼 | 您的 Microsoft Entra ID 租戶識別碼。 在「如何找到您的 Microsoft Entra 租戶 ID」中了解更多。 |
| 權杖本文範本 | 權杖本文的範本。 (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret}) |
| 權杖交換 URL (單一登入 (SSO) 所需) | 設定單一登入時為必填;否則為選填。 |
| 令牌 URL 範本 | 代幣的 URL 範本,由您的身份提供者所提供; 例如,https://login.microsoftonline.com/common/oauth2/v2.0/token。 |
| 令牌 URL 查詢字串範本 | 權杖 URL 的查詢字串分隔符號,通常是問號 (?)。 |
1 如果識別提供者需要,您可以在範圍欄位中使用空格。 在這種情況下,請在,中輸入逗號 (),並在範圍欄位中輸入空格。
關閉驗證
開啟 Agent 後,選擇頂部功能表列上的設定。
選擇 安全性,然後再選擇 驗證。
選取 無驗證。
如果主題使用認證變數,它們會變成 未知 變數。 進入主題頁面查看哪些主題有錯誤,並在發布前修復它們。
選擇 儲存,然後發佈代理。
Important
如果你的代理程式有 設定需要使用者憑證的工具,請不要在代理層關閉認證。 此舉阻止這些工具發揮作用。