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

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

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

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

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

В Xcode, открыв проект приложения, перейдите в меню File > Add Packages .
При появлении запроса добавьте репозиторий Firebase Apple Platforms SDK:

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

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

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

Если вы еще не подключили свое приложение к проекту Firebase, сделайте это через консоль Firebase .
Включите вход по электронной почте и паролю:
1. В консоли Firebase откройте раздел «Аутентификация» .
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(_: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 . Также необходимо отключить подмену делегатов приложения. Для получения дополнительной информации см. инструкции 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(_: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 . Также необходимо отключить подмену делегатов приложения. Для получения дополнительной информации см. инструкции 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 символов)

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

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

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

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

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

Некоторые методы 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