Не начинайте с кнопки «разрешить внешних». Возьмите один гостевой аккаунт и запишите correlation ID, tenant, redirect URI и текст ошибки без token. Затем ответьте на простой вопрос: отказ показал провайдер идентификации или уже ваше приложение? Эти две ветки требуют разных исправлений.

У сотрудника обычно уже есть объект в домашнем каталоге, назначение enterprise application и привычный набор claims. У внешнего пользователя может быть домашняя учётная запись, гостевой объект в вашем workforce tenant и отдельная локальная запись приложения. Потеря любой связи выглядит как «SSO не работает».

Разделите authentication и authorization

Где остановился потокНаблюдениеКуда смотреть
До loginневерный tenant/политикаauthorization endpoint и account type
После login у IdPaccess denied/assignmentguest object, invitation, app assignment
На callbackissuer/audience/stateOIDC validation и redirect URI
После callback403 приложения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

Опасные быстрые исправления

  1. Не отключайте проверку issuer или audience ради одного гостя.
  2. Не разрешайте любой аккаунт с подходящим доменом email.
  3. Не выдавайте всем внешним пользователям роль сотрудника по умолчанию.
  4. Не создавайте новый локальный профиль при каждом изменении claims.
  5. Не логируйте полный ID token, authorization code или session cookie.

Минимальная матрица подтверждает исправление

Проверьте сотрудника, приглашённого гостя, неприглашённого внешнего пользователя и удалённого гостя. Для каждого отдельно зафиксируйте результат IdP, создание/поиск локальной записи и итоговую роль. Неприглашённый пользователь должен получить контролируемый отказ, а удалённый — потерять доступ без сохранения старой сессии сверх вашей политики.

Диагностика закончена, когда видна конкретная граница отказа и права гостя воспроизводятся независимо от его браузерной сессии. Для разбора нужны tenant IDs, обезличенные claims, correlation ID, правила assignment и локальная mapping-запись; секрет клиента, tokens и реальные адреса передавать не следует.

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