Как создать пользователя
Вы можете создать нового пользователя одним из следующих способов:
Из приложения. Создайте нового пользователя в проекте Firebase, вызвав метод
createUserили выполнив первый вход пользователя с помощью федеративного поставщика идентификационной информации, например входа с аккаунтом Google или Facebook Login.В консоли Firebase создайте нового пользователя с аутентификацией по паролю на вкладке Security (Безопасность) > Authentication (Аутентификация) > Users (Пользователи).
Получение данных о пользователе, выполнившем вход
Рекомендуемый способ получить текущего пользователя – настроить прослушиватель для объекта Auth:
Swift
handle = Auth.auth().addStateDidChangeListener { auth, user in // ... }
Objective-C
self.handle = [[FIRAuth auth] addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) { // ... }];
Используя прослушиватель, вы гарантируете, что объект Auth не находится в промежуточном состоянии, например инициализации, когда вы получаете текущего пользователя.
Вы также можете получить информацию о пользователе, который вошел в аккаунт, с помощью свойства currentUser. Если пользователь не вошел в аккаунт, currentUser будет иметь значение nil:
Swift
if Auth.auth().currentUser != nil { // User is signed in. // ... } else { // No user is signed in. // ... }
Objective-C
if ([FIRAuth auth].currentUser) { // User is signed in. // ... } else { // No user is signed in. // ... }
Как получить профиль пользователя
Чтобы получить информацию профиля пользователя, используйте свойства экземпляра FIRUser. Пример:
Swift
let user = Auth.auth().currentUser if let user = user { // The user's ID, unique to the Firebase project. // Do NOT use this value to authenticate with your backend server, // if you have one. Use getTokenWithCompletion:completion: instead. let uid = user.uid let email = user.email let photoURL = user.photoURL var multiFactorString = "MultiFactor: " for info in user.multiFactor.enrolledFactors { multiFactorString += info.displayName ?? "[DispayName]" multiFactorString += " " } // ... }
Objective-C
FIRUser *user = [FIRAuth auth].currentUser; if (user) { // The user's ID, unique to the Firebase project. // Do NOT use this value to authenticate with your backend server, // if you have one. Use getTokenWithCompletion:completion: instead. NSString *email = user.email; NSString *uid = user.uid; NSMutableString *multiFactorString = [NSMutableString stringWithFormat:@"MultiFactor: "]; for (FIRMultiFactorInfo *info in user.multiFactor.enrolledFactors) { [multiFactorString appendString:info.displayName]; [multiFactorString appendString:@" "]; } NSURL *photoURL = user.photoURL; // ... }
Как получить информацию профиля пользователя, относящуюся к поставщику
Чтобы получить информацию профиля, извлеченную из поставщиков входа, связанных с пользователем, используйте свойство providerData. Пример:
Swift
let userInfo = Auth.auth().currentUser?.providerData[indexPath.row] cell?.textLabel?.text = userInfo?.providerID // Provider-specific UID cell?.detailTextLabel?.text = userInfo?.uid
Objective-C
id<FIRUserInfo> userInfo = [FIRAuth auth].currentUser.providerData[indexPath.row]; cell.textLabel.text = [userInfo providerID]; // Provider-specific UID cell.detailTextLabel.text = [userInfo uid];
Как изменить профиль пользователя
Вы можете обновить основные данные профиля пользователя, например отображаемое название и URL фото профиля, с помощью класса UserProfileChangeRequest. Пример:
Swift
let changeRequest = Auth.auth().currentUser?.createProfileChangeRequest() changeRequest?.displayName = displayName changeRequest?.commitChanges { error in // ... }
Objective-C
FIRUserProfileChangeRequest *changeRequest = [[FIRAuth auth].currentUser profileChangeRequest]; changeRequest.displayName = userInput; [changeRequest commitChangesWithCompletion:^(NSError *_Nullable error) { // ... }];
Как задать адрес электронной почты пользователя
Адрес электронной почты пользователя можно задать с помощью метода updateEmail.
Пример:
Swift
Auth.auth().currentUser?.updateEmail(to: email) { error in // ... }
Objective-C
[[FIRAuth auth].currentUser updateEmail:userInput completion:^(NSError *_Nullable error) { // ... }];
Как отправить пользователю письмо с подтверждением
Вы можете отправить пользователю письмо с подтверждением адреса с помощью метода sendEmailVerificationWithCompletion:. Пример:
Swift
Auth.auth().currentUser?.sendEmailVerification { error in // ... }
Objective-C
[[FIRAuth auth].currentUser sendEmailVerificationWithCompletion:^(NSError *_Nullable error) { // ... }];
Вы можете выбрать шаблон электронного письма на вкладке Безопасность > Аутентификация > Шаблоны в консоли Firebase. Подробнее о шаблонах электронных писем в Справочном центре Firebase.
Также можно передавать состояние через URL продолжения, чтобы перенаправлять пользователя обратно в приложение при отправке письма с подтверждением.
Кроме того, вы можете локализовать письмо с подтверждением, обновив код языка в экземпляре Auth перед отправкой письма. Пример:
Swift
Auth.auth().languageCode = "fr" // To apply the default app language instead of explicitly setting it. // Auth.auth().useAppLanguage()
Objective-C
[FIRAuth auth].languageCode = @"fr"; // To apply the default app language instead of explicitly setting it. // [[FIRAuth auth] useAppLanguage];
Как задать пароль пользователя
Вы можете задать пароль пользователя с помощью метода updatePassword. Пример:
Swift
Auth.auth().currentUser?.updatePassword(to: password) { error in // ... }
Objective-C
[[FIRAuth auth].currentUser updatePassword:userInput completion:^(NSError *_Nullable error) { // ... }];
Отправка письма для сброса пароля
Вы можете отправить пользователю электронное письмо для сброса пароля с помощью метода sendPasswordReset. Пример:
Swift
Auth.auth().sendPasswordReset(withEmail: email) { error in // ... }
Objective-C
[[FIRAuth auth] sendPasswordResetWithEmail:userInput completion:^(NSError *_Nullable error) { // ... }];
Вы можете настроить шаблон электронного письма, который используется в разделе "Аутентификация" консоли Firebase, на странице "Шаблоны электронных писем". Подробнее о шаблонах электронных писем в Справочном центре Firebase.
Также можно передавать состояние через URL продолжения, чтобы перенаправлять пользователя обратно в приложение при отправке письма для сброса пароля.
Кроме того, вы можете локализовать письмо для сброса пароля, обновив код языка в экземпляре Auth перед отправкой письма. Пример:
Swift
Auth.auth().languageCode = "fr" // To apply the default app language instead of explicitly setting it. // Auth.auth().useAppLanguage()
Objective-C
[FIRAuth auth].languageCode = @"fr"; // To apply the default app language instead of explicitly setting it. // [[FIRAuth auth] useAppLanguage];
Вы также можете отправлять письма для сброса пароля из консоли Firebase.
Удаление пользователя
Удалить аккаунт пользователя можно с помощью метода delete. Пример:
Swift
let user = Auth.auth().currentUser
user?.delete { error in
if let error = error {
// An error happened.
} else {
// Account deleted.
}
}
Objective-C
FIRUser *user = [FIRAuth auth].currentUser;
[user deleteWithCompletion:^(NSError *_Nullable error) {
if (error) {
// An error happened.
} else {
// Account deleted.
}
}];
Вы также можете удалить пользователей в консоли Firebase на вкладке Безопасность > Аутентификация > Пользователи.
Как повторно аутентифицировать пользователя
Для выполнения некоторых действий, связанных с безопасностью, например удаления аккаунта, установки основного адреса электронной почты и изменения пароля, требуется, чтобы пользователь недавно входил в аккаунт. Если вы выполните одно из этих действий, а пользователь вошел в систему слишком давно, действие завершится ошибкой FIRAuthErrorCodeCredentialTooOld. В этом случае повторно аутентифицируйте пользователя, получив от него новые учетные данные и передав их в reauthenticate. Пример:
Swift
let user = Auth.auth().currentUser
var credential: AuthCredential
// Prompt the user to re-provide their sign-in credentials
user?.reauthenticate(with: credential) { error in
if let error = error {
// An error happened.
} else {
// User re-authenticated.
}
}
Objective-C
FIRUser *user = [FIRAuth auth].currentUser;
FIRAuthCredential *credential;
// Prompt the user to re-provide their sign-in credentials
[user reauthenticateWithCredential:credential completion:^(NSError *_Nullable error) {
if (error) {
// An error happened.
} else {
// User re-authenticated.
}
}];
Импорт аккаунтов пользователей
Вы можете импортировать аккаунты пользователей из файла в проект Firebase с помощью команды auth:import интерфейса командной строки Firebase. Пример:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14