跳至主要內容

Ping Identity SSO/SCIM 電子郵件不匹配

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 屬性

典型值

常用於

email (PingOne)

建議用於 SCIM 和 SAML/OIDC

username (PingOne)

testuser1 或 [email protected]

預設登入識別碼;可能與電子郵件不同

IdP 配接器屬性 (PingFederate)

因配接器類型而異(LDAP、HTML 表單等)

PingFederate 身分來源

LDAP mail 屬性

PingFederate 中的目錄來源電子郵件

LDAP sAMAccountName 或 uid

可能是員工 ID 或簡短使用者名稱

有時被誤對應為電子郵件

自訂母體屬性

每個環境定義的自訂欄位

進階 PingOne 配置

Claude 要求 SCIM 佈建的電子郵件與 SSO 聲稱的電子郵件完全相符。

PingFederate 注意:PingFederate 的屬性合約系統特別複雜—電子郵件可以通過多個層級(LDAP → IdP 配接器 → 配接器合約 → SP 連接器 → 聲稱)。任何層級的不匹配都會導致錯誤的值到達 Claude。端對端追蹤該值。


診斷步驟

步驟 1—確認不匹配 (PingOne)

  1. 檢查 SCIM 屬性對應:在 PingOne Admin 中,前往連接 → 應用程式 → [Claude 應用程式] → 屬性對應。找到對應至 emails[primary].value 或 email 的屬性。記下用作來源的 PingOne 使用者屬性。

  2. 檢查 SSO 屬性對應:在同一應用程式中,前往SAML 或 OIDC 標籤,並找到對應至電子郵件的屬性或聲稱。記下其來源屬性。

  3. 如果 SCIM 和 SSO 參考不同的 PingOne 屬性,您已確認不匹配。

步驟 1(替代)—確認不匹配 (PingFederate)

  1. 在 PingFederate Admin 主控台中,找到 Claude 的 SP 連接。

  2. 在屬性合約履行中,找到電子郵件屬性並將其來源追蹤回 IdP 配接器或 LDAP 資料存放區。

  3. 另外,檢查 Claude 的 SCIM 佈建連接器或出站佈建通道,並追蹤正在傳送的電子郵件屬性的來源。

  4. 如果兩個追蹤導向不同的目錄屬性,您已確認不匹配。

步驟 2—識別問題的範圍

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

  • 如果只有一或兩個人受到影響,問題可能特定於這些帳戶。直接檢查他們的設定檔。

步驟 3—檢查特定人員的屬性值

  1. PingOne:前往身分 → 使用者 → [使用者]並比較使用者名稱和電子郵件欄位值。

  2. PingFederate 搭配 LDAP:檢查該人員的 LDAP 記錄,並比較 mail、userPrincipalName、sAMAccountName 和您的配接器對應中使用的任何其他屬性。


解決方案

PingOne—將兩個對應對齊至電子郵件屬性

  1. 在連接 → 應用程式 → [Claude 應用程式]中,開啟屬性對應。

  2. 針對 SCIM:確保 emails[primary].value 對應至 PingOne 的電子郵件地址屬性。

  3. 針對 SAML/OIDC:確保電子郵件屬性或聲稱也對應至 PingOne 的電子郵件地址屬性。

  4. 儲存變更。

PingFederate—在所有層級對齊屬性合約

  1. 在 Claude 的 SP 連接中,前往屬性合約履行。

  2. 找到電子郵件屬性。確保其來源是您的 SCIM 出站佈建通道中使用的相同 LDAP 或資料存放區屬性。

  3. 如果使用自訂 IdP 配接器,確保配接器的合約包含規範電子郵件屬性,並且它正確對應至 SP 連接。

  4. 更新 SCIM 佈建以使用相同的來源屬性。

觸發完整重新同步

重要—需要完整同步:變更屬性對應後,增量同步不會更新現有記錄。您必須觸發佈建週期的完整重新啟動。

  1. PingOne:在應用程式的佈建設定中,觸發完整佈建週期。您可能需要停用並重新啟用佈建以強制完整重新推送。

  2. PingFederate:在您的出站佈建通道中觸發完整同步。檢查您的佈建日誌以確認正在傳送更新的電子郵件值。

  3. 在要求人員重試登入之前,驗證更新的電子郵件值出現在佈建日誌中。


修復後清理

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

  • 流氓免費帳戶:如果在修復前未限制組織建立,某些人員可能無意中建立了免費個人 Claude 帳戶。聯絡我們的支援團隊以移除這些帳戶。

  • 虛擬帳戶(錯誤電子郵件座位):聯絡我們的支援團隊以取消佈建這些帳戶。

  • 座位可用性:如果虛擬帳戶佔用所有合約座位,新登入將失敗。聯絡我們的支援團隊。

  • 重新新增受影響的人員:移除虛擬帳戶後,人員可能需要被重新邀請或重新佈建。

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


驗證

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

  2. 要求受影響的人員清除 claude.ai 的瀏覽器 Cookie,然後透過 SSO 登入。

  3. 確認人員未建立免費帳戶。

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


常見問題

問題

解決方案

使用 PingOne username 欄位而非 email

將 SCIM 對應切換至 PingOne 的電子郵件地址屬性。

PingFederate 屬性在合約層級間不匹配

端對端追蹤電子郵件屬性:LDAP 來源 → IdP 配接器 → 配接器合約 → SP 連接器 → 聲稱。

LDAP sAMAccountName 或 uid 對應為電子郵件來源

改用 LDAP mail 屬性。

增量佈建同步不更新現有記錄

變更屬性對應後需要完整重新同步。

PingFederate 中的屬性合約已更新但 SCIM 連接器未更新

SP 連接和出站 SCIM 佈建通道必須獨立更新。

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

檢查流氓免費組織或虛擬帳戶。清除瀏覽器 Cookie 並重試。


何時聯絡支援

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

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

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

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

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

是否回答了您的問題?