Не начинайте с кнопки «разрешить внешних». Возьмите один гостевой аккаунт и запишите correlation ID, tenant, redirect URI и текст ошибки без token. Затем ответьте на простой вопрос: отказ показал провайдер идентификации или уже ваше приложение? Эти две ветки требуют разных исправлений.
У сотрудника обычно уже есть объект в домашнем каталоге, назначение enterprise application и привычный набор claims. У внешнего пользователя может быть домашняя учётная запись, гостевой объект в вашем workforce tenant и отдельная локальная запись приложения. Потеря любой связи выглядит как «SSO не работает».
Разделите authentication и authorization
| Где остановился поток | Наблюдение | Куда смотреть |
|---|---|---|
| До login | неверный tenant/политика | authorization endpoint и account type |
| После login у IdP | access denied/assignment | guest object, invitation, app assignment |
| На callback | issuer/audience/state | OIDC validation и redirect URI |
| После callback | 403 приложения | provisioning, группы и локальные роли |
| Создался новый профиль | неверное связывание | immutable external identity key |
Приглашение должно стать гостевым объектом
В Microsoft Entra B2B приглашённый пользователь представлен объектом в каталоге ресурсной организации. Одной отправки письма недостаточно: приглашение должно быть погашено, а объект — существовать в нужном tenant. Проверьте его статус, способ входа и то, что тестируется именно приглашённая учётная запись, а не другой личный аккаунт в том же браузере.
- Найти гостя в каталоге по object ID, а не только по адресу.
- Проверить, что приглашение принято и не ожидает redemption.
- Убедиться, что enterprise application доступно этому пользователю или его группе.
- Проверить cross-tenant access и Conditional Access, если они применяются.
- Повторить тест в чистой сессии, выбрав правильную учётную запись.
Tenant, issuer и audience должны совпасть
Приложение не должно принимать token только потому, что в нём знакомый email. Валидируйте подпись, issuer, audience, срок действия, state и nonce по выбранной OIDC-конфигурации. Для multi-tenant приложения явно определите доверенные tenants; для single-tenant не отправляйте гостя в случайный common endpoint, если архитектура ожидает объект в ресурсном tenant.
external_identity_key = issuer + '|' + subject
validate:
signature, issuer, audience, exp
state and nonce for authorization flow
map:
external_identity_key -> local_user_id -> roleНазвания конкретных claims зависят от провайдера и конфигурации. `email` может отсутствовать, меняться или совпадать у разных контекстов, поэтому используйте его для связи с осторожностью и только после подтверждённого процесса.
Назначение приложения не равно локальной роли
Гость может успешно аутентифицироваться и всё равно получить 403. Провайдер подтвердил личность, но приложению ещё нужно решить, кому разрешён доступ. Проверьте user/group assignment, app roles, выдаваемые group/role claims и локальную таблицу прав. Если группы не помещаются в token или не выдаются гостям так же, как сотрудникам, запросите нужные данные поддерживаемым способом вместо предположения.
| Проверка | Сотрудник | Гость | Вывод |
|---|---|---|---|
| Token выпущен | да | нет | ветка IdP/tenant |
| aud и iss валидны | да | нет | конфигурация OIDC |
| App assignment | группа | нет | назначить явно |
| Локальный user | есть | нет | настроить provisioning |
| Роль приложения | admin | пусто | политика authorization |
Опасные быстрые исправления
- Не отключайте проверку issuer или audience ради одного гостя.
- Не разрешайте любой аккаунт с подходящим доменом email.
- Не выдавайте всем внешним пользователям роль сотрудника по умолчанию.
- Не создавайте новый локальный профиль при каждом изменении claims.
- Не логируйте полный ID token, authorization code или session cookie.
Минимальная матрица подтверждает исправление
Проверьте сотрудника, приглашённого гостя, неприглашённого внешнего пользователя и удалённого гостя. Для каждого отдельно зафиксируйте результат IdP, создание/поиск локальной записи и итоговую роль. Неприглашённый пользователь должен получить контролируемый отказ, а удалённый — потерять доступ без сохранения старой сессии сверх вашей политики.
Диагностика закончена, когда видна конкретная граница отказа и права гостя воспроизводятся независимо от его браузерной сессии. Для разбора нужны tenant IDs, обезличенные claims, correlation ID, правила assignment и локальная mapping-запись; секрет клиента, tokens и реальные адреса передавать не следует.