Zarządzaj użytkownikami w Firebase

Tworzenie konta użytkownika

Tworzysz nowego użytkownika w projekcie Firebase, wywołując metodę CreateUserWithEmailAndPassword lub przez zalogowanie użytkownika po raz pierwszy przy użyciu tożsamości sfederowanej dostawcy, takiego jak Logowanie przez Google, Logowanie do Facebooka.

Nowych użytkowników z uwierzytelnianiem za pomocą hasła możesz też utworzyć na stronie w konsoli Firebase, na stronie Użytkownicy.

Pobierz informacje o zalogowanym użytkowniku

Zalecanym sposobem na uzyskanie bieżącego użytkownika jest ustawienie detektora Obiekt 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;
}

Dzięki użyciu detektora masz pewność, że obiekt Auth nie jest w trybie pośrednim (np. inicjalizację) po otrzymaniu bieżącego użytkownika.

Możesz też skontaktować się z zalogowanym użytkownikiem, dzwoniąc pod numer CurrentUser. Jeśli Użytkownik nie jest zalogowany, CurrentUser zwraca wartość null. Jeśli użytkownik jest niezalogowany, IsValid() użytkownika zwróci wartość fałsz.

Zachowywanie danych logowania użytkownika

Dane logowania użytkownika zostaną zapisane w lokalnym magazynie kluczy, gdy użytkownik Użytkownik jest zalogowany. Lokalną pamięć podręczną danych logowania użytkownika można usunąć, podpisując użytkownika. Magazyn kluczy jest związany z konkretną platformą:

Pobieranie profilu użytkownika

Aby uzyskać informacje o profilu użytkownika, użyj metod akcesora instancji Firebase.Auth.FirebaseUser Przykład:

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

Uzyskiwanie informacji o profilu użytkownika specyficznych dla dostawcy

Aby pobrać informacje profilowe pobrane od dostawców logowania połączonych z użytkownika, należy użyć metody ProviderData. Przykład:

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

Aktualizowanie profilu użytkownika

Możesz aktualizować podstawowe informacje o profilu użytkownika – jego wyświetlaną nazwę. i adresu URL zdjęcia profilowego, używając metody UpdateUserProfile. Przykład:

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.");
  });
}

Ustawianie adresu e-mail użytkownika

Adres e-mail użytkownika możesz skonfigurować za pomocą metody UpdateEmail. Przykład:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  user.UpdateEmailAsync("user@example.com").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.");
  });
}

Wysyłanie e-maila weryfikacyjnego do użytkownika

Możesz wysłać e-maila weryfikacyjnego do użytkownika z Metoda SendEmailVerification. Przykład:

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.");
  });
}

Możesz dostosować szablon e-maila używany w sekcji Uwierzytelnianie w konsoli Firebase, na stronie Szablony e-maili. Zobacz Szablony e-maili w Centrum pomocy Firebase.

Ustawianie hasła użytkownika

Hasło użytkownika możesz ustawić za pomocą metody UpdatePassword. Przykład:

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.");
  });
}
.

Wyślij e-maila do resetowania hasła

Możesz wysłać e-maila do resetowania hasła do użytkownika, który korzysta z: SendPasswordResetEmail . Przykład:

string emailAddress = "user@example.com";
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.");
  });
}

Możesz dostosować szablon e-maila używany w sekcji Uwierzytelnianie w konsoli Firebase, na stronie Szablony e-maili. Zobacz Szablony e-maili w Centrum pomocy Firebase.

Możesz też wysyłać e-maile dotyczące resetowania hasła za pomocą konsoli Firebase.

Usuwanie konta użytkownika

Konto użytkownika możesz usunąć za pomocą metody Delete. Przykład:

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.");
  });
}
.

Użytkowników możesz też usuwać z sekcji Uwierzytelnianie Firebase na stronie Użytkownicy.

Ponowne uwierzytelnianie użytkownika

Niektóre działania związane z bezpieczeństwem, takie jak: usunięciu konta, ustawienie głównego adresu e-mail oraz zmianę hasła – użytkownik musi mieć niedawno się zalogowałeś(-aś). Jeśli wykonasz jedną z tych czynności, a użytkownik się zaloguje dawno temu, działanie nie powiedzie się.

W takim przypadku ponownie uwierzytelnij użytkownika, uzyskując nowe dane logowania. od użytkownika i przekazując dane logowania do usługi Reauthenticate. Przykład:

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("user@example.com", "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.");
  });
}

Importowanie kont użytkowników

Konta użytkowników możesz importować z pliku do projektu Firebase za pomocą Polecenie auth:import w interfejsie wiersza poleceń Firebase. Przykład:

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