Microsoft Entra ID 中的用戶端 ID 元資料文件(預覽版)

用戶端 ID 元資料文件(CIMD)是一種以 Entra ID 註冊 OAuth 用戶端的新方式。 CIMD 主要用於需要連接遠端 MCP 伺服器的 AI 代理程式。

Important

Microsoft Entra ID 中的用戶端 ID 元資料文件支援目前處於公開預覽階段。 此預覽版在沒有服務等級協議的情況下提供,不建議用於生產工作負載。 部分功能可能未被支援或功能受限。 欲了解更多資訊,請參閱 線上服務通用授權條款。

為什麼選擇CIMD

AI 代理可能會使用多種不同的 MCP 伺服器來執行工作。 部分 MCP 伺服器可能由 Entra 的 OAuth 伺服器保護——例如 WorkIQ、Azure 儲存體 MCP,或企業級自建的 MCP 伺服器。 其他則可能由其他 OAuth 伺服器保護——例如 GitHub、Workday、Slack。 對於一般用途的 AI 代理來說,要知道它會使用的所有 MCP 伺服器並不實際,因此也不可能知道 AI 代理會遇到的所有 OAuth 伺服器。 AI 代理需要一種能動態向 OAuth 伺服器註冊並取得用戶端 ID 的方法。

用戶端 ID 元資料文件(CIMD)允許 OAuth 用戶端以 HTTPS URL 作為 OAuth client_id 值來識別自身,而非預先註冊的用戶端 ID。 該公開 URL 的 JSON 文件包含用戶端的 OAuth 元資料,例如其重新導向 URI 與用戶端憑證。 這讓 OAuth 伺服器(例如 Entra ID)能夠擷取 JSON 文件,並用它安全地向用戶端發放存取權杖。

當用戶端必須連接多個與其先前並無關聯的授權伺服器時,CIMD 非常有用。 例如,AI 代理可以在執行時發現遠端的模型情境協定(MCP)伺服器,而每台伺服器可能使用不同的授權伺服器。 要求每個客戶端都註冊到每個授權伺服器,這樣擴展性就不行。

CIMD 是由 OAuth 用戶端 ID 元資料文件規範所定義。

CIMD 的運作方式

典型的 CIMD 授權流程包含以下步驟:

Swimlane 圖示顯示使用者將 MCP 用戶端連接到 MCP 伺服器。用戶端會發現 Microsoft Entra ID,並以 CIMD URL 作為用戶端 ID 發送授權請求,Entra 則擷取並驗證該元資料文件。Entra 會在需要時取得同意,必要時建立代理程式身份,並發出存取權杖,供用戶端用來呼叫 MCP 伺服器。

  1. MCP 用戶端發現 MCP 伺服器使用 Microsoft Entra ID 作為其授權伺服器。
  2. 用戶端讀取授權伺服器的元資料,並判斷支援 CIMD。
  3. 用戶端會發送授權請求。 它的 client_id 是其中繼資料文件的 HTTPS URL。
  4. Microsoft Entra ID 會擷取文件並驗證其內容,包括所請求client_id文件與文件client_id的完全匹配。
  5. Microsoft Entra ID 會從標準文件 URL 推導出穩定的應用程式 ID,並在租戶中尋找相符的代理程式身份。
  6. 如果身份不存在,租戶政策會決定是否能透過同意建立該身份。 管理員可以事先新增 CIMD 用戶端。
  7. Microsoft Entra ID 會驗證所要求的重新導向 URI 與權限,取得所需的同意,並發放受限受眾的存取權杖。
  8. 用戶端將令牌呈現給 MCP 伺服器。

CIMD URL 是用戶端的持久身份。 將文件移至另一個 URL 會建立不同的身份,且不會保留先前授予該身份的權限。

Microsoft Entra 如何代表 CIMD 用戶端

Microsoft Entra ID 在每個已核准用戶端的租戶中,以代理身分代表 CIMD 用戶端。

