Here's everything we announced at I/O, from new Firebase Studio features to more ways to integrate AI. Read blog.

Эта страница переведена с помощью Cloud Translation API.

Аутентификация в Firebase с использованием учетных записей на основе пароля на платформах Apple.
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:

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

Выберите библиотеку Firebase Authentication .
Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Далее выполните некоторые шаги по настройке:

Если вы еще не подключили свое приложение к проекту Firebase, сделайте это из консоли Firebase .
Включить вход по электронной почте/паролю:
1. В консоли Firebase откройте раздел Auth .
2. На вкладке «Способ входа» включите метод входа « Электронная почта/пароль» и нажмите «Сохранить» .

Создайте учетную запись с паролем

Чтобы создать новую учетную запись пользователя с паролем, выполните следующие действия при входе в приложение:

Импортируйте модуль FirebaseCore в ваш UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Быстрый
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Objective-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```
Настройте общий экземпляр FirebaseApp в методе делегата приложения application application(_:didFinishLaunchingWithOptions:) :
SwiftUI
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Быстрый
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```
Если вы используете SwiftUI, вы должны создать делегат приложения и прикрепить его к структуре App через UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вы также должны отключить swizzling делегата приложения. Для получения дополнительной информации см. инструкции SwiftUI .
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```
Когда новый пользователь регистрируется с помощью формы регистрации вашего приложения, выполните все необходимые шаги по проверке новой учетной записи, требуемые вашим приложением, например, проверьте, что пароль новой учетной записи введен правильно и соответствует вашим требованиям к сложности.
Создайте новую учетную запись, передав адрес электронной почты и пароль нового пользователя в createUser .
Быстрый
```
Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
  // ...
}
```
Objective-C
```
[[FIRAuth auth] createUserWithEmail:email
                           password:password
                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
  // ...
}];
```
Если новая учетная запись была успешно создана, пользователь вошел в систему, и вы можете получить данные учетной записи пользователя из объекта результата, который передается в метод обратного вызова.

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

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

Импортируйте модуль FirebaseCore в ваш UIApplicationDelegate , а также любые другие модули Firebase, которые использует ваш делегат приложения. Например, чтобы использовать Cloud Firestore и Authentication :
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Быстрый
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Objective-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```
Настройте общий экземпляр FirebaseApp в методе делегата приложения application application(_:didFinishLaunchingWithOptions:) :
SwiftUI
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Быстрый
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```
Если вы используете SwiftUI, вы должны создать делегат приложения и прикрепить его к структуре App через UIApplicationDelegateAdaptor или NSApplicationDelegateAdaptor . Вы также должны отключить swizzling делегата приложения. Для получения дополнительной информации см. инструкции SwiftUI .
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```

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

Быстрый

Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
  guard let strongSelf = self else { return }
  // ...
}

Objective-C

[[FIRAuth auth] signInWithEmail:self->_emailField.text
                       password:self->_passwordField.text
                     completion:^(FIRAuthDataResult * _Nullable authResult,
                                  NSError * _Nullable error) {
  // ...
}];

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

Рекомендуется: установить политику паролей.

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

Чтобы настроить политику паролей для вашего проекта, откройте вкладку «Политика паролей» на странице «Параметры аутентификации» консоли Firebase :

Настройки аутентификации

Политики паролей Firebase Authentication поддерживают следующие требования к паролям:

Требуется строчный символ
Требуется заглавный символ
Требуется числовой символ
Требуется не буквенно-цифровой символ
Следующие символы удовлетворяют требованию не быть буквенно-цифровыми: ^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~
Минимальная длина пароля (от 6 до 30 символов; по умолчанию 6)
Максимальная длина пароля (максимальная длина 4096 символов)

Вы можете включить принудительное применение политики паролей в двух режимах:

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

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

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

Рекомендуется: включить защиту от перечисления адресов электронной почты

Некоторые методы Firebase Authentication , которые принимают адреса электронной почты в качестве параметров, выдают определенные ошибки, если адрес электронной почты не зарегистрирован, когда он должен быть зарегистрирован (например, при входе с адресом электронной почты и паролем), или зарегистрирован, когда он не должен использоваться (например, при изменении адреса электронной почты пользователя). Хотя это может быть полезно для предложения пользователям конкретных мер, это также может быть использовано злоумышленниками для обнаружения адресов электронной почты, зарегистрированных вашими пользователями.

Чтобы снизить этот риск, мы рекомендуем вам включить защиту перечисления адресов электронной почты для вашего проекта с помощью инструмента Google Cloud gcloud . Обратите внимание, что включение этой функции изменяет поведение Firebase Authentication при сообщении об ошибках: убедитесь, что ваше приложение не полагается на более конкретные ошибки.

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

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

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

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

Чтобы выйти из системы пользователя, вызовите signOut:

Быстрый

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;
}

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

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

Создайте учетную запись с паролем

SwiftUI

Быстрый

Objective-C

SwiftUI

Быстрый

Objective-C

SwiftUI

Быстрый

Objective-C

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

SwiftUI

Быстрый

Objective-C

SwiftUI

Быстрый

Objective-C

SwiftUI

Быстрый

Objective-C

Рекомендуется: установить политику паролей.

Рекомендуется: включить защиту от перечисления адресов электронной почты

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

Быстрый

Objective-C