跳至主要內容

OneLogin SSO/SCIM 電子郵件不匹配

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

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


症狀

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

  • 「帳戶建立被阻止」—該人員透過 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 參數標籤將電子郵件屬性對應到使用者名稱(可能是員工 ID 或簡稱),而 SAML 屬性陳述式發送電子郵件欄位。Claude 需要完全相符的字串。

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


診斷步驟

步驟 1—確認不匹配

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

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

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

步驟 2—識別問題範圍

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

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

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

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

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

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


解決方案

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

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

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

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

  3. 按一下「儲存。」

觸發完整重新同步

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

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

  2. 若要重新佈建個別人員:前往使用者 → [使用者] → 應用程式,找到 Claude 應用程式,並使用重新佈建。

  3. 檢查 OneLogin 佈建活動日誌中的錯誤。

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


修復後清理

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

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

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

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

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

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


驗證

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

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

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

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


常見問題

問題

解決方案

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

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

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

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

重新同步似乎未觸發

嘗試從應用程式中移除並重新指派受影響的人員。

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

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

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

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

「邀請網域不允許」嘗試重新新增人員時

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


何時聯絡支援

在以下情況下,請聯絡我們的支援團隊,並提供您組織的網域、受影響人員的電子郵件和屬性對應的螢幕擷取畫面:

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

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

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

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

是否回答了您的問題?