Управление пользователями в Firebase

Создать пользователя

Вы создаете нового пользователя в своем проекте Firebase, вызывая метод CreateUserWithEmailAndPassword или впервые входя в систему с помощью федеративного поставщика удостоверений, такого как Google Sign-In или Facebook Login .

Вы также можете создавать новых пользователей, аутентифицированных паролем, в разделе «Аутентификация» консоли Firebase на странице «Пользователи».

Получить текущего вошедшего в систему пользователя

Рекомендуемый способ получить текущего пользователя — установить прослушиватель для объекта Auth:

Firebase.Auth.FirebaseAuth auth;
Firebase.Auth.FirebaseUser user;

// Handle initialization of the necessary firebase modules:
void InitializeFirebase() {
  Debug.Log("Setting up Firebase Auth");
  auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
  auth.StateChanged += AuthStateChanged;
  AuthStateChanged(this, null);
}

// Track state changes of the auth object.
void AuthStateChanged(object sender, System.EventArgs eventArgs) {
  if (auth.CurrentUser != user) {
    bool signedIn = user != auth.CurrentUser && auth.CurrentUser != null;
    if (!signedIn && user != null) {
      Debug.Log("Signed out " + user.UserId);
    }
    user = auth.CurrentUser;
    if (signedIn) {
      Debug.Log("Signed in " + user.UserId);
    }
  }
}

// Handle removing subscription and reference to the Auth instance.
// Automatically called by a Monobehaviour after Destroy is called on it.
void OnDestroy() {
  auth.StateChanged -= AuthStateChanged;
  auth = null;
}

Используя прослушиватель, вы гарантируете, что объект Auth не находится в промежуточном состоянии (например, при инициализации) при получении текущего пользователя.

Вы также можете получить текущего пользователя, выполнившего вход, вызвав CurrentUser . Если пользователь не вошел в систему, CurrentUser вернет значение null. Если пользователь вышел из системы, IsValid() пользователя вернет false.

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

Сохранение учетных данных пользователя

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

• Платформы Apple: Службы связки ключей .
• Android: хранилище ключей Android .
• Windows: API управления учетными данными .
• OS X: Службы связки ключей .
• Linux: libsecret , который должен быть установлен пользователем.

Получить профиль пользователя

Чтобы получить информацию о профиле пользователя, используйте методы доступа экземпляра Firebase.Auth.FirebaseUser . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  string name = user.DisplayName;
  string email = user.Email;
  System.Uri photo_url = user.PhotoUrl;
  // 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 User.TokenAsync() instead.
  string uid = user.UserId;
}

Получите информацию о профиле пользователя, зависящую от поставщика услуг.

Чтобы получить информацию профиля, полученную от поставщиков входа, связанных с пользователем, используйте метод ProviderData . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  foreach (var profile in user.ProviderData) {
    // Id of the provider (ex: google.com)
    string providerId = profile.ProviderId;

    // UID specific to the provider
    string uid = profile.UserId;

    // Name, email address, and profile photo Url
    string name = profile.DisplayName;
    string email = profile.Email;
    System.Uri photoUrl = profile.PhotoUrl;
  }
}

Обновить профиль пользователя

Вы можете обновить основную информацию профиля пользователя — отображаемое имя пользователя и URL-адрес фотографии профиля — с помощью метода UpdateUserProfile . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  Firebase.Auth.UserProfile profile = new Firebase.Auth.UserProfile {
    DisplayName = "Jane Q. User",
    PhotoUrl = new System.Uri("https://example.com/jane-q-user/profile.jpg"),
  };
  user.UpdateUserProfileAsync(profile).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdateUserProfileAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdateUserProfileAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User profile updated successfully.");
  });
}

Установить адрес электронной почты пользователя

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

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.UpdateEmailAsync("[e-mail]").ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdateEmailAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdateEmailAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User email updated successfully.");
  });
}

Важно: Чтобы установить адрес электронной почты пользователя, он должен недавно войти в систему. См. Повторная аутентификация пользователя .

Отправить пользователю письмо с подтверждением

Вы можете отправить электронное письмо с подтверждением адреса пользователю с помощью метода SendEmailVerification . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.SendEmailVerificationAsync().ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("SendEmailVerificationAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("SendEmailVerificationAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Email sent successfully.");
  });
}

Вы можете настроить шаблон электронной почты, который используется в разделе «Аутентификация» консоли Firebase на странице «Шаблоны электронной почты». См. Шаблоны электронной почты в Справочном центре Firebase.

Установить пароль пользователя

Вы можете установить пароль пользователя с помощью метода UpdatePassword . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
string newPassword = "SOME-SECURE-PASSWORD";
if (user != null) {
  user.UpdatePasswordAsync(newPassword).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("UpdatePasswordAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("UpdatePasswordAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Password updated successfully.");
  });
}

Важно: Чтобы установить пароль пользователя, пользователь должен недавно войти в систему. См. Повторная аутентификация пользователя .

Отправить электронное письмо для сброса пароля

Вы можете отправить электронное письмо для сброса пароля пользователю с помощью метода SendPasswordResetEmail . Например:

string emailAddress = "[e-mail]";
if (user != null) {
  auth.SendPasswordResetEmailAsync(emailAddress).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("SendPasswordResetEmailAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("SendPasswordResetEmailAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("Password reset email sent successfully.");
  });
}

Вы можете настроить шаблон электронной почты, который используется в разделе «Аутентификация» консоли Firebase на странице «Шаблоны электронной почты». См. Шаблоны электронной почты в Справочном центре Firebase.

Вы также можете отправлять электронные письма для сброса пароля из консоли Firebase .

Удаление пользователя

Вы можете удалить учетную запись пользователя с помощью метода Delete . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.DeleteAsync().ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("DeleteAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("DeleteAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User deleted successfully.");
  });
}

Важно: Чтобы удалить пользователя, он должен недавно войти в систему. См. Повторная аутентификация пользователя .

Вы также можете удалить пользователей из раздела «Аутентификация» консоли Firebase на странице «Пользователи».

Повторная аутентификация пользователя

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

В этом случае повторите аутентификацию пользователя, получив от пользователя новые учетные данные для входа и передав их в Reauthenticate . Например:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
Firebase.Auth.Credential credential =
    Firebase.Auth.EmailAuthProvider.GetCredential("[e-mail]", "password1234");

if (user != null) {
  user.ReauthenticateAsync(credential).ContinueWith(task => {
    if (task.IsCanceled) {
      Debug.LogError("ReauthenticateAsync was canceled.");
      return;
    }
    if (task.IsFaulted) {
      Debug.LogError("ReauthenticateAsync encountered an error: " + task.Exception);
      return;
    }

    Debug.Log("User reauthenticated successfully.");
  });
}

Импортировать учетные записи пользователей

Вы можете импортировать учетные записи пользователей из файла в свой проект Firebase с помощью команды auth:import в интерфейсе командной строки Firebase. Например:

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14