Проверьте, по чему приложение узнаёт пользователя после 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, а не удалять немедленно: это облегчает аудит и безопасный откат ошибочного слияния.
Регрессионный набор ловит повторное рождение дубля
- Войти дважды через один issuer и получить один user_id.
- Изменить email у провайдера при неизменном sub и остаться в том же профиле.
- Подать одинаковый email от другого issuer и потребовать подтверждённую привязку.
- Одновременно завершить два first-login callback и проверить UNIQUE (issuer, subject).
- Объединить два тестовых профиля с конфликтующими ролями и убедиться, что merge остановлен.
Для разбора нужны обезличенные iss, хеш или тестовый sub, tenant/connection, локальные user IDs и решения first-login flow. ID Token целиком, cookie и client secret передавать нельзя. По этой карте видно, ошибка в ключе identity, гонке INSERT, неверной ветке linking или позднем merge.