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 屬性 | 典型值 | 常用於 |
|
| 預設 SCIM userName 對應 |
|
| OIDC / SAML 電子郵件宣告 |
|
| Exchange / M365 主要地址 |
| 可能包含別名或次要地址 | 替代聯絡電子郵件 |
當 SCIM 從一個屬性提取電子郵件,而 SSO 從另一個屬性發送電子郵件時,就會發生不匹配。即使是細微的差異也會阻止存取 — Claude 需要完全相符的字串。
常見混淆:Entra 有兩個不同的管理區域。SCIM 佈建應用程式位於企業應用程式下(Microsoft 對整合應用程式的術語 — 與您的 Claude 方案無關)。SSO/OIDC 應用程式位於應用程式註冊下。IT 管理員經常導航到錯誤的位置。
診斷步驟
步驟 1 — 確認不匹配
檢查 SCIM 電子郵件:在 Entra 管理中心 → 企業應用程式 → [Claude SCIM 應用程式] → 佈建 → 佈建日誌中,找到最近佈建的人員並檢查修改的屬性。對應到 emails[type eq 「work」].value 的值是 SCIM 發送給 Claude 的內容。
檢查 SSO 電子郵件:在企業應用程式 → [Claude 應用程式] → 單一登入 → 屬性和宣告中,找到電子郵件宣告。對於 OIDC 應用程式,檢查應用程式註冊 → [Claude 應用程式] → 權杖設定。
如果兩個來源屬性指向不同的欄位,您已確認不匹配。
步驟 2 — 識別範圍
如果大多數或所有已佈建的人員共享相同的格式不匹配,這是系統性屬性對應問題。修正方案在 SCIM 屬性對應設定中。
如果只有一或兩個人受影響,請直接在 Entra 中檢查他們的使用者設定檔。
步驟 3 — 檢查 OIDC 權杖宣告(僅限 OIDC 應用程式)
在 Entra 管理中心,前往應用程式註冊(不是企業應用程式)。
找到 Claude OIDC 應用程式並按一下「權杖設定。」
檢查電子郵件選用宣告。
與您的 SCIM 屬性對應交叉參考,以確認它們是否相符。
解決方案
修正 SCIM 屬性對應
導航至SCIM 佈建應用程式 — 不是 SSO/OIDC 應用程式:
前往Entra 管理中心 → 企業應用程式。
搜尋 Claude SCIM 應用程式。尋找具有佈建部分的應用程式。
按一下佈建 → 編輯佈建 → 屬性對應。
找到 SCIM 屬性為 emails[type eq 「work」].value 的列。按一下以編輯。
將來源屬性變更為 SSO 發送的內容 — 通常是 mail。
同時檢查 userName 對應,如需要則更新。
按一下「儲存。」
觸發完整佈建同步
需要完整同步 — 增量同步無法運作。您必須觸發佈建週期的完整重新啟動。
前往佈建概觀頁面。
按一下重新啟動佈建。
等待同步完成。
在佈建日誌中驗證電子郵件已更新為正確的格式。
修正後清理
修正屬性對應並完成完整同步後:
流氓免費帳戶:如果修正前組織建立未受限制,某些人員可能已建立免費個人 Claude 帳戶。請聯絡我們的支援團隊以移除。
幽靈帳戶(錯誤電子郵件座位):原始佈建的帳戶(使用不正確的電子郵件)可能仍存在於您的組織中,佔用永遠無法使用的座位。聯絡我們的支援團隊以取消佈建這些帳戶。
座位可用性:如果幽靈帳戶佔用所有合約座位,即使修正對應後,新登入也會因座位不足錯誤而失敗。
重新新增受影響的人員:移除幽靈帳戶後,具有更正電子郵件的人員可能需要重新邀請或重新佈建。
防止未來發生:在您組織的身分識別和存取設定中啟用「限制組織建立」。
驗證
檢查已佈建人員的樣本 — 確認佈建日誌中的電子郵件與 SSO 發送的電子郵件格式相符。
要求受影響的人員清除 claude.ai 的瀏覽器 Cookie,然後透過 SSO 登入。他們應該直接登入您組織的工作區。
確認人員未建立免費帳戶 — 在限制組織建立的情況下,被阻止的人員會看到清晰的錯誤,而不是登入個人帳戶。
如果 Claude Code 受影響,讓該人員重新執行
claude auth login --enterprise並確認電子郵件與其佈建座位相符。
常見問題
問題 | 解決方案 |
SCIM 對應已更新但 SSO 宣告未檢查(或反之) | 兩者都必須更新。SCIM 在企業應用程式 → 佈建下;SSO 宣告在單一登入 → 屬性和宣告或應用程式註冊 → 權杖設定下。 |
userPrincipalName 採用員工 ID 格式,不是真實電子郵件 | 將 SCIM 改為使用 mail 屬性。 |
增量同步執行但電子郵件未更新 | 屬性對應變更後需要重新啟動佈建。 |
OIDC 應用程式電子郵件宣告未設定為選用宣告 | 在應用程式註冊 → 權杖設定下新增電子郵件。 |
電子郵件已更新但人員仍無法登入 | 尋找流氓免費組織或幽靈帳戶。清除瀏覽器 Cookie 並重試。 |
何時聯絡支援
當以下情況發生時,請聯絡我們的支援團隊,並提供您組織的網域、受影響人員的電子郵件和屬性對應螢幕截圖:
SCIM 和 SSO 屬性看起來相同,但人員仍無法存取其座位。
您需要確認 Claude 在 SCIM 佈建期間為特定人員記錄的電子郵件。
您需要幫助清理幽靈帳戶或流氓免費組織。
人員遇到座位不足錯誤,儘管有可用的合約座位。
