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

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

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

Применяется к: Корпоративным планам и организациям Console, использующим подготовку SCIM. Командные планы не имеют подготовки SCIM, поэтому этот сценарий несоответствия не применяется — см. Настройка подготовки JIT или SCIM, чтобы узнать, что доступно для каждого плана.


Симптомы

При попытке доступа к вашей организации через SSO люди могут столкнуться с одним или несколькими из следующих:

  • «Создание учетной записи заблокировано» — пользователь проходит аутентификацию через SSO, но Claude не может найти соответствующую подготовленную учетную запись. Если в вашей организации ограничено создание организации (рекомендуется), пользователь полностью заблокирован.

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

  • «Проверьте, в какую учетную запись вы вошли» несоответствие — обратный вызов SSO показывает другой адрес электронной почты, чем тот, который пользователь ввел при входе.

  • Ошибка аутентификации Claude Code — Claude Code CLI показывает ошибку несоответствия электронной почты во время потока аутентификации.


Как это происходит

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

Поле OneLogin

Типичное значение

Обычно используется

Username

testuser1 или [email protected]

Иногда используется в сопоставлении userName SCIM

Email

Рекомендуется для SCIM и SAML

Login Name

Может отличаться от электронной почты, если SSO используется для входов без электронной почты

Устаревшие или пользовательские конфигурации

Пользовательские поля

Пользовательские атрибуты, определенные для каждой организации

Расширенные сопоставления атрибутов

Распространенное несоответствие: вкладка параметров SCIM сопоставляет атрибут электронной почты с Username (который может быть идентификатором сотрудника или коротким именем), а утверждение атрибута SAML отправляет поле Email. Claude требует точного совпадения строк.

Распространенная путаница: параметры SCIM и утверждения атрибутов SAML OneLogin находятся на разных вкладках одного приложения — Parameters для SCIM и SSO (или Parameters с полями, специфичными для SAML) для SSO. Оба должны быть проверены и согласованы.


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

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

  1. Проверьте электронную почту SCIM: в портале администратора OneLogin перейдите в Applications → [Claude app] → Parameters. Найдите поле, сопоставленное с электронной почтой, которую получает Claude. Обратите внимание на столбец OneLogin value — он показывает, какое поле пользователя отправляется.

  2. Проверьте электронную почту SAML: в том же приложении перейдите на вкладку SSO. Нажмите More Actions → Edit SAML Response или проверьте раздел SAML Attribute Statements. Найдите атрибут для электронной почты и обратите внимание на его исходное поле.

  3. Проверьте конкретного пользователя: в Users → [User] сравните поля Username и Email. Если они отличаются, любое сопоставление, использующее одно или другое, вызовет несоответствие.

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

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

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

Шаг 3 — проверьте значения полей пользователя

  1. Перейдите в Users → [Affected User] → User Info.

  2. Проверьте оба поля Username и Email.

  3. Если Username имеет формат, который не соответствует действительному адресу электронной почты, SCIM может отправлять недействительное или несоответствующее значение.


Решение

Согласуйте оба сопоставления с полем Email

Поле Email OneLogin является наиболее надежным источником для SCIM и SAML, так как оно предназначено для хранения действительного адреса электронной почты.

  1. Обновите параметр SCIM: в Applications → [Claude app] → Parameters найдите строку для атрибута электронной почты, который получает Claude. Измените Value на Email (поле OneLogin Email).

  2. Обновите утверждение атрибута SAML: на вкладке SSO (или Parameters для атрибутов SAML) обновите значение атрибута электронной почты, чтобы использовать то же поле Email.

  3. Нажмите «Save.»

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

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

  1. На вкладке Provisioning приложения найдите опцию Re-sync или Sync All и запустите ее.

  2. Для повторной подготовки отдельных людей: перейдите в Users → [User] → Applications, найдите приложение Claude и используйте Re-provision.

  3. Проверьте журнал активности подготовки OneLogin на предмет ошибок.

  4. Убедитесь, что обновленные значения электронной почты появляются в журнале, прежде чем просить людей повторить попытку входа.


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

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

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

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

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

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

  • Предотвращение будущих случаев: включите «Restrict organization creation» в параметрах Identity and access вашей организации.


Проверка

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

  2. Попросите затронутого человека очистить файлы cookie браузера для claude.ai, а затем войти через SSO.

  3. Убедитесь, что люди не создают бесплатные учетные записи.

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


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

Проблема

Решение

Поле Username содержит короткое имя или идентификатор сотрудника, а не электронную почту

Переключите SCIM на использование поля Email.

Атрибуты SAML обновлены, но параметры SCIM не были изменены

Вкладка Parameters (для SCIM) и атрибуты SSO/SAML должны быть обновлены независимо.

Повторная синхронизация, похоже, не запускается

Попробуйте удалить и переназначить затронутых людей из приложения.

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

Переключитесь на стандартное поле Email.

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

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

«Invite domain not allowed» при попытке повторного добавления людей

Домен вашей организации может быть не проверен в Claude. Свяжитесь с поддержкой.


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

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

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

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

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

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

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