跳至主要內容

Google Workspace SSO/SCIM 電子郵件不匹配

Claude 使用電子郵件作為主要識別碼,以將 SSO 登入與已佈建的座位相匹配。在 Google Workspace 中,SCIM 自動佈建和 SAML SSO 可能會傳送不同的電子郵件值——尤其是當使用者擁有電子郵件別名時——導致不匹配,進而阻止存取。

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


症狀

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

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

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

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

  • Claude Code 驗證失敗——Claude Code CLI 在驗證流程中顯示電子郵件不匹配錯誤,導致使用者無法連線到您的組織。


發生原因

Google Workspace 帳戶有一個主要電子郵件,可能有多個別名。SCIM 佈建和 SAML SSO 在 Google 管理控制台中分別設定,可以從不同的位址欄位提取:

Google 屬性

典型值

常用於

primaryEmail

建議用於 SCIM 和 SAML

電子郵件別名

有時在 SCIM 中被誤對應

自訂結構描述欄位

每個組織定義的自訂屬性

進階屬性對應

組織單位電子郵件

OU 衍生的位址變體

在複雜的組織結構中很少見

最常見的不匹配:SCIM 設定為傳送別名位址,而 SAML 傳送主要電子郵件(或反之)。由於別名和主要電子郵件是不同的字串,Claude 無法匹配它們。Claude 需要完全相符的字串。

常見混淆:在 Google 管理中,SCIM 自動佈建設定和 SAML 屬性對應位於同一應用程式內的不同標籤上。管理員有時會更新其中一個而遺漏另一個。請驗證兩個位置。


診斷步驟

步驟 1——確認不匹配

  1. 檢查 SCIM 電子郵件:在 Google 管理控制台中,前往 應用程式 → 網路和行動應用程式 → [Claude 應用程式] → 自動佈建。檢查哪個屬性對應到傳送給 Claude 的電子郵件欄位。

  2. 檢查 SAML 電子郵件:在同一應用程式中,前往 SAML 屬性對應部分。找到對應到電子郵件的屬性並記下其來源。

  3. 檢查特定人員:在 目錄 → 使用者 → [使用者] 中,比較 主要電子郵件與任何列出的 別名電子郵件。

步驟 2——識別問題的範圍

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

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

步驟 3——檢查 SAML 設定中的名稱 ID

  1. 在應用程式設定中,前往 SAML → 服務提供者詳細資料。

  2. 確認名稱 ID 設定為 基本資訊 → 主要電子郵件。

  3. 如果名稱 ID 設定為自訂結構描述欄位或別名,它可能會傳送與 SCIM 不同的值。


解決方案

將兩個對應都對齊到 primaryEmail

Google Workspace 的 primaryEmail 是 SCIM 和 SAML 最可靠的來源。

  1. 更新 SCIM 佈建:在 應用程式 → 網路和行動應用程式 → [Claude 應用程式] → 自動佈建 → 屬性對應中,確保電子郵件屬性對應到 primaryEmail。

  2. 更新 SAML 名稱 ID:在 SAML → 服務提供者詳細資料中,將名稱 ID 設定為 基本資訊 → 主要電子郵件。

  3. 更新 SAML 屬性對應:在屬性對應步驟中,確保電子郵件屬性對應到基本資訊 → 主要電子郵件。

  4. 儲存所有變更。

觸發完整重新同步

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

  1. 在 Google 管理控制台中,前往應用程式的自動佈建設定。

  2. 暫時暫停佈建,然後重新啟用。這會觸發所有已指派人員的完整同步。

  3. 或者,從應用程式指派中移除並重新新增受影響的人員,以強制其個別記錄重新佈建。

  4. 監控佈建日誌中的錯誤,並確認電子郵件已更新以符合 SAML 格式,然後再要求使用者重試。


修復後清理

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

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

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

  • 座位可用性:如果幽靈帳戶佔用了所有合約座位,新登入將失敗並出現座位不足錯誤。取消佈建幽靈帳戶會釋放這些座位。

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

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


驗證

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

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

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

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


常見問題

問題

解決方案

SCIM 傳送別名,而 SAML 傳送主要電子郵件

始終為兩者使用 primaryEmail。

未檢查 SAML 設定中的名稱 ID

名稱 ID 欄位決定登入時傳送的電子郵件。這與屬性對應部分分開。檢查兩者。

某些人員的自訂結構描述欄位為空白

堅持使用標準 Google 屬性,例如 primaryEmail。

對應變更後重新佈建不會自動觸發

您可能需要手動暫停並重新啟用佈建以強制完整同步。

某人的主要電子郵件已變更,但舊電子郵件仍出現在 Claude 中

主要電子郵件變更後需要完整重新同步。

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

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


何時聯絡支援

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

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

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

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

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

是否回答了您的問題?