Аутентификация в Firebase с помощью ссылки на адрес электронной почты на платформах Apple

Вы можете использовать Firebase Authentication, чтобы отправлять пользователям электронные письма со ссылкой для входа. В процессе также проверяется адрес электронной почты пользователя.

У входа по электронной почте есть множество преимуществ:

  • Простая регистрация и вход.
  • Снижается риск повторного использования паролей в разных приложениях, что может подорвать безопасность даже надежных паролей.
  • Возможность аутентифицировать пользователя и одновременно подтвердить, что он является законным владельцем адреса электронной почты.
  • Для входа пользователю нужен только доступный аккаунт электронной почты. Для этого не требуется номер телефона или аккаунт в социальной сети.
  • Пользователь может безопасно войти в аккаунт, не вводя и не запоминая пароль, что может быть неудобно на мобильном устройстве.
  • Существующий пользователь, который ранее входил в систему с помощью идентификатора электронной почты (пароля или федеративного идентификатора), может быть обновлен для входа только с помощью электронной почты. Например, пользователь, который забыл пароль, сможет войти в аккаунт, не сбрасывая пароль.

Подготовка

Для установки зависимостей Firebase и управления ими используйте Swift Package Manager.

  1. Откройте проект приложения в Xcode и перейдите в меню File (Файл) > Add Packages (Добавить пакеты).
  2. Когда появится запрос, добавьте хранилище Firebase SDK для платформ Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Выберите библиотеку Firebase Authentication.
  5. Добавьте флаг -ObjC в раздел Other Linker Flags (Другие флаги компоновщика) в настройках сборки целевого объекта.
  6. После этого Xcode автоматически начнет распознавать и скачивать зависимости в фоновом режиме.

Чтобы пользователи могли входить в аккаунт по ссылке в электронном письме, включите поставщика услуг электронной почты и способ входа по ссылке в электронном письме в проекте Firebase.

  1. В консоли Firebase выберите Безопасность > Аутентификация.

  2. На вкладке Sign-in method (Способ входа) включите поставщика входа Email/Password (Электронная почта/пароль). Обратите внимание, что для использования входа по ссылке в электронном письме необходимо включить вход по адресу электронной почты и паролю.

  3. В том же разделе включите поставщика Email link (passwordless sign-in) (Ссылка в электронном письме (вход без пароля)).

  4. Нажмите Сохранить.

