Claude 使用電子郵件作為主要識別碼,以將 SSO 登入與已佈建的座位相匹配。Ping Identity 產品(PingOne 和 PingFederate)具有靈活的分層屬性配置。當 SCIM 佈建和 SAML/OIDC SSO 從不同的使用者屬性提取時,不匹配會阻止存取。
適用於:使用 SCIM 佈建的企業方案和 Console 組織。Team 方案沒有 SCIM 佈建,因此此不匹配情況不適用—請參閱設定 JIT 或 SCIM 佈建以了解每個方案上可用的功能。
症狀
嘗試透過 SSO 存取您的組織時,人員可能會遇到以下一項或多項情況:
「帳戶建立被阻止」—該人員透過 SSO 進行驗證,但 Claude 找不到相符的已佈建帳戶。
登入免費個人帳戶—如果未限制組織建立,該人員會完全略過您的組織。
「檢查您登入的帳戶」不匹配—SSO 回呼顯示的電子郵件與該人員在登入時輸入的電子郵件不同。
Claude Code 驗證失敗—Claude Code CLI 在驗證流程中顯示電子郵件不匹配錯誤。
發生原因
Ping Identity 產品允許在多個層級(目錄、IdP 配接器、SP 連接器、應用程式)進行細粒度屬性對應。SCIM 和 SSO 可以各自透過這些層級的不同路徑,導致到達 Claude 的電子郵件值不同:
Ping 屬性 | 典型值 | 常用於 |
| 建議用於 SCIM 和 SAML/OIDC | |
|
| 預設登入識別碼;可能與電子郵件不同 |
IdP 配接器屬性 (PingFederate) | 因配接器類型而異(LDAP、HTML 表單等) | PingFederate 身分來源 |
LDAP | PingFederate 中的目錄來源電子郵件 | |
LDAP | 可能是員工 ID 或簡短使用者名稱 | 有時被誤對應為電子郵件 |
自訂母體屬性 | 每個環境定義的自訂欄位 | 進階 PingOne 配置 |
Claude 要求 SCIM 佈建的電子郵件與 SSO 聲稱的電子郵件完全相符。
PingFederate 注意:PingFederate 的屬性合約系統特別複雜—電子郵件可以通過多個層級(LDAP → IdP 配接器 → 配接器合約 → SP 連接器 → 聲稱)。任何層級的不匹配都會導致錯誤的值到達 Claude。端對端追蹤該值。
診斷步驟
步驟 1—確認不匹配 (PingOne)
檢查 SCIM 屬性對應:在 PingOne Admin 中,前往連接 → 應用程式 → [Claude 應用程式] → 屬性對應。找到對應至 emails[primary].value 或 email 的屬性。記下用作來源的 PingOne 使用者屬性。
檢查 SSO 屬性對應:在同一應用程式中,前往SAML 或 OIDC 標籤,並找到對應至電子郵件的屬性或聲稱。記下其來源屬性。
如果 SCIM 和 SSO 參考不同的 PingOne 屬性,您已確認不匹配。
步驟 1(替代)—確認不匹配 (PingFederate)
在 PingFederate Admin 主控台中,找到 Claude 的 SP 連接。
在屬性合約履行中,找到電子郵件屬性並將其來源追蹤回 IdP 配接器或 LDAP 資料存放區。
另外,檢查 Claude 的 SCIM 佈建連接器或出站佈建通道,並追蹤正在傳送的電子郵件屬性的來源。
如果兩個追蹤導向不同的目錄屬性,您已確認不匹配。
步驟 2—識別問題的範圍
如果大多數或所有已佈建的人員共享相同的電子郵件格式不匹配,這是系統性屬性對應問題。修復方案在您的 IdP 的 SCIM 屬性對應中。
如果只有一或兩個人受到影響,問題可能特定於這些帳戶。直接檢查他們的設定檔。
步驟 3—檢查特定人員的屬性值
PingOne:前往身分 → 使用者 → [使用者]並比較使用者名稱和電子郵件欄位值。
PingFederate 搭配 LDAP:檢查該人員的 LDAP 記錄,並比較 mail、userPrincipalName、sAMAccountName 和您的配接器對應中使用的任何其他屬性。
解決方案
PingOne—將兩個對應對齊至電子郵件屬性
在連接 → 應用程式 → [Claude 應用程式]中,開啟屬性對應。
針對 SCIM:確保 emails[primary].value 對應至 PingOne 的電子郵件地址屬性。
針對 SAML/OIDC:確保電子郵件屬性或聲稱也對應至 PingOne 的電子郵件地址屬性。
儲存變更。
PingFederate—在所有層級對齊屬性合約
在 Claude 的 SP 連接中,前往屬性合約履行。
找到電子郵件屬性。確保其來源是您的 SCIM 出站佈建通道中使用的相同 LDAP 或資料存放區屬性。
如果使用自訂 IdP 配接器,確保配接器的合約包含規範電子郵件屬性,並且它正確對應至 SP 連接。
更新 SCIM 佈建以使用相同的來源屬性。
觸發完整重新同步
重要—需要完整同步:變更屬性對應後,增量同步不會更新現有記錄。您必須觸發佈建週期的完整重新啟動。
PingOne:在應用程式的佈建設定中,觸發完整佈建週期。您可能需要停用並重新啟用佈建以強制完整重新推送。
PingFederate:在您的出站佈建通道中觸發完整同步。檢查您的佈建日誌以確認正在傳送更新的電子郵件值。
在要求人員重試登入之前,驗證更新的電子郵件值出現在佈建日誌中。
修復後清理
更正屬性對應並完成完整同步後:
流氓免費帳戶:如果在修復前未限制組織建立,某些人員可能無意中建立了免費個人 Claude 帳戶。聯絡我們的支援團隊以移除這些帳戶。
虛擬帳戶(錯誤電子郵件座位):聯絡我們的支援團隊以取消佈建這些帳戶。
座位可用性:如果虛擬帳戶佔用所有合約座位,新登入將失敗。聯絡我們的支援團隊。
重新新增受影響的人員:移除虛擬帳戶後,人員可能需要被重新邀請或重新佈建。
防止未來發生:在您的組織的身分和存取設定中啟用「限制組織建立」。
驗證
檢查已佈建人員的樣本—確認他們在佈建日誌中的電子郵件與 SSO 傳送的電子郵件格式相符。
要求受影響的人員清除 claude.ai 的瀏覽器 Cookie,然後透過 SSO 登入。
確認人員未建立免費帳戶。
如果 Claude Code 受到影響,讓該人員重新執行
claude auth login --enterprise並確認電子郵件與其已佈建的座位相符。
常見問題
問題 | 解決方案 |
使用 PingOne | 將 SCIM 對應切換至 PingOne 的電子郵件地址屬性。 |
PingFederate 屬性在合約層級間不匹配 | 端對端追蹤電子郵件屬性:LDAP 來源 → IdP 配接器 → 配接器合約 → SP 連接器 → 聲稱。 |
LDAP | 改用 LDAP |
增量佈建同步不更新現有記錄 | 變更屬性對應後需要完整重新同步。 |
PingFederate 中的屬性合約已更新但 SCIM 連接器未更新 | SP 連接和出站 SCIM 佈建通道必須獨立更新。 |
SCIM 中的電子郵件已更新但人員仍無法登入 | 檢查流氓免費組織或虛擬帳戶。清除瀏覽器 Cookie 並重試。 |
何時聯絡支援
當以下情況發生時,請聯絡我們的支援團隊,並提供您的組織網域、受影響人員的電子郵件和您的屬性對應螢幕截圖:
SCIM 和 SSO 屬性看起來相同,但人員仍無法存取其座位。
您需要確認 Claude 在 SCIM 佈建期間為特定人員記錄的電子郵件。
您需要幫助清理虛擬帳戶或流氓免費組織。
人員遇到座位不足錯誤,儘管有可用的合約座位。
