Проверьте, по чему приложение узнаёт пользователя после callback. Для OpenID Connect устойчивой внешней идентичностью является не email, а пара issuer и subject. Спецификация описывает sub как уникальный и не переназначаемый идентификатор внутри issuer. Один sub от двух разных issuer — это не одна личность; один email тоже не доказывает, что аккаунты принадлежат одному человеку.

Разделите локального пользователя и внешние способы входа. В таблице users остаётся профиль продукта, а user_identities хранит provider, issuer, subject и user_id. Тогда к одному человеку можно привязать корпоративный SSO и другой подтверждённый способ входа, не создавая новый профиль при каждом callback.

Первый поиск идёт по составному внешнему ключу

user_identities(
  id, user_id, issuer, subject, created_at
)

UNIQUE (issuer, subject)

callback: validate token -> lookup(iss, sub) -> sign in

До lookup полностью проверяется ID Token: подпись, issuer, audience, срок действия, nonce и параметры потока. Не берите iss или sub из непроверенного тела токена. Нормализовать issuer «для удобства» тоже опасно: сравнивайте его с настроенным значением провайдера по правилам протокола.

Email предлагает кандидата, но не выполняет merge

СовпадениеБезопасное действиеЧего не делать
iss+sub найденВойти в связанный user_idСоздавать новый профиль
Новый iss+sub, email свободенСоздать профиль по политике регистрацииДоверять непроверенному email
Новый iss+sub, email уже естьПредложить защищённую привязкуАвтоматически склеивать аккаунты
Два профиля уже созданыЗапустить отдельный merge workflowПереписать user_id одной таблицы вручную

Даже claim email_verified не означает, что текущая SSO-сессия вправе захватить уже существующий локальный аккаунт. Администраторы домена, особенности провайдера и изменение владения адресом создают риски. Keycloak предупреждает, что автоматическая привязка существующей записи может быть опасной; Auth0 рекомендует аутентифицировать обе учётные записи перед linking.

Привязка подтверждает обе стороны

  • Пользователь повторно подтверждает текущий локальный аккаунт или активную сильную сессию.
  • SSO callback завершается в том же одноразовом linking flow, защищённом state и nonce.
  • Перед INSERT система снова проверяет, что (issuer, subject) ещё ни к кому не привязан.
  • Смена email не разрывает внешнюю identity и не создаёт новую.
  • В журнал попадают инициатор, обе identity, время и результат без токенов и секретов.

Если организация гарантирует уникальность сотрудников внутри одного tenant, это можно учесть в настройке конкретного IdP, но гарантия должна быть документирована и технически ограничена tenant/issuer. Глобальное правило «одинаковый email — тот же пользователь» переносит доверие одного провайдера на все остальные.

Merge данных выполняется как отдельная операция

Уже созданные дубли могут владеть заказами, ролями, командами, API-ключами и активными сессиями. Сначала выберите канонический user_id, затем для каждого типа данных определите правило: перенести, объединить, оставить раздельно или остановиться на конфликте. Роли не складывают автоматически — иначе менее привилегированный профиль может получить административный доступ.

Перенос делайте транзакционно с merge ID и отчётом по затронутым строкам. Отзовите старые сессии и recovery tokens, перевяжите внешние identities только после проверки конфликтов. Исходный профиль разумно пометить merged_into, а не удалять немедленно: это облегчает аудит и безопасный откат ошибочного слияния.

Регрессионный набор ловит повторное рождение дубля

  1. Войти дважды через один issuer и получить один user_id.
  2. Изменить email у провайдера при неизменном sub и остаться в том же профиле.
  3. Подать одинаковый email от другого issuer и потребовать подтверждённую привязку.
  4. Одновременно завершить два first-login callback и проверить UNIQUE (issuer, subject).
  5. Объединить два тестовых профиля с конфликтующими ролями и убедиться, что merge остановлен.

Для разбора нужны обезличенные iss, хеш или тестовый sub, tenant/connection, локальные user IDs и решения first-login flow. ID Token целиком, cookie и client secret передавать нельзя. По этой карте видно, ошибка в ключе identity, гонке INSERT, неверной ветке linking или позднем merge.

Проверенные источники