Аутентификация с помощью Firebase анонимно на платформах Apple

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

Прежде чем начать

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

   Посетите наше руководство по установке , чтобы узнать о различных способах добавления SDK Firebase в ваш проект Apple, включая прямой импорт фреймворков и использование CocoaPods.
   1. В Xcode, открыв проект приложения, выберите «Файл» > «Добавить пакеты» .
   2. При появлении запроса добавьте репозиторий Firebase SDK для платформ Apple:

     https://github.com/firebase/firebase-ios-sdk.git

   Примечание. В новых проектах должна использоваться версия SDK по умолчанию (последняя), но при необходимости вы можете выбрать более старую версию.
   3. Выберите библиотеку Firebase Authentication .
   4. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
   5. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.
2. Если вы еще не подключили свое приложение к проекту Firebase, сделайте это из консоли Firebase .
3. Включите анонимную аутентификацию:
   1. В консоли Firebase откройте раздел Auth .
   2. На странице «Способы входа» включите анонимный метод входа.
   3. Необязательно : если вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете включить автоматическую очистку. Если вы включите этот параметр, анонимные учетные записи старше 30 дней будут автоматически удалены. В проектах с включенной автоматической очисткой анонимная проверка подлинности больше не будет учитываться при расчете лимитов использования или квот выставления счетов. См. Автоматическая очистка .

Аутентификация с помощью Firebase анонимно

Если пользователь, вышедший из системы, использует функцию приложения, требующую аутентификации с помощью Firebase, войдите в систему анонимно, выполнив следующие шаги:

1. Импортируйте модуль FirebaseCore в свой UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Быстрый

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Цель-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Настройте общий экземпляр FirebaseApp в методе application(_:didFinishLaunchingWithOptions:) делегата вашего приложения:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Быстрый

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Цель-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Если вы используете SwiftUI, вам необходимо создать делегат приложения и прикрепить его к структуре вашего App через UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вы также должны отключить переключение делегатов приложений. Дополнительную информацию смотрите в инструкциях SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Вызовите метод signInAnonymouslyWithCompletion:

   Быстрый

   Auth.auth().signInAnonymously { authResult, error in
     // ...
   }

   Цель-C

   [[FIRAuth auth] signInAnonymouslyWithCompletion:^(FIRAuthDataResult * _Nullable authResult,
                                                     NSError * _Nullable error) {
      // ...
    }];

5. Если метод signInAnonymouslyWithCompletion: завершается без ошибок, вы можете получить данные учетной записи анонимного пользователя из объекта FIRAuthDataResult :

   Быстрый

   guard let user = authResult?.user else { return }
   let isAnonymous = user.isAnonymous  // true
   let uid = user.uid

   Цель-C

   FIRUser *user = authResult.user;
   BOOL isAnonymous = user.anonymous;  // YES
   NSString *uid = user.uid;

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

Преобразование анонимной учетной записи в постоянную учетную запись

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

1. Когда пользователь регистрируется, завершите процесс входа для поставщика аутентификации пользователя, включая вызов одного из методов FIRAuth.signInWith , но не включая его. Например, получите токен идентификатора Google пользователя, токен доступа к Facebook или адрес электронной почты и пароль.

2. Получите FIRAuthCredential для нового поставщика аутентификации:

   Вход в Google

   Быстрый

   guard
     let authentication = user?.authentication,
     let idToken = authentication.idToken
   else {
     return
   }
   
   let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                  accessToken: authentication.accessToken)

   Цель-C

   FIRAuthCredential *credential =
   [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                    accessToken:result.user.accessToken.tokenString];

   Вход в Facebook

   Быстрый

   let credential = FacebookAuthProvider
     .credential(withAccessToken: AccessToken.current!.tokenString)

   Цель-C

   FIRAuthCredential *credential = [FIRFacebookAuthProvider
       credentialWithAccessToken:[FBSDKAccessToken currentAccessToken].tokenString];

   Вход по электронной почте и паролю

   Быстрый

   let credential = EmailAuthProvider.credential(withEmail: email, password: password)

   Цель-C

   FIRAuthCredential *credential =
       [FIREmailAuthProvider credentialWithEmail:email
                                                password:password];

3. Передайте объект FIRAuthCredential в метод linkWithCredential:completion: пользователя, выполняющего вход:

   Быстрый

       user.link(with: credential) { authResult, error in
     // ...
   }
   }

   Цель-C

       [[FIRAuth auth].currentUser linkWithCredential:credential
       completion:^(FIRAuthDataResult *result, NSError *_Nullable error) {
     // ...
   }];

Если вызов linkWithCredential:completion: успешен, новая учетная запись пользователя сможет получить доступ к данным Firebase анонимной учетной записи.

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

Автоматическая очистка

Если вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете включить автоматическую очистку в консоли Firebase . Когда вы включаете эту функцию, вы разрешаете Firebase автоматически удалять анонимные учетные записи старше 30 дней. В проектах с включенной автоматической очисткой анонимная проверка подлинности не учитывается при расчете лимитов использования или квот на выставление счетов.

• Любые анонимные учетные записи, созданные после включения автоматической очистки, могут быть автоматически удалены в любое время через 30 дней после создания.
• Существующие анонимные учетные записи будут иметь право на автоматическое удаление через 30 дней после включения автоматической очистки.
• Если вы отключите автоматическую очистку, все анонимные учетные записи, запланированные к удалению, останутся запланированными к удалению.
• Если вы «обновите» анонимную учетную запись, связав ее с любым методом входа, учетная запись не будет автоматически удалена.

Если вы хотите узнать, сколько пользователей будет затронуто, прежде чем вы включите эту функцию, и вы обновили свой проект до Firebase Authentication with Identity Platform , вы можете фильтровать по is_anon в Cloud Logging .

Следующие шаги

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