Вы можете использовать Firebase Authentication, чтобы отправлять пользователям электронные письма со ссылкой для входа. В процессе также проверяется адрес электронной почты пользователя.
У входа по электронной почте есть множество преимуществ:
- Простая регистрация и вход.
- Снижается риск повторного использования паролей в разных приложениях, что может подорвать безопасность даже надежных паролей.
- Возможность аутентифицировать пользователя и одновременно подтвердить, что он является законным владельцем адреса электронной почты.
- Для входа пользователю нужен только доступный аккаунт электронной почты. Для этого не требуется номер телефона или аккаунт в социальной сети.
- Пользователь может безопасно войти в аккаунт, не вводя и не запоминая пароль, что может быть неудобно на мобильном устройстве.
- Существующий пользователь, который ранее входил в систему с помощью идентификатора электронной почты (пароля или федеративного идентификатора), может быть обновлен для входа только с помощью электронной почты. Например, пользователь, который забыл пароль, сможет войти в аккаунт, не сбрасывая пароль.
Подготовка
Для установки зависимостей Firebase и управления ими используйте Swift Package Manager.
- Откройте проект приложения в Xcode и перейдите в меню File (Файл) > Add Packages (Добавить пакеты).
- Когда появится запрос, добавьте хранилище Firebase SDK для платформ Apple:
- Выберите библиотеку Firebase Authentication.
- Добавьте флаг
-ObjCв раздел Other Linker Flags (Другие флаги компоновщика) в настройках сборки целевого объекта. - После этого Xcode автоматически начнет распознавать и скачивать зависимости в фоновом режиме.
https://github.com/firebase/firebase-ios-sdk.git
Как включить вход по ссылке в электронном письме для проекта Firebase
Чтобы пользователи могли входить в аккаунт по ссылке в электронном письме, включите поставщика услуг электронной почты и способ входа по ссылке в электронном письме в проекте Firebase.
В консоли Firebase выберите Безопасность > Аутентификация.
На вкладке Sign-in method (Способ входа) включите поставщика входа Email/Password (Электронная почта/пароль). Обратите внимание, что для использования входа по ссылке в электронном письме необходимо включить вход по адресу электронной почты и паролю.
В том же разделе включите поставщика Email link (passwordless sign-in) (Ссылка в электронном письме (вход без пароля)).
Нажмите Сохранить.
Отправить ссылку для аутентификации на адрес электронной почты пользователя
Чтобы запустить процесс аутентификации, покажите пользователю интерфейс, в котором ему будет предложено указать адрес электронной почты, а затем вызовите sendSignInLink, чтобы запросить у Firebase отправку ссылки для аутентификации на адрес электронной почты пользователя.
Создайте объект
ActionCodeSettings, который содержит инструкции для Firebase по созданию ссылки в электронном письме. Заполните следующие поля:url– ссылка на контент, которую нужно встроить, и любые дополнительные данные, которые нужно передать. Если вы ещё не добавили свой домен в список авторизованных доменов, сделайте это:В консоли Firebase перейдите в раздел Security (Безопасность) > Authentication (Аутентификация) > Settings (Настройки).
В разделе Авторизованные домены нажмите Добавить домен и укажите свой домен.
iOSBundleIDиandroidPackageName. Помогают Firebase Authentication определить, какую ссылку нужно создать: только для сайта или для мобильного устройства Android или Apple.handleCodeInApp: задайте значение true. В отличие от других действий, связанных с электронной почтой (сброс пароля и подтверждение адреса электронной почты), вход всегда должен выполняться в приложении. Это связано с тем, что в конце процесса пользователь должен войти в систему, а его состояние аутентификации должно сохраниться в приложении.linkDomain. Если для проекта заданы собственные домены ссылок Hosting, укажите, какой из них использовать, когда ссылка должна открываться в определенном мобильном приложении. В противном случае автоматически выбирается домен по умолчанию (например, ).PROJECT_ID.firebaseapp.comdynamicLinkDomain: поддержка прекращена. Не указывайте этот параметр.
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читайте в разделе Передача состояния в действиях с письмами.Запросите у пользователя адрес электронной почты.
Отправьте ссылку для аутентификации на адрес электронной почты пользователя и сохраните этот адрес на случай, если пользователь выполнит вход с его помощью на том же устройстве.
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 по умолчанию уже настроен.
Настройте домены Firebase Hosting:
В консоли Firebase выберите Hosting & Serverless (Хостинг и бессерверные технологии) > Hosting (Хостинг).
Если вы хотите использовать домен по умолчанию для ссылки в электронном письме, которая открывается в мобильных приложениях, перейдите на сайт по умолчанию и запишите домен Hosting по умолчанию. Домен Hosting по умолчанию обычно выглядит так:
.PROJECT_ID.firebaseapp.comЭто значение понадобится вам при настройке приложения для перехвата входящей ссылки.
Если вы хотите использовать собственный домен для ссылки в электронном письме, вы можете зарегистрировать его в Firebase Hosting и использовать для домена ссылки.
Настройка приложений 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 пользователя.
Устарело: подтверждение на основе Firebase Dynamic Links
До версии 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; }
Вы также можете добавить код обработки ошибок для всего диапазона ошибок аутентификации. Подробнее об обработке ошибок…