Чтобы запустить процесс аутентификации, покажите пользователю интерфейс, в котором ему будет предложено указать адрес электронной почты, а затем вызовите sendSignInLink, чтобы запросить у Firebase отправку ссылки для аутентификации на адрес электронной почты пользователя.

  1. Создайте объект ActionCodeSettings, который содержит инструкции для Firebase по созданию ссылки в электронном письме. Заполните следующие поля:

    • url – ссылка на контент, которую нужно встроить, и любые дополнительные данные, которые нужно передать. Если вы ещё не добавили свой домен в список авторизованных доменов, сделайте это:

      1. В консоли Firebase перейдите в раздел Security (Безопасность) > Authentication (Аутентификация) > Settings (Настройки).

      2. В разделе Авторизованные домены нажмите Добавить домен и укажите свой домен.

    • iOSBundleID и androidPackageName. Помогают Firebase Authentication определить, какую ссылку нужно создать: только для сайта или для мобильного устройства Android или Apple.
    • handleCodeInApp: задайте значение true. В отличие от других действий, связанных с электронной почтой (сброс пароля и подтверждение адреса электронной почты), вход всегда должен выполняться в приложении. Это связано с тем, что в конце процесса пользователь должен войти в систему, а его состояние аутентификации должно сохраниться в приложении.
    • linkDomain. Если для проекта заданы собственные домены ссылок Hosting, укажите, какой из них использовать, когда ссылка должна открываться в определенном мобильном приложении. В противном случае автоматически выбирается домен по умолчанию (например, PROJECT_ID.firebaseapp.com).
    • dynamicLinkDomain: поддержка прекращена. Не указывайте этот параметр.

    Swift

    let actionCodeSettings = ActionCodeSettings()
    actionCodeSettings.url = URL(string: "https://www.example.com")
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = true
    actionCodeSettings.setIOSBundleID(Bundle.main.bundleIdentifier!)
    actionCodeSettings.setAndroidPackageName("com.example.android",
                                             installIfNotAvailable: false, minimumVersion: "12")

    Objective-C

    FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
    [actionCodeSettings setURL:[NSURL URLWithString:@"https://www.example.com"]];
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = YES;
    [actionCodeSettings setIOSBundleID:[[NSBundle mainBundle] bundleIdentifier]];
    [actionCodeSettings setAndroidPackageName:@"com.example.android"
                        installIfNotAvailable:NO
                               minimumVersion:@"12"];

    Подробнее о ActionCodeSettings читайте в разделе Передача состояния в действиях с письмами.

  2. Запросите у пользователя адрес электронной почты.

  3. Отправьте ссылку для аутентификации на адрес электронной почты пользователя и сохраните этот адрес на случай, если пользователь выполнит вход с его помощью на том же устройстве.

    Swift

    Auth.auth().sendSignInLink(toEmail: email,
                               actionCodeSettings: actionCodeSettings) { error in
      // ...
        if let error = error {
          self.showMessagePrompt(error.localizedDescription)
          return
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        UserDefaults.standard.set(email, forKey: "Email")
        self.showMessagePrompt("Check your email for link")
        // ...
    }

    Objective-C

    [[FIRAuth auth] sendSignInLinkToEmail:email
                       actionCodeSettings:actionCodeSettings
                               completion:^(NSError *_Nullable error) {
      // ...
        if (error) {
          [self showMessagePrompt:error.localizedDescription];
           return;
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        [NSUserDefaults.standardUserDefaults setObject:email forKey:@"Email"];
        [self showMessagePrompt:@"Check your email for link"];
        // ...
    }];

Проблемы с безопасностью

Чтобы предотвратить использование ссылки для входа в систему в качестве непреднамеренного пользователя или на непреднамеренном устройстве, Firebase Auth требует, чтобы адрес электронной почты пользователя был указан при завершении процесса входа. Чтобы вход был выполнен успешно, этот адрес должен совпадать с адресом, на который была отправлена ссылка для входа.

Вы можете упростить этот процесс для пользователей, которые открывают ссылку для входа на том же устройстве, на котором они запрашивают ссылку, сохраняя их адрес электронной почты локально при отправке электронного письма для входа. Затем используйте этот адрес, чтобы завершить процесс.

После завершения входа все ранее не подтвержденные механизмы входа будут удалены из аккаунта пользователя, а все существующие сеансы будут аннулированы. Например, если кто-то ранее создал неподтвержденный аккаунт с тем же адресом электронной почты и паролем, пароль пользователя будет удален, чтобы злоумышленник, который заявил о праве собственности и создал этот неподтвержденный аккаунт, не смог снова войти в систему с тем же аккаунтом.

Завершение входа в мобильном приложении Apple

Firebase Authentication использует Firebase Hosting, чтобы отправить ссылку по электронной почте на мобильное устройство. Чтобы завершить вход с помощью мобильного приложения, оно должно быть настроено на обнаружение входящей ссылки, анализ базовой ссылки на контент и завершение входа. Подробнее о том, как это сделать, рассказывается в статье об универсальных ссылках и связанных доменах в iOS.

Настроить Firebase Hosting

Firebase Authentication использует домены Firebase Hosting при создании и отправке ссылок, которые должны открываться в мобильном приложении. Домен Firebase Hosting по умолчанию уже настроен.

  1. Настройте домены Firebase Hosting:

    В консоли Firebase выберите Hosting & Serverless (Хостинг и бессерверные технологии) > Hosting (Хостинг).

    • Если вы хотите использовать домен по умолчанию для ссылки в электронном письме, которая открывается в мобильных приложениях, перейдите на сайт по умолчанию и запишите домен Hosting по умолчанию. Домен Hosting по умолчанию обычно выглядит так: PROJECT_ID.firebaseapp.com.

      Это значение понадобится вам при настройке приложения для перехвата входящей ссылки.

    • Если вы хотите использовать собственный домен для ссылки в электронном письме, вы можете зарегистрировать его в Firebase Hosting и использовать для домена ссылки.

  2. Настройка приложений Apple:

    Выбранный домен нужно будет настроить как связанный домен для ссылок на приложение. Чтобы настроить права в приложении, откройте вкладку Signing & Capabilities (Подпись и возможности) в Xcode и добавьте домены Firebase Hosting из предыдущего шага в раздел Associated Domains (Связанные домены). Если используется домен по умолчанию Firebase Hosting, то это будет applinks:PROJECT_ID.firebaseapp.com.

    Дополнительную информацию можно найти в статье Supporting associated domains (Поддержка связанных доменов) на сайте документации Apple.

Получив ссылку, как описано выше, убедитесь, что она предназначена для аутентификации по ссылке в электронном письме, и завершите вход.

Swift

if Auth.auth().isSignIn(withEmailLink: link) {
        Auth.auth().signIn(withEmail: email, link: self.link) { user, error in
          // ...
        }
}

Objective-C

if ([[FIRAuth auth] isSignInWithEmailLink:link]) {
    [[FIRAuth auth] signInWithEmail:email
                               link:link
                         completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      // ...
    }];
}

Информацию о том, как настроить вход по ссылке в электронном письме в приложении для Android, можно найти в руководстве по Android.

Чтобы узнать, как настроить вход по ссылке в электронном письме в веб-приложении, ознакомьтесь с руководством по веб-приложениям.

Вы также можете связать этот способ аутентификации с существующим пользователем. Например, пользователь, который ранее проходил аутентификацию с помощью другого поставщика, например номера телефона, может добавить этот способ входа в свой существующий аккаунт.

Разница будет во второй половине операции:

Swift

  let credential = EmailAuthCredential.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.link(with: credential) { authData, error in
    if (error) {
      // And error occurred during linking.
      return
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthProvider credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      linkWithCredential:credential
              completion:^(FIRAuthDataResult *_Nullable result,
                           NSError *_Nullable error) {
    if (error) {
      // And error occurred during linking.
      return;
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }];

Это также можно использовать для повторной аутентификации пользователя, который вошел по ссылке в электронном письме, перед выполнением конфиденциальной операции.

Swift

  let credential = EmailAuthProvider.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.reauthenticate(with: credential) { authData, error in
    if (error) {
      // And error occurred during re-authentication.
      return
    }
    // The user was successfully re-authenticated.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthCredential credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      reauthenticateWithCredential:credential
                        completion:^(FIRAuthDataResult *_Nullable result,
                                     NSError *_Nullable error) {
    if (error) {
      // And error occurred during re-authentication
      return;
    }
    // The user was successfully re-authenticated.
  }];

Однако, поскольку процесс может завершиться на другом устройстве, где исходный пользователь не вошел в систему, этот процесс может не завершиться. В этом случае пользователю может быть показано сообщение об ошибке, чтобы он открыл ссылку на том же устройстве. В ссылке можно передать некоторые данные, чтобы предоставить информацию о типе операции и UID пользователя.

До версии 11.8.0 iOS SDK Firebase Authentication для входа по ссылке в электронном письме использовались Firebase Dynamic Links, чтобы открывать ссылки для входа в нужном приложении. Эти ссылки для подтверждения больше не поддерживаются, поскольку Firebase Dynamic Links прекратит работу 25 августа 2025 г.

Если в вашем приложении используются ссылки старого типа, перенесите его на новую систему на основе Firebase Hosting.

Если вы создали проект 15 сентября 2023 года или позже, защита от перебора адресов электронной почты включена по умолчанию. Эта функция повышает безопасность аккаунтов пользователей в вашем проекте, но отключает метод fetchSignInMethodsForEmail(), который мы ранее рекомендовали для реализации процессов, в которых сначала указывается идентификатор.

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

Подробнее о том, как включить или отключить защиту от перебора адресов электронной почты…

Дальнейшие действия

После первого входа пользователя создается новый аккаунт, который связывается с учетными данными, то есть именем пользователя и паролем, номером телефона или информацией от поставщика аутентификации, с помощью которых пользователь вошел в систему. Этот новый аккаунт сохраняется в проекте Firebase и может использоваться для идентификации пользователя во всех приложениях проекта, независимо от того, как пользователь входит в систему.

  • В приложениях можно получить основную информацию профиля пользователя из объекта User. Подробнее об управлении пользователями…

  • В правилах безопасности Firebase Realtime Database и Cloud Storage вы можете получить уникальный идентификатор пользователя, выполнившего вход, из переменной auth и использовать его, чтобы управлять доступом к данным.

Вы можете разрешить пользователям входить в приложение с помощью нескольких поставщиков аутентификации, связав учетные данные поставщика аутентификации с существующим аккаунтом пользователя.

Чтобы выполнить выход пользователя, вызовите signOut:.

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

Вы также можете добавить код обработки ошибок для всего диапазона ошибок аутентификации. Подробнее об обработке ошибок…