秘訣
推薦項目: 從 Work IQ 開發工具 開始,支援專業程式碼宣告式代理程式和外掛程式案例。 請參閱 WIQD 快速入門。 工具組式指示仍然適用於需要工具組的指示的現有專案和工作流程。 在選擇工具之前,請先檢查 功能和目標體驗支援 : WIQD 不會以自訂引擎代理程式為目標。
Microsoft Entra單一登入 (SSO) 驗證可讓使用者使用其現有的Microsoft Entra ID認證進行驗證。 此整合簡化了存取管理,並確保與 MCP) 伺服器或 API (模型上下文協定的安全連接,而無需額外的憑證。 您的 MCP 伺服器或 API 必須使用 Entra ID 來控制存取。
本文使用 MCP 外掛程式作為預設逐步解說。 除非有特別說明,否則相同的步驟也適用於從 OpenAPI 文件建置的 API 外掛程式。
透過四個步驟設定 Entra SSO 驗證:註冊 Entra 應用程式以保護您的 MCP 伺服器、建立驗證設定、更新 Entra 應用程式註冊,以及將新的權杖受眾新增至您的 API。
第 1 步:註冊 Entra 應用程式以保護您的 MCP 伺服器
您的 MCP 伺服器或 API 必須由 Entra 應用程式註冊保護。 如果您還沒有,請在 Microsoft Entra 系統管理中心註冊應用程式。 記下應用程式的 用戶端識別碼 - 您在 步驟 2 中建立驗證設定時提供的用戶端識別碼。
步驟 2:建立 Entra SSO 驗證組態
Entra SSO 驗證仰賴驗證設定 (驗證設定) - 儲存在 Microsoft 企業版權杖存放區中的記錄,Microsoft 365 Copilot 用來取得 MCP 外掛程式的權杖。 從支援的專業程式碼專案的 WIQD 開始。 工具組、開發人員技能和 Teams 開發人員入口網站程序仍然可用做為替代方案。
無論您如何建立,驗證設定都會有 驗證設定識別碼 和 應用程式識別碼 URI。 您可以在步驟 3 和步驟 4 中使用應用程式識別碼 URI。
使用 Work IQ 開發工具 (建議)
對於 MCP 動作,請搭配--mcp-server-url使用 wiqd agent add action ,--mcp-auth-type entra-sso並--mcp-client-id設定為步驟 1 中的 Entra 應用程式用戶端識別碼。 針對 OpenAPI 動作,請使用 --openapi-auth-identity-provider microsoft-entra 和 --openapi-auth-client-id。 有關其他必要動作選項,請參閱 WIQD 動作命令指南 。
對於現有的外掛程式資訊清單,請搭配--plugin-manifest使用 wiqd agent add auth 、 --auth-name和 --auth-type microsoft-entra。 提供針對該命令記錄的識別提供者選項,包括 --oauth-client-id。 完成專案的佈建工作流程,取得驗證組態的 應用程式識別碼 URI,然後繼續進行步驟 3 和步驟 4。
使用 Microsoft 365 代理程式工具組
當您在 Microsoft 365 代理程式工具組中使用 MCP 外掛程式建立代理程式時,工具組會在您新增 MCP 伺服器外掛程式時提示您輸入驗證類型。 選取 [Microsoft Entra SSO],並提供步驟 1 中 Entra 應用程式的用戶端識別碼。 Agents Toolkit 會在企業權杖存放區中建立驗證組態、產生驗證組態識別碼,並自動更新外掛程式資訊清單中的 執行階段驗證物件 。
使用宣告式代理程式開發人員技能
宣告式代理程式開發人員技能 (declarative-agent-developer) 是 Microsoft Work IQ 中的代理程式技能,包含建置宣告式代理程式所需的知識。 使用自然語言向 Copilot 或 GitHub CLI 描述您想要的內容,而非自行執行命令或編輯資訊清單。 此技能會建立宣告式代理程式的基架、新增 MCP 外掛程式,並為您處理驗證設定。 此技能僅支援 MCP 外掛程式。 當您新增使用 Entra SSO 的 MCP 伺服器時,此技能會在企業權杖存放區中建立驗證組態,並更新外掛程式資訊清單,而無需手動步驟。
秘訣
如需使用宣告式代理程式開發人員技能的影片逐步解說,請參閱 使用宣告式代理程式開發人員技能建置宣告式代理程式。
使用 Teams 開發人員入口網站
如果您使用 Agents Toolkit 或宣告式代理程式開發人員技能,則在 Teams 開發人員入口網站註冊為選擇性。 當您想要手動建立驗證組態時,或更常見的是管理 Agents Toolkit 或技能已建立的授權組態時,請使用它。 在入口網站中,您可以將驗證設定限制為特定 Teams 應用程式或 Microsoft 365 組織,並修改其他屬性。
開啟 Teams 開發人員入口網站。 選取 [工具] ->[Microsoft Entra SSO 用戶端識別碼註冊]。
如果您沒有現有的註冊,請選取 [註冊用戶端識別碼]。 如果您有現有註冊,請選取 [新增用戶端註冊]。
填寫下列欄位。
- 註冊名稱:註冊的易記名稱。
-
基底 URL:您的 API 基底 URL。 此值應對應至 MCP 型外掛程式的外掛程式資訊清單中 MCP 伺服器規格物件屬性中的
urlURL,或 API 外掛程式的 OpenAPI 文件中陣列中的servers項目。 - 依組織限制使用情況:選取哪個 Microsoft 365 組織可以存取您的應用程式以存取 API 端點。
- 依應用程式限制使用方式:如果您不知道最終的應用程式識別碼,請選取 [任何 Teams 應用程式]。 發佈應用程式之後,請將此註冊與已發佈的應用程式識別碼繫結。
- 用戶端識別碼:在 Entra 中註冊之應用程式的用戶端識別碼。
- 範圍:您的外掛程式向 Entra 要求的權限。 與 OAuth 2.0 一樣,請使用 Entra 應用程式和 API 所需的範圍值。
選取 [儲存]。
完成註冊會建立驗證設定,並產生驗證設定識別碼 (目前在 Teams 開發人員入口網站) 中標示為 Microsoft Entra SSO 註冊識別碼和應用程式識別碼 URI。
將驗證設定識別碼新增至外掛程式資訊清單
當您在 Teams 開發人員入口網站手動建立驗證設定時,請將執行階段驗證物件的屬性設定type為 OAuthPluginVault,並將 設定為reference_id驗證設定識別碼。 Agents Toolkit 和宣告式代理程式開發人員技能可為您執行此工作。
"auth": {
"type": "OAuthPluginVault",
"reference_id": "auth config ID"
},
步驟 3:更新 Entra 應用程式註冊
無論您在步驟 2 中如何建立驗證設定,請完成下列步驟。
開啟 Microsoft Entra 系統管理中心。 使用 SSO 註冊中的應用程式識別碼 URI,更新保護 MCP 伺服器或 API 的 Entra 應用程式註冊。 如果您有對應至應用程式註冊的現有應用程式識別碼 URI,請使用資訊清單編輯器在 identifierUris 區段中新增另一個 URI。
"identifierUris": [ "<<URI1>>", "<<URI2>>" ]注意
您無法透過 Entra 系統管理中心的 UI 新增多個 URI。 UI 只會顯示清單中的第一個 URI。 新增多個 URI 不會影響您現有的 URI 和範圍,即使它們在 UI 中的顯示方式不同。
選取 [管理] 底下的 [驗證]。 新增至
https://teams.microsoft.com/api/platform/v1.0/oAuthConsentRedirectWeb 平台中的重新導向 URI。選取 [管理] 底下的 [公開 API]。 選取 [新增用戶端應用程式],並新增 Microsoft 企業版權杖存放區的用戶端識別碼。
ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b
步驟 4:將新的權杖客群新增至您的 API
更新您的 MCP 伺服器或 API,以允許新的識別碼 URI 做為權杖對象。 如果您的 MCP 伺服器或 API 驗證用戶端應用程式識別碼,請確定已將 Microsoft 企業版權杖存放區的用戶端識別碼 (ab3be6b7-f5df-413d-ac2d-abf1e3fd9c0b) 新增為允許的用戶端應用程式。
秘訣
如果您的 MCP 伺服器或 API 使用 代理流程 來存取另一個需要使用者授與同意的 Web API,請傳回 401 Unauthorized 錯誤,讓代理程式提示使用者登入以授與同意。