跳至主要內容

Microsoft Entra ID SSO/SCIM 電子郵件不匹配

Claude 使用電子郵件作為主要識別碼來匹配 SSO 登入與已佈建的座位。在 Microsoft Entra ID 中,SCIM 佈建和 SSO 驗證在不同的位置進行設定,可能從不同的使用者屬性提取電子郵件,導致不匹配而阻止存取。本指南將逐步說明如何識別問題、修正屬性對應,以及清理任何副作用。

適用於:使用 SCIM 佈建的企業方案和 Console 組織。Team 方案沒有 SCIM 佈建,因此不適用此不匹配情況 — 請參閱設定 JIT 或 SCIM 佈建以了解各方案的可用功能。


症狀

人員在嘗試透過 SSO 存取您的組織時,可能會遇到以下一個或多個情況:

  • 「帳戶建立被阻止」 — 該人員透過 SSO 驗證,但 Claude 找不到相符的已佈建帳戶。如果組織建立受限制(建議),該人員會被完全阻止。

  • 登入免費個人帳戶 — 如果組織建立不受限制,該人員會略過您的組織,建立或登入免費個人帳戶。

  • 「檢查您登入的帳戶」不匹配 — SSO 回呼顯示的電子郵件與該人員在登入時輸入的電子郵件不同。

  • Claude Code 驗證失敗 — Claude Code CLI 在驗證流程中顯示電子郵件不匹配錯誤。


這是如何發生的

Microsoft Entra ID 使用者帳戶有多個類似電子郵件的屬性,可以保存不同的值。SCIM 佈建和 SSO 驗證在不同的管理區域進行設定,每個都可以從不同的屬性提取:

Entra 屬性

典型值

常用於

userPrincipalName

[email protected](可能是員工 ID 格式)

預設 SCIM userName 對應

mail

[email protected](標準電子郵件)

OIDC / SAML 電子郵件宣告

proxyAddresses

Exchange / M365 主要地址

otherMails

可能包含別名或次要地址

替代聯絡電子郵件

當 SCIM 從一個屬性提取電子郵件,而 SSO 從另一個屬性發送電子郵件時,就會發生不匹配。即使是細微的差異也會阻止存取 — Claude 需要完全相符的字串。

常見混淆:Entra 有兩個不同的管理區域。SCIM 佈建應用程式位於企業應用程式下(Microsoft 對整合應用程式的術語 — 與您的 Claude 方案無關)。SSO/OIDC 應用程式位於應用程式註冊下。IT 管理員經常導航到錯誤的位置。


診斷步驟

步驟 1 — 確認不匹配

  1. 檢查 SCIM 電子郵件:在 Entra 管理中心 → 企業應用程式 → [Claude SCIM 應用程式] → 佈建 → 佈建日誌中,找到最近佈建的人員並檢查修改的屬性。對應到 emails[type eq 「work」].value 的值是 SCIM 發送給 Claude 的內容。

  2. 檢查 SSO 電子郵件:在企業應用程式 → [Claude 應用程式] → 單一登入 → 屬性和宣告中,找到電子郵件宣告。對於 OIDC 應用程式,檢查應用程式註冊 → [Claude 應用程式] → 權杖設定。

  3. 如果兩個來源屬性指向不同的欄位,您已確認不匹配。

步驟 2 — 識別範圍

  • 如果大多數或所有已佈建的人員共享相同的格式不匹配,這是系統性屬性對應問題。修正方案在 SCIM 屬性對應設定中。

  • 如果只有一或兩個人受影響,請直接在 Entra 中檢查他們的使用者設定檔。

步驟 3 — 檢查 OIDC 權杖宣告(僅限 OIDC 應用程式)

  1. 在 Entra 管理中心,前往應用程式註冊(不是企業應用程式)。

  2. 找到 Claude OIDC 應用程式並按一下「權杖設定。」

  3. 檢查電子郵件選用宣告。

  4. 與您的 SCIM 屬性對應交叉參考,以確認它們是否相符。


