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

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

Claude использует электронную почту в качестве основного идентификатора для сопоставления входов SSO с подготовленными местами. Продукты Ping Identity (PingOne и PingFederate) имеют гибкую многоуровневую конфигурацию атрибутов. Когда подготовка SCIM и SSO SAML/OIDC получают данные из разных атрибутов пользователя, несоответствие блокирует доступ.

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


Симптомы

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

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

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

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

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


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

Продукты Ping Identity позволяют детальное сопоставление атрибутов на нескольких уровнях (каталог, адаптер IdP, соединитель SP, приложение). SCIM и SSO могут проходить разные пути через эти уровни, в результате чего в Claude поступают разные значения электронной почты:

Атрибут Ping

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

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

email (PingOne)

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

username (PingOne)

testuser1 или [email protected]

Идентификатор входа по умолчанию; может отличаться от электронной почты

Атрибут адаптера IdP (PingFederate)

Варьируется в зависимости от типа адаптера (LDAP, HTML Form и т. д.)

Источники идентификации PingFederate

Атрибут LDAP mail

Электронная почта из каталога в PingFederate

LDAP sAMAccountName или uid

Может быть идентификатором сотрудника или коротким именем пользователя

Иногда ошибочно сопоставляется с электронной почтой

Пользовательские атрибуты совокупности

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

Расширенные конфигурации PingOne

Claude требует точного совпадения строк между электронной почтой, подготовленной SCIM, и электронной почтой, утвержденной SSO.

Примечание PingFederate: система контрактов атрибутов PingFederate особенно сложна — электронная почта может проходить через несколько уровней (LDAP → адаптер IdP → контракт адаптера → соединитель SP → утверждение). Несоответствие на любом уровне приведет к тому, что в Claude поступит неправильное значение. Отследите значение от начала до конца.


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

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

  1. Проверьте сопоставление атрибутов SCIM: в PingOne Admin перейдите в Connections → Applications → [Claude app] → Attribute Mappings. Найдите атрибут, сопоставленный с emails[primary].value или email. Запишите используемый атрибут пользователя PingOne.

  2. Проверьте сопоставление атрибутов SSO: в том же приложении перейдите на вкладку SAML или OIDC и найдите атрибут или утверждение, сопоставленное с электронной почтой. Запишите его исходный атрибут.

  3. Если SCIM и SSO ссылаются на разные атрибуты PingOne, вы подтвердили несоответствие.

Шаг 1 (альтернативный) — подтвердите несоответствие (PingFederate)

  1. В консоли администратора PingFederate найдите SP Connection для Claude.

  2. В Attribute Contract Fulfillment найдите атрибут электронной почты и отследите его источник обратно к адаптеру IdP или хранилищу данных LDAP.

  3. Отдельно проверьте соединитель подготовки SCIM или канал исходящей подготовки для Claude и отследите источник отправляемого атрибута электронной почты.

  4. Если две трассировки приводят к разным атрибутам каталога, вы подтвердили несоответствие.

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

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

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

Шаг 3 — проверьте значения атрибутов для конкретного человека

  1. PingOne: перейдите в Identities → Users → [User] и сравните значения полей Username и Email.

  2. PingFederate с LDAP: проверьте запись LDAP человека и сравните mail, userPrincipalName, sAMAccountName и любые другие атрибуты, используемые в сопоставлении адаптера.


Решение

PingOne — выровняйте оба сопоставления по атрибуту электронной почты

  1. В Connections → Applications → [Claude app] откройте Attribute Mappings.

  2. Для SCIM: убедитесь, что emails[primary].value сопоставлен с атрибутом Email Address PingOne.

  3. Для SAML/OIDC: убедитесь, что атрибут или утверждение электронной почты также сопоставлены с атрибутом Email Address PingOne.

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

PingFederate — выровняйте контракт атрибутов на всех уровнях

  1. В SP Connection для Claude перейдите в Attribute Contract Fulfillment.

  2. Найдите атрибут электронной почты. Убедитесь, что его источником является тот же атрибут LDAP или хранилища данных, используемый в канале исходящей подготовки SCIM.

  3. Если используется пользовательский адаптер IdP, убедитесь, что контракт адаптера включает канонический атрибут электронной почты и что он правильно сопоставлен с соединением SP.

  4. Обновите подготовку SCIM, чтобы использовать тот же исходный атрибут.

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

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

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

  2. PingFederate: запустите полную синхронизацию в канале исходящей подготовки. Проверьте журналы подготовки, чтобы подтвердить, что обновленные значения электронной почты отправляются.

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


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

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

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

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

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

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

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


Проверка

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

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

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

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


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

Проблема

Решение

Используется поле PingOne username вместо email

Переключите сопоставление SCIM на атрибут Email Address PingOne.

Несоответствие атрибутов PingFederate на уровнях контракта

Отследите атрибут электронной почты от начала до конца: источник LDAP → адаптер IdP → контракт адаптера → соединитель SP → утверждение.

LDAP sAMAccountName или uid сопоставлены как источник электронной почты

Используйте атрибут LDAP mail вместо этого.

Добавочная синхронизация подготовки не обновляет существующие записи

После изменения сопоставления атрибутов требуется полная повторная синхронизация.

Контракт атрибутов обновлен в PingFederate, но соединитель SCIM не обновлен

Соединение SP и канал исходящей подготовки SCIM должны быть обновлены независимо.

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

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


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

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

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

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

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

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

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