CIMD 支援的代理身分:

  • 其應用程式 ID 源自正規的 CIMD URL。
  • 將 CIMD URL 儲存為不可變的識別碼。
  • 每個租戶都有唯讀代理程式身份藍圖,且沒有藍圖服務主體。
  • 使用外部元資料文件作為其 OAuth 配置的真實來源。
  • 會出現在代理程式身份清單、稽核日誌及登入日誌中。

由於元資料仍保留在外部文件中,檢查存放在 Entra 應用程式物件上的 OAuth 設定的功能可能無法評估 CIMD 用戶端。 在採用 CIMD 之前,請檢視治理相關考量。

何時使用 CIMD

實施者應盡可能優先為用戶端向 Entra 預先註冊。 對於高流量或策略性整合,傳統註冊客戶端 ID 提供最穩定的身分與最廣泛的 Entra 功能。 僅在符合以下所有條件時才應使用 CIMD:

  • 用戶端必須連接多個獨立運作的授權伺服器。
  • 授權伺服器無法合理地預先註冊客戶端。
  • 用戶端使用使用者在場、委派的 OAuth 流程。
  • 用戶端可以在公開的 HTTPS URL 上發佈穩定的元資料。
  • 用戶端接受本文所述的限制。

主要情境是執行時發現多個遠端伺服器的 MCP 用戶端。

啟用 CIMD 的用戶端

下表列出已在 Entra CIMD 支援下進行測試並驗證的用戶端。

Client 用戶端 ID 元資料文件 預覽相容性
克勞德密碼 https://claude.ai/oauth/claude-code-client-metadata 有支援。
Claude https://claude.ai/oauth/mcp-oauth-client-metadata 有支援。
Codex https://chatgpt.com/oauth/codex/client.json 有支援。
ChatGPT https://chatgpt.com/oauth/client.json 不支援。 其機密用戶端驗證流程不被 Microsoft Entra 預覽版支援。
Visual Studio Code https://vscode.dev/oauth/client-metadata.json 不支援。 Microsoft 第一方用戶端不使用 CIMD。
GitHub Copilot https://github.com/copilot/desktop/client-metadata.json 不支援。 Microsoft 第一方用戶端不使用 CIMD。
使用官方 MCP SDK 打造的客製化客戶端 在您控制的網域上,以穩定的 HTTPS URL 托管一個元資料文件。 有支援。
客製化客戶端實作 在您控制的網域上,以穩定的 HTTPS URL 托管一個元資料文件。 有支援。

支援 CIMD 的 MCP 伺服器

下表為已確認支援 CIMD 的 Microsoft MCP 伺服器的非完整清單。

MCP 伺服器 遠端 MCP 伺服器 URL CIMD 測試狀態
客製化企業自行建置的 MCP 伺服器 -- 有支援,請參考 這裡的指南。
Microsoft IT 管理員專用 MCP https://mcp.svc.cloud.microsoft/admin 尚不支援。
Azure Management MCP (ARM) https://mcp.management.azure.com 尚不支援。
Azure DevOps MCP https://mcp.dev.azure.com/{organization} 尚不支援。
Work IQ MCP https://workiq.svc.cloud.microsoft/mcp 尚不支援。
Fabric IQ MCP https://fabriciq.svc.cloud.microsoft/v1/mcp/fabriciq 尚不支援。
Foundry MCP https://mcp.ai.azure.com 尚不支援。
Microsoft Sentinel MCP https://sentinel.microsoft.com/mcp/data-exploration 尚不支援。
Dataverse MCP https://{dataverseOrgName}.crm.dynamics.com/api/mcp 尚不支援。

支援的功能與限制

下表總結了由 CIMD 支援的代理身分識別的功能與限制。

