Если человек открывает приглашение, регистрируется и не видит команду, контекст invite потерялся до создания membership. Ссылка должна вести не на обычный `/signup`, а на серверный сценарий принятия приглашения. Он проверяет одноразовый token, запоминает invite ID в защищённом состоянии и после аутентификации связывает пользователя с конкретной организацией и ролью.

Не передавайте роль и tenant ID как доверенные query-параметры. Источник истины — запись приглашения в базе: кто пригласил, в какую организацию, какой email или домен разрешён, какая роль будет выдана, когда истекает ссылка и была ли она уже использована. Клиент хранит только непрозрачный token либо подписанное представление с проверяемыми claims.

У приглашения есть состояния, а не один флаг used

СостояниеЧто разрешеноЧто видит пользователь
pendingначать вход или регистрациюназвание команды и маскированный email
auth_pendingвернуться из OAuth по тому же flow IDпродолжение без повторной ссылки
acceptedпоказать существующее membershipкоманда уже подключена
expiredсоздать новое приглашениепонятное сообщение без раскрытия tenant
revokedничего не выдаватьсвязаться с администратором

Состояние `accepted` делает повторный клик идемпотентным: пользователь попадает в ту же команду, а не получает дубль membership. Отзыв и истечение не удаляют аудит; они закрывают возможность принятия и сохраняют причину.

Redirect через OAuth получает короткоживущий flow ID

При переходе к внешнему провайдеру браузер покидает ваш домен. До редиректа создайте серверный signup flow, связанный с invite ID, и привяжите его к параметру `state` или собственной защищённой сессии. Callback сначала валидирует OAuth state, затем получает flow и продолжает приглашение. Email, роль и tenant не восстанавливаются из произвольного `returnUrl`.

invite_id=inv_7f...
flow_id=flow_91...
state_hash=sha256(random_state)
expected_tenant=team_42
expected_email_hash=...
expires_at=2026-10-08T19:30:00Z

callback -> validate state -> load flow -> authenticate user -> accept invite
  • Token приглашения одноразовый и имеет ограниченный срок.
  • Redirect разрешён только на заранее допустимый путь внутри приложения.
  • После входа session ID обновляется, потому что уровень доступа изменился.
  • Секрет token хранится в журнале только как хеш или маска.

Совпадение email — отдельное продуктовое решение

Если приглашение адресовано конкретному email, заранее решите, должен ли аккаунт подтвердить именно этот адрес. Автоматически менять email пользователя или добавлять чужую организацию по одному совпадению строки нельзя. Для уже существующего аккаунта сценарий может запросить подтверждение адреса и повторную аутентификацию, а затем вернуться к тому же invite.

При доменном приглашении проверяют подтверждённый домен организации и подтверждённый email пользователя. Текст ошибки не должен раскрывать постороннему, существует ли команда или учётная запись. Администратор в собственном интерфейсе видит точную причину: другой email, истёкшая ссылка, приглашение отозвано или membership уже создано.

Membership и consume invite выполняются одной операцией

Два открытых браузера могут принять одну ссылку почти одновременно. Создание membership и перевод invite в accepted выполняются в одной транзакции, а уникальность пары `tenant_id + user_id` поддерживается ограничением базы. Повтор после сетевого тайм-аута читает уже созданный результат вместо второй роли или ошибки без объяснения.

accept(invite, authenticated_user):
  lock invite record
  reject expired or revoked
  verify confirmed identity
  create membership if absent
  mark invite accepted with user_id and timestamp
  commit
  rotate session and redirect to team

Роль берётся из актуальной политики приглашения в момент принятия. Если администратор понизил или отозвал роль, старое содержимое браузера не должно вернуть прежнее значение. Критичные изменения пишутся в аудит: invite ID, actor, tenant, итоговая роль, время и результат без token.

Пять тестов закрывают реальные разрывы сценария

  1. Новый пользователь принимает ссылку через email/password и сразу видит нужную команду.
  2. Тот же пользователь проходит OAuth callback и сохраняет invite context.
  3. Существующий аккаунт с подтверждённым email получает membership без дубля профиля.
  4. Другой email, истёкший и отозванный invite завершаются безопасным отказом.
  5. Два параллельных запроса создают одну связь, а повторный клик открывает уже доступную команду.

Для диагностики подготовьте invite ID, flow ID, обезличенный user ID, состояния до и после callback и запись аудита. Пароль, OAuth code и token приглашения не нужны. По этой цепочке видно, потерялся ли контекст в redirect, проверке личности или транзакции membership.

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