解決方案

修正 SCIM 屬性對應

導航至SCIM 佈建應用程式 — 不是 SSO/OIDC 應用程式:

  1. 前往Entra 管理中心 → 企業應用程式。

  2. 搜尋 Claude SCIM 應用程式。尋找具有佈建部分的應用程式。

  3. 按一下佈建 → 編輯佈建 → 屬性對應。

  4. 找到 SCIM 屬性為 emails[type eq 「work」].value 的列。按一下以編輯。

  5. 將來源屬性變更為 SSO 發送的內容 — 通常是 mail。

  6. 同時檢查 userName 對應,如需要則更新。

  7. 按一下「儲存。」

觸發完整佈建同步

需要完整同步 — 增量同步無法運作。您必須觸發佈建週期的完整重新啟動。

  1. 前往佈建概觀頁面。

  2. 按一下重新啟動佈建。

  3. 等待同步完成。

  4. 在佈建日誌中驗證電子郵件已更新為正確的格式。


修正後清理

修正屬性對應並完成完整同步後:

  • 流氓免費帳戶:如果修正前組織建立未受限制,某些人員可能已建立免費個人 Claude 帳戶。請聯絡我們的支援團隊以移除。

  • 幽靈帳戶(錯誤電子郵件座位):原始佈建的帳戶(使用不正確的電子郵件)可能仍存在於您的組織中,佔用永遠無法使用的座位。聯絡我們的支援團隊以取消佈建這些帳戶。

  • 座位可用性:如果幽靈帳戶佔用所有合約座位,即使修正對應後,新登入也會因座位不足錯誤而失敗。

  • 重新新增受影響的人員:移除幽靈帳戶後,具有更正電子郵件的人員可能需要重新邀請或重新佈建。

  • 防止未來發生:在您組織的身分識別和存取設定中啟用「限制組織建立」。


驗證

  1. 檢查已佈建人員的樣本 — 確認佈建日誌中的電子郵件與 SSO 發送的電子郵件格式相符。

  2. 要求受影響的人員清除 claude.ai 的瀏覽器 Cookie,然後透過 SSO 登入。他們應該直接登入您組織的工作區。

  3. 確認人員未建立免費帳戶 — 在限制組織建立的情況下,被阻止的人員會看到清晰的錯誤,而不是登入個人帳戶。

  4. 如果 Claude Code 受影響,讓該人員重新執行 claude auth login --enterprise 並確認電子郵件與其佈建座位相符。


常見問題

問題

解決方案

SCIM 對應已更新但 SSO 宣告未檢查(或反之)

兩者都必須更新。SCIM 在企業應用程式 → 佈建下;SSO 宣告在單一登入 → 屬性和宣告或應用程式註冊 → 權杖設定下。

userPrincipalName 採用員工 ID 格式,不是真實電子郵件

將 SCIM 改為使用 mail 屬性。

增量同步執行但電子郵件未更新

屬性對應變更後需要重新啟動佈建。

OIDC 應用程式電子郵件宣告未設定為選用宣告

在應用程式註冊 → 權杖設定下新增電子郵件。

電子郵件已更新但人員仍無法登入

尋找流氓免費組織或幽靈帳戶。清除瀏覽器 Cookie 並重試。


何時聯絡支援

當以下情況發生時,請聯絡我們的支援團隊,並提供您組織的網域、受影響人員的電子郵件和屬性對應螢幕截圖:

  • SCIM 和 SSO 屬性看起來相同,但人員仍無法存取其座位。

  • 您需要確認 Claude 在 SCIM 佈建期間為特定人員記錄的電子郵件。

  • 您需要幫助清理幽靈帳戶或流氓免費組織。

  • 人員遇到座位不足錯誤,儘管有可用的合約座位。

是否回答了您的問題?