Capability CIMD 支援
OAuth 授權碼流程,且使用者已登入 支援
重新整理權杖 支援
Code Exchange 證明金鑰(PKCE) 支援
用戶端認證流程 不支援
裝置代碼流程 支援
作為 OAuth 資源或權杖對象 不支援
供使用者登入的 ID 代幣或 SAML 代幣 不支援
共用用戶端密鑰 不支援
機密用戶端驗證,包括 private_key_jwt 預覽期間不支援;元資料文件中的金鑰不會被處理
使用 CIMD 的 Microsoft 第一方用戶端 不支援;使用現有的第一方登記流程
Publisher 驗證或 Microsoft 365 認證 不支援
多個代理身份共用同一份藍圖 不支援
代理使用者帳戶 不支援
Windows Web 帳戶管理員(WAM) 不支援
原地轉換為傳統用戶端 ID 或從傳統用戶端 ID 轉換 不支援

安全性模型

CIMD 證明客戶控制某個 URL。 它並不能證明客戶值得信任,或應該獲得組織資料的存取權。

Microsoft Entra ID 套用以下防護措施:

  • 僅限 HTTPS 識別碼: CIMD 用戶端 ID 必須是帶有路徑的 HTTPS URL。 URL 中不允許使用者資訊和片段。
  • 精確身分比對: 文件中的client_id必須與用作用戶端 ID 的 URL 完全相符。
  • 精確重定向匹配: 授權請求中的重新導向 URI 必須與文件中的 URI 完全匹配。
  • 同意政策的執行: 現有的租戶同意政策決定使用者是否可以新增用戶端,以及他們可以授予哪些委派權限。
  • 沒有僅限應用程式的權杖: CIMD 用戶端無法使用用戶端憑證授與。
  • 受眾限制:Microsoft Entra ID 不會發行以 CIMD 用戶端為受眾的令牌。

Entra 將使用 CIMD 的客戶視為未驗證,並尊重現有租戶同意政策。 這表示以下規則適用:

租戶設定 使用者可以同意的內容
預設同意政策 使用者可以登入 CIMD 用戶端。 這會在租戶中建立代理身份。 使用者只能將非常有限的一組 OAuth 範圍授予 CIMD 用戶端,例如 Microsoft Graph 中的 openid 和 User.Read。 基於風險的步驟提升 可防止使用者授予 CIMD 用戶端任何其他權限。
不允許使用者同意 在透過 Entra 管理中心中「 不允許使用者同意」 設定停用使用者同意的租戶中,使用者無法同意 CIMD 用戶端。 這表示他們無法將 CIMD 用戶端新增至租戶,也無法授予 CIMD 用戶端 OAuth 範圍。
其他同意政策 租戶可透過 同意政策允許使用者同意 CIMD 用戶端。 管理員可以細緻掌控允許使用者授與同意的條件。

CIMD 的管理控制

租戶可透過 同意政策阻止使用者新增 CIMD 用戶端或授予其新權限。 請採用以下任一方法:

  • 透過 Entra 管理中心的 「不允許使用者同意」 設定,封鎖所有使用者同意。
  • 僅允許使用者同意來自已驗證發行者的應用程式。

上述任一原則都會阻止非管理員使用者將 CIMD 用戶端新增至租戶。 請依照 「管理應用程式同意原則 」在您的租戶中設定同意原則。

若要使用 CIMD 啟用特定代理程式或用戶端,管理員可透過提供 CIMD URL,將代理程式識別個別新增至其租用戶。 這可以透過 Entra 管理中心或 Microsoft Graph API 來完成。 請參閱 管理 CIMD 用戶端。

治理考量

在使用 CIMD 之前,請考慮以下事項:

  • 客戶擁有者控制元資料文件,並可變更其內容。
  • 文件 URL 在 Microsoft Entra ID 中是不可更改的。 更改 URL 需要新的身份與新的同意授權。
  • 應用程式管理政策及其他用於檢查儲存在應用程式物件上的設定的控制項,並不涵蓋僅保留在 CIMD 文件中的中繼資料。
  • CIMD 用戶端不支援發佈者驗證或 Microsoft 365 認證。
  • Entra 不提供由租戶管理的 CIMD URL 的網域允許清單或封鎖清單。
  • 失去對文件 URL 或其網域的控制,可能會影響所有信任該用戶端身份的租戶。

務必使用最小權限委派權限,預先核准需要敏感存取的用戶端,監控其登入情況,並移除不再需要的身份。