Перейти к содержимому

Безопасность · Глава 17

Привязка существующих пользователей

В вашем сервисе уже есть пользователи со своими паролями. Когда они впервые нажимают «Войти через GOXOST ID», привяжите GOXOST ID к уже существующей учётной записи — один раз и безопасно.

1 мин чтения

Правило

  1. Сначала ищите по sub. Если пользователь с таким goxost_sub существует, выполните вход. Это обычный путь для всех входов после первого.
  2. Иначе сопоставьте по подтверждённой почте — один раз. Если email_verified равен true и ровно у одного вашего пользователя такая почта (и вы сами её тоже подтвердили), сохраните sub у этого пользователя и выполните вход.
  3. Иначе создайте нового пользователя с sub или попросите пользователя один раз войти со старым паролем, чтобы связать учётные записи.

После шага 2 почта больше никогда не используется для сопоставления этого пользователя: если он сменит почту в GOXOST ID, sub по-прежнему указывает на ту же учётную запись.

Не доверяйте неподтверждённой почте

Сопоставляйте только при email_verified, равном true. GOXOST ID устанавливает его после того, как пользователь введёт код, отправленный на этот адрес. Сопоставление по неподтверждённой почте позволило бы любому, кто введёт чужой адрес, захватить чужую учётную запись в вашем сервисе.

Точно так же, если ваш сервис никогда не подтверждал почту существующей учётной записи, не привязывайте автоматически — сначала запросите старый пароль.

Пример

function findOrLinkUser(array $claims): User
{
    // 1. Already linked
    if ($user = User::firstWhere('goxost_sub', $claims['sub'])) {
        return $user;
    }

    // 2. One-time link by verified email
    if (($claims['email_verified'] ?? false) === true) {
        $user = User::where('email', $claims['email'])
            ->whereNull('goxost_sub')
            ->whereNotNull('email_verified_at')
            ->first();

        if ($user) {
            $user->forceFill(['goxost_sub' => $claims['sub']])->save();
            audit('goxost_linked', $user->id); // keep a record, without personal data

            return $user;
        }
    }

    // 3. New user
    return User::create([
        'goxost_sub' => $claims['sub'],
        'name' => $claims['name'] ?? '',
        'email' => $claims['email'] ?? null,
    ]);
}

Отвязка и конфликты

  • Покажите пользователю в профиле, что учётная запись привязана к GOXOST ID, и разрешите отвязку, если у него остаётся другой способ входа.
  • Если подтверждённая почта принадлежит пользователю, уже привязанному к другому sub, не перезаписывайте привязку — покажите сообщение и передайте вопрос поддержке.
  • Сделайте столбец уникальным: один sub — один пользователь.