跳至主要內容

SSO/SCIM 電子郵件不匹配 — OneLogin

摘要:Claude 使用電子郵件作為主要識別符,以將 SSO 登入與已配置的座位相匹配。在 OneLogin 中,SCIM 配置和 SAML SSO 在應用程式的不同標籤中配置,可能參考不同的使用者設定檔欄位,導致不匹配而阻止存取。

症狀

使用者在嘗試透過 SSO 存取 Claude for Enterprise 時,可能會遇到以下一個或多個情況:

  • 「帳戶建立已被阻止」— 使用者透過 SSO 進行身份驗證,但 Claude 找不到相符的已配置帳戶。如果您的組織已限制組織建立(建議),使用者將被完全阻止,無法繼續。

  • 登入免費個人帳戶— 如果未限制組織建立,使用者將繞過企業組織,改為建立或登入免費個人帳戶,而不是其企業座位。

  • 「請確認您的電子郵件」不匹配— SSO 回呼顯示的電子郵件與使用者在登入時輸入的電子郵件不同。

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

發生原因

OneLogin 使用者設定檔包含用於使用者名稱和電子郵件的不同欄位,可能包含不同的值。SCIM 配置參數和 SAML 屬性陳述式是獨立配置的,每個都可以從不同的欄位提取:

OneLogin 欄位

典型值

常見用途

Username

testuser1[email protected]

有時用於 SCIM userName 對應

Email

建議用於 SCIM 和 SAML

Login Name

如果 SSO 用於非電子郵件登入,可能與電子郵件不同

舊版或自訂配置

自訂使用者欄位

每個組織定義的自訂屬性

進階屬性對應

常見的不匹配:SCIM 參數標籤將電子郵件屬性對應到 Username(可能是員工 ID 或簡稱),而 SAML 屬性陳述式發送 Email 欄位。Claude 需要完全相符的字串

常見混淆:OneLogin 的 SCIM 參數和 SAML 屬性陳述式位於同一應用程式的不同標籤中 — SCIM 使用參數,SSO 使用SSO(或包含 SAML 特定欄位的參數)。兩者都必須檢查並對齊。

診斷步驟

步驟 1 — 確認不匹配

  1. 檢查 SCIM 電子郵件:在 OneLogin 管理入口網站中,前往應用程式 → [Claude 應用程式] → 參數。找到對應到 Claude 接收的電子郵件的欄位。注意 OneLogin 值欄 — 這顯示發送的是哪個使用者欄位。

  2. 檢查 SAML 電子郵件:在同一應用程式中,前往 SSO 標籤。按一下更多操作 → 編輯 SAML 回應或檢查 SAML 屬性陳述式部分。找到 email 屬性並注意其來源欄位。

  3. 檢查特定使用者:使用者 → [使用者]中,比較使用者的使用者名稱電子郵件欄位。如果它們不同,使用其中一個的任何對應都會導致不匹配。

步驟 2 — 確定問題的範圍

確定這是影響一個使用者還是系統性問題:

  • 如果大多數或所有已配置的使用者共享相同的電子郵件格式不匹配,這是系統性屬性對應問題,影響您的整個目錄。修復方案在您的 IdP 的 SCIM 屬性對應中。

  • 如果只有一個或兩個使用者受影響,而其他使用者正常工作,問題可能特定於這些使用者帳戶。直接檢查其使用者設定檔。

步驟 3 — 檢查使用者欄位值

  1. 前往使用者 → [受影響的使用者] → 使用者資訊

  2. 檢查使用者名稱電子郵件欄位。

  3. 如果使用者名稱的格式不符合有效的電子郵件,SCIM 可能發送無效或不相符的值。

解決方案

將兩個對應都對齊到電子郵件欄位

OneLogin 的 Email 欄位是 SCIM 和 SAML 最可靠的來源,因為它設計用來保存有效的電子郵件地址。

  1. 更新 SCIM 參數:應用程式 → [Claude 應用程式] → 參數中,找到 Claude 接收的電子郵件屬性的列。將變更為電子郵件(OneLogin 使用者電子郵件欄位)。

  2. 更新 SAML 屬性陳述式: SSO 標籤(或 SAML 屬性的參數)中,更新 email 屬性值以使用相同的電子郵件欄位。

  3. 按一下儲存

觸發完整重新同步

重要 — 需要完整同步:變更屬性對應後,增量同步不會更新現有使用者。您必須觸發配置週期的完整重新啟動

  1. 在應用程式的配置標籤中,尋找重新同步全部同步選項並執行它。

  2. 若要重新配置個別使用者:前往使用者 → [使用者] → 應用程式,找到 Claude 應用程式,並使用重新配置

  3. 檢查 OneLogin 配置活動日誌中的錯誤。

  4. 在要求使用者重試登入之前,驗證更新的電子郵件值是否出現在日誌中。

修復後清理

在更正屬性對應並完成完整同步後,根據您的情況,您可能需要進行額外的清理:

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

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

  • 座位可用性:如果幽靈帳戶佔用了所有合約座位,即使對應已修復,新登入也會因座位不足錯誤而失敗。如果您遇到此情況,請聯絡支援。

  • 重新新增受影響的使用者:移除幽靈帳戶後,具有更正電子郵件的使用者可能需要重新邀請或重新配置。

防止未來發生:在您的企業設定中啟用「限制組織建立」。

驗證

完成修復和任何清理後,驗證以下內容:

  1. 檢查已配置使用者的樣本 — 確認其在 IdP 配置日誌中的電子郵件與 SSO 發送的電子郵件格式相符。

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

  3. 確認使用者不會意外建立免費帳戶。

  4. 如果 Claude Code 受到影響,讓使用者重新執行 claude auth login --enterprise 並確認電子郵件與其企業座位相符。

常見陷阱

陷阱

解決方案

使用者名稱欄位包含簡稱或員工 ID,而不是電子郵件

將 SCIM 切換為使用電子郵件欄位。

SAML 屬性已更新,但 SCIM 參數未變更

參數標籤(用於 SCIM)和 SSO/SAML 屬性都必須獨立更新。

重新同步似乎未觸發

嘗試從應用程式中移除並重新指派個別受影響的使用者。

自訂使用者欄位已對應但某些使用者為空白

切換到標準電子郵件欄位。

SCIM 中的電子郵件已更新,但使用者仍無法登入

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

嘗試重新新增使用者時出現「邀請網域不允許」

您的組織網域可能未在 Claude 中驗證。聯絡 Anthropic 支援。

何時聯絡 Anthropic 支援

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

  • 您需要確認 Claude 在 SCIM 配置期間為特定使用者記錄的電子郵件。

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

  • 使用者遇到座位不足錯誤,儘管您的合約有可用座位。

聯絡[email protected],並提供您的組織網域、受影響使用者的電子郵件地址以及您的屬性對應的螢幕截圖。

是否回答了您的問題?