К основному содержимому

Несоответствие электронной почты Google Workspace SSO/SCIM

Claude использует электронную почту в качестве основного идентификатора для сопоставления входов SSO с подготовленными местами. В Google Workspace SCIM автоматическая подготовка и SAML SSO могут отправлять разные значения электронной почты — особенно когда у людей есть псевдонимы электронной почты — что вызывает несоответствие, блокирующее доступ.

Применяется к: Корпоративным планам и организациям Console, использующим подготовку SCIM. Командные планы не имеют подготовки 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 Admin параметры автоматической подготовки SCIM и сопоставление атрибутов SAML находятся на отдельных вкладках в одном приложении. Администраторы иногда обновляют одно и пропускают другое. Проверьте оба места.


Диагностические шаги

Шаг 1 — подтвердите несоответствие

  1. Проверьте электронную почту SCIM: в консоли администратора Google перейдите в Приложения → Веб-приложения и мобильные приложения → [Приложение Claude] → Автоматическая подготовка. Проверьте, какой атрибут сопоставлен с полем электронной почты, отправляемым в Claude.

  2. Проверьте электронную почту SAML: в том же приложении перейдите в раздел Сопоставление атрибутов SAML. Найдите атрибут, сопоставленный с электронной почтой, и запишите его источник.

  3. Проверьте конкретного пользователя: в Справочнике → Пользователи → [Пользователь] сравните Основной адрес электронной почты с любыми указанными Псевдонимами электронной почты.

Шаг 2 — определите масштаб проблемы

  • Если большинство или все подготовленные пользователи имеют одинаковое несоответствие формата электронной почты, это системная проблема сопоставления атрибутов. Решение находится в сопоставлении атрибутов SCIM вашего IdP.

  • Если затронуты только один или два пользователя, проблема, вероятно, специфична для этих учетных записей. Проверьте их профиль напрямую.

Шаг 3 — проверьте Name ID в конфигурации SAML

  1. В параметрах приложения перейдите в SAML → Детали поставщика услуг.

  2. Убедитесь, что Name ID установлен на Основная информация → Основной адрес электронной почты.

  3. Если Name ID установлен на поле пользовательской схемы или псевдоним, он может отправить другое значение, чем SCIM.


Решение

Выровняйте оба сопоставления по primaryEmail

primaryEmail Google Workspace — наиболее надежный источник для SCIM и SAML.

  1. Обновите подготовку SCIM: в Приложения → Веб-приложения и мобильные приложения → [Приложение Claude] → Автоматическая подготовка → Сопоставление атрибутов убедитесь, что атрибут электронной почты сопоставлен с primaryEmail.

  2. Обновите Name ID SAML: в SAML → Детали поставщика услуг установите Name ID на Основная информация → Основной адрес электронной почты.

  3. Обновите сопоставление атрибутов SAML: на этапе Сопоставление атрибутов убедитесь, что атрибут электронной почты сопоставлен с Основная информация → Основной адрес электронной почты.

  4. Сохраните все изменения.

Запустите полную повторную синхронизацию

Критично — требуется полная синхронизация: добавочная синхронизация не обновит существующие записи после изменения сопоставления атрибутов. Вы должны запустить полный перезапуск цикла подготовки.

  1. В консоли администратора Google перейдите в параметры Автоматическая подготовка приложения.

  2. Временно приостановите подготовку, а затем повторно включите ее. Это запускает полную синхронизацию всех назначенных пользователей.

  3. Кроме того, удалите и повторно добавьте затронутых пользователей из назначения приложения, чтобы принудительно переподготовить их отдельные записи.

  4. Отслеживайте журналы подготовки на предмет ошибок и подтвердите, что адреса электронной почты обновлены в соответствии с форматом SAML, прежде чем просить людей повторить попытку.


Очистка после исправления

После исправления сопоставления атрибутов и завершения полной синхронизации:

  • Бесхозные бесплатные учетные записи: если создание организации не было ограничено до исправления, некоторые люди могли случайно создать бесплатные личные учетные записи Claude. Свяжитесь с нашей командой поддержки, чтобы удалить их.

  • Фантомные учетные записи (места с неправильным адресом электронной почты): первоначально подготовленные учетные записи с неправильным адресом электронной почты могут по-прежнему существовать в вашей организации, занимая места. Свяжитесь с нашей командой поддержки, чтобы отменить подготовку этих учетных записей.

  • Доступность мест: если фантомные учетные записи занимают все контрактные места, новые входы будут неудачными с ошибкой нехватки мест. Отмена подготовки фантомных учетных записей освобождает эти места.

  • Повторное добавление затронутых пользователей: после удаления фантомных учетных записей люди с исправленным адресом электронной почты могут нуждаться в повторном приглашении или переподготовке.

  • Предотвращение будущих случаев: включите «Ограничить создание организации» в параметрах идентификации и доступа вашей организации. Это предотвращает случайное создание бесплатных личных учетных записей людьми, которые еще не подготовлены.


Проверка

  1. Проверьте образец подготовленных пользователей — подтвердите, что их адрес электронной почты в журнале подготовки соответствует формату адреса электронной почты, отправляемому SSO.

  2. Попросите затронутого пользователя очистить кэш браузера для claude.ai, а затем войти через SSO. Он должен перейти прямо в рабочее пространство вашей организации без каких-либо ошибок.

  3. Подтвердите, что люди не создают бесплатные учетные записи — при ограничении создания организации заблокированные пользователи видят четкую ошибку вместо перехода на личную учетную запись.

  4. Если Claude Code был затронут, попросите пользователя повторно запустить claude auth login --enterprise и подтвердить, что адрес электронной почты соответствует его подготовленному месту.


Распространенные проблемы

Проблема

Решение

SCIM отправляет псевдоним, а SAML отправляет основной адрес электронной почты

Всегда используйте primaryEmail для обоих.

Name ID в параметрах SAML не был проверен

Поле Name ID определяет адрес электронной почты, отправляемый при входе. Это отдельно от раздела сопоставления атрибутов. Проверьте оба.

Поле пользовательской схемы пусто для некоторых пользователей

Придерживайтесь стандартных атрибутов Google, таких как primaryEmail.

Переподготовка не запускается автоматически после изменения сопоставления

Вам может потребоваться вручную приостановить и повторно включить подготовку, чтобы принудительно выполнить полную синхронизацию.

Основной адрес электронной почты пользователя изменился, но старый адрес все еще отображается в Claude

После изменения основного адреса электронной почты требуется полная повторная синхронизация.

Адреса электронной почты обновлены в SCIM, но пользователь по-прежнему не может войти

Проверьте наличие бесхозных бесплатных организаций или фантомных учетных записей. Очистите кэш браузера и повторите попытку.


Когда обращаться в поддержку

Свяжитесь с нашей командой поддержки с доменом вашей организации, адресом электронной почты затронутого пользователя и снимками экрана ваших сопоставлений атрибутов, когда:

  • Атрибуты SCIM и SSO выглядят идентичными, но люди по-прежнему не могут получить доступ к своим местам.

  • Вам нужно подтверждение адреса электронной почты, записанного Claude во время подготовки SCIM для конкретных пользователей.

  • Вам нужна помощь в очистке фантомных учетных записей или бесхозных бесплатных организаций.

  • Люди получают ошибку нехватки мест, несмотря на доступные контрактные места.

Нашли ответ на свой вопрос?