跳至主要內容

Okta SSO/SCIM 電子郵件不匹配

Claude 使用電子郵件作為主要識別符來將 SSO 登入與已佈建的座位進行配對。在 Okta 中,SCIM 佈建和 SSO 是分開配置的,可以從不同的使用者設定檔欄位提取電子郵件。本指南說明如何識別和解決不匹配問題。

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


症狀

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

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

  • 登入免費個人帳戶— 如果未限制組織建立,該人員會完全繞過您的組織,改為建立或登入免費個人帳戶,而不是其已佈建的座位。

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

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


發生原因

Okta 使用者設定檔包含多個代表身分的欄位。SCIM 佈建(在佈建 → 至應用程式下)和 SAML/OIDC SSO(在登入下)是獨立配置的。

Okta 屬性

典型值

常用於

user.login

testuser1 或 [email protected]

預設 SCIM userName 對應;有時為 NameID

user.email

SAML/OIDC 電子郵件宣告(建議)

appuser.email

應用程式層級的使用者電子郵件覆寫

自訂應用程式層級屬性對應

常見的不匹配:SCIM 使用 user.login,而 SAML 傳送 user.email。Claude 需要完全相符的字串。

常見混淆:Okta 的 SCIM 屬性對應和 SAML 屬性陳述位於兩個不同的標籤中—SCIM 的佈建 → 至應用程式,以及 SSO 的登入。


診斷步驟

步驟 1 — 確認不匹配

  1. 檢查 SCIM 電子郵件:導覽至應用程式 → [Claude 應用程式] → 佈建 → 至應用程式 → 屬性對應。找到 email(或 userName)列。值欄顯示正在傳送的 Okta 運算式。

  2. 檢查 SSO 電子郵件 (SAML):前往應用程式 → [Claude 應用程式] → 登入 → SAML 設定 → 編輯 → 屬性陳述。找到 email 屬性。值欄指示哪個 Okta 欄位被判斷。

  3. 檢查 SSO 電子郵件 (OIDC):前往應用程式 → [Claude 應用程式] → 登入 → OpenID Connect ID Token,並檢查宣告部分中的電子郵件。

  4. 如果 SCIM 和 SSO 值參考不同的 Okta 欄位,則不匹配已確認。

步驟 2 — 識別問題的範圍

  • 大多數或所有已佈建的人員受影響:這是系統性屬性對應問題。修復方案在您的 IdP 的 SCIM 屬性對應中。

  • 一或兩個人員受影響:問題特定於這些帳戶。直接檢查其使用者設定檔。

步驟 3 — 直接驗證 Okta 使用者設定檔

  1. 前往目錄 → 人員 → [使用者] → 設定檔。

  2. 比較登入和電子郵件欄位值。這些欄位之間的差異將產生對應不匹配。


解決方案

將兩個對應對齊到相同的 Okta 欄位

最安全的修復方案是對 SCIM 和 SSO 都使用 user.email,因為此欄位在 Okta 中包含規範電子郵件地址。

  1. 更新 SCIM 對應:在佈建 → 至應用程式 → 屬性對應中,將 email(或 userName)來源變更為 user.email。

  2. 更新 SSO 宣告 (SAML):在登入 → SAML 設定 → 屬性陳述中,將電子郵件屬性值變更為 user.email。

  3. 更新 SSO 宣告 (OIDC):在登入 → OpenID Connect ID Token → 宣告中,更新電子郵件宣告以對應至 user.email。

  4. 按一下「儲存。」

強制執行完整重新同步

重要 — 需要完整同步:在您變更屬性對應後,增量同步不會更新現有記錄。

  1. 在佈建 → 至應用程式中,按一下「強制同步」以觸發所有已指派人員的完整重新評估。

  2. 或者,針對特定人員:佈建 → 推送使用者 → 選取受影響的人員 → 立即推送。

  3. 檢查 Okta 系統日誌(報告 → 系統日誌)以查看佈建錯誤。

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


修復後清理

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

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

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

  • 座位可用性:如果虛擬帳戶佔用所有已簽約座位,即使在修復對應後,新登入也會因座位不足錯誤而失敗。

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

  • 防止未來發生:在您組織的身分和存取設定中啟用「限制組織建立」,以防止未佈建的人員建立免費帳戶。


驗證

完成修復和任何清理後:

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

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

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

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


常見問題

問題

解決方案

管理員更新 SAML 宣告但忘記 SCIM 屬性對應(或反之)

兩者都必須更新。SCIM 對應在佈建 → 至應用程式下;SAML 宣告在登入 → SAML 設定下。

user.login 對某些人員包含使用者名稱(不是電子郵件)

將兩者切換為 user.email,並驗證所有人員的電子郵件欄位已填入。

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

在屬性對應變更後,需要強制同步或推送使用者。

應用程式層級設定檔屬性 (appuser.email) 與使用者設定檔 (user.email) 不同

檢查應用程式層級屬性對應是否覆寫使用者設定檔值。

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

尋找流氓免費組織或虛擬帳戶。清除瀏覽器 Cookie 並重試。如果問題持續,請聯絡支援。

OIDC 和 SAML 應用程式是 Claude 的個別 Okta 應用程式

某些組織同時配置兩者。確保兩個應用程式中的屬性對齊。


何時聯絡支援

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

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

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

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

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

是否回答了您的問題?