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

Несоответствие email в Okta SSO/SCIM

Claude использует email в качестве основного идентификатора для сопоставления входов SSO с подготовленными местами. В Okta подготовка SCIM и SSO настраиваются отдельно и могут извлекать email из разных полей профиля пользователя. Это руководство объясняет, как выявить и устранить несоответствие.

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


Признаки проблемы

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

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

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

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

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


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

Профили пользователей Okta содержат несколько полей, представляющих идентичность. Подготовка SCIM (в разделе Provisioning → To App) и SSO SAML/OIDC (в разделе Sign On) настраиваются независимо.

Атрибут Okta

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

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

user.login

testuser1 или [email protected]

Сопоставление userName SCIM по умолчанию; иногда NameID

user.email

Утверждение email SAML/OIDC (рекомендуется)

appuser.email

Переопределение email на уровне приложения

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

Распространенное несоответствие: SCIM использует user.login, а SAML отправляет user.email. Claude требует точного совпадения строк.

Частая путаница: сопоставления атрибутов SCIM в Okta и утверждения атрибутов SAML находятся на двух разных вкладках — Provisioning → To App для SCIM и Sign On для SSO.


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

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

  1. Проверьте email SCIM: перейдите в Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Найдите строку email (или userName). Столбец Value показывает отправляемое выражение Okta.

  2. Проверьте email SSO (SAML): перейдите в Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Найдите атрибут email. Столбец Value указывает, какое поле Okta утверждается.

  3. Проверьте email SSO (OIDC): перейдите в Applications → [Claude App] → Sign On → OpenID Connect ID Token и просмотрите раздел Claims для email.

  4. Если значения SCIM и SSO ссылаются на разные поля Okta, несоответствие подтверждено.

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

  • Затронуты большинство или все подготовленные люди: это системная проблема сопоставления атрибутов. Исправление находится в сопоставлении атрибутов SCIM вашего IdP.

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

Шаг 3 — проверьте профили пользователей Okta напрямую

  1. Перейдите в Directory → People → [User] → Profile.

  2. Сравните значения полей Login и Email. Различия между этими полями приведут к несоответствиям сопоставления.


Решение

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

Самое безопасное исправление — использовать user.email для SCIM и SSO, так как это поле содержит канонический адрес email в Okta.

  1. Обновите сопоставление SCIM: в Provisioning → To App → Attribute Mappings измените источник email (или userName) на user.email.

  2. Обновите утверждение SSO (SAML): в Sign On → SAML Settings → Attribute Statements измените значение атрибута email на user.email.

  3. Обновите утверждение SSO (OIDC): в Sign On → OpenID Connect ID Token → Claims обновите утверждение email для сопоставления с user.email.

  4. Нажмите «Сохранить.»

Принудительно выполните полную повторную синхронизацию

Критично — требуется полная синхронизация: добавочная синхронизация не обновит существующие записи после изменения сопоставления атрибутов.

  1. В Provisioning → To App нажмите «Force Sync» для запуска полной переоценки всех назначенных пользователей.

  2. Или для конкретных людей: Provisioning → Push Users → выберите затронутых людей → Push Now.

  3. Проверьте системный журнал Okta (Reports → System Log) на предмет ошибок подготовки.

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


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

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

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

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

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

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

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


Проверка

После завершения исправления и любой очистки:

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

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

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

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


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

Проблема

Решение

Администратор обновляет утверждения SAML, но забывает сопоставления атрибутов SCIM (или наоборот)

Оба должны быть обновлены. Сопоставления SCIM в Provisioning → To App; утверждения SAML в Sign On → SAML Settings.

user.login содержит имя пользователя (не email) для некоторых людей

Переключитесь оба на user.email и убедитесь, что поля email заполнены для всех.

Добавочная синхронизация выполняется, но email не обновляются

Force Sync или Push Users требуется после изменения сопоставления атрибутов.

Атрибут профиля на уровне приложения (appuser.email) отличается от профиля пользователя (user.email)

Проверьте, переопределяют ли сопоставления атрибутов на уровне приложения значения профиля пользователя.

Email обновлены, но человек все еще не может войти

Ищите рогульские бесплатные организации или фантомные аккаунты. Очистите cookies браузера и повторите попытку. Обратитесь в поддержку, если проблема сохраняется.

Приложения OIDC и SAML — это отдельные приложения Okta для Claude

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


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

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

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

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

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

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

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