Mengelola Pengguna dalam Firebase

Membuat pengguna

Anda membuat pengguna baru di project Firebase dengan memanggil metode CreateUserWithEmailAndPassword atau dengan membuat agar pengguna login untuk pertama kalinya menggunakan penyedia identitas gabungan, seperti Login dengan Google atau Login dengan Facebook.

Anda juga dapat membuat pengguna baru yang diautentikasi dengan sandi dari bagian Authentication pada Firebase console di halaman Pengguna.

Memperoleh pengguna yang sedang login

Cara yang direkomendasikan untuk mengetahui pengguna saat ini adalah dengan menetapkan pemroses pada objek Auth:

class MyAuthStateListener : public firebase::auth::AuthStateListener {
 public:
  void OnAuthStateChanged(firebase::auth::Auth* auth) override {
    firebase::auth::User user = auth->current_user();
    if (user.is_valid()) {
      // User is signed in
      printf("OnAuthStateChanged: signed_in %s\n", user.uid().c_str());
    } else {
      // User is signed out
      printf("OnAuthStateChanged: signed_out\n");
    }
    // ...
  }
};
// ... initialization code
// Test notification on registration.
MyAuthStateListener state_change_listener;
auth->AddAuthStateListener(&state_change_listener);

Dengan menggunakan pemroses, Anda memastikan bahwa objek Auth tidak dalam status pemrosesan, misalnya inisialisasi, saat Anda mencari tahu pengguna saat ini.

Anda juga bisa mengetahui pengguna yang login saat ini dengan memanggil current_user. Jika tidak ada pengguna yang login, metode is_valid pengguna akan menampilkan nilai yang salah.

Mempertahankan kredensial pengguna

Kredensial pengguna akan disimpan di keystore lokal setelah pengguna login. Cache lokal kredensial pengguna dapat dihapus dengan membuat pengguna logout. Keystore ini khusus platform:

Platform Apple: Keychain Services.
Android: Android Keystore.
Windows: Credential Management API.
OS X: Keychain Services.
Linux: libsecret, yang harus telah diinstal pengguna.

Memperoleh profil pengguna

Untuk memperoleh informasi profil pengguna, gunakan metode pengakses instance firebase::auth::User. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  std::string name = user.display_name();
  std::string email = user.email();
  std::string photo_url = user.photo_url();
  // 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 firebase::auth::User::Token() instead.
  std::string uid = user.uid();
}

Memperoleh informasi profil pengguna terkait penyedia tertentu

Untuk memperoleh informasi profil yang diambil dari penyedia login yang ditautkan kepada pengguna, gunakan metode ProviderData. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  for (auto it = user.provider_data().begin();
       it != user.provider_data().end(); ++it) {
    firebase::auth::UserInfoInterface profile = *it;
    // Id of the provider (ex: google.com)
    std::string providerId = profile.provider_id();

    // UID specific to the provider
    std::string uid = profile.uid();

    // Name, email address, and profile photo Url
    std::string name = profile.display_name();
    std::string email = profile.email();
    std::string photoUrl = profile.photo_url();
  }
}

Memperbarui profil pengguna

Anda dapat memperbarui informasi profil dasar pengguna, yaitu nama tampilan pengguna dan URL foto profil, dengan metode UpdateUserProfile. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  firebase::auth::User::UserProfile profile;
  profile.display_name = "Jane Q. User";
  profile.photo_url = "https://example.com/jane-q-user/profile.jpg";
  user.UpdateUserProfile(profile).OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        // We are probably in a different thread right now.
        if (completed_future.error() == 0) {
          printf("User profile updated.");
        }
      },
      nullptr);  // pass user_data here.
}

Menyetel alamat email pengguna

Anda dapat menyetel alamat email pengguna dengan metode UpdateEmail. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.UpdateEmail("user@example.com")
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            // We are probably in a different thread right now.
            if (completed_future.error() == 0) {
              printf("User email address updated.");
            }
          },
          nullptr);
}

Mengirim email verifikasi kepada pengguna

Anda dapat mengirim email verifikasi alamat kepada pengguna dengan metode SendEmailVerification. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.SendEmailVerification().OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        // We are probably in a different thread right now.
        if (completed_future.error() == 0) {
          printf("Email sent.");
        }
      },
      nullptr);
}

Anda dapat menyesuaikan template email yang digunakan di bagian Authentication pada Firebase console, di halaman Template Email. Lihat Template Email di Pusat Bantuan Firebase.

Menyetel sandi pengguna

Anda dapat menyetel sandi pengguna dengan metode UpdatePassword. Contoh:

firebase::auth::User user = auth->current_user();
std::string newPassword = "SOME-SECURE-PASSWORD";

if (user.is_valid()) {
  user.UpdatePassword(newPassword.c_str())
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            // We are probably in a different thread right now.
            if (completed_future.error() == 0) {
              printf("password updated.");
            }
          },
          nullptr);
}

Mengirim email reset sandi

Anda dapat mengirim email reset sandi kepada pengguna dengan metode SendPasswordResetEmail. Contoh:

std::string emailAddress = "user@example.com";

auth->SendPasswordResetEmail(emailAddress.c_str())
    .OnCompletion(
        [](const firebase::Future<void>& completed_future,
           void* user_data) {
          // We are probably in a different thread right now.
          if (completed_future.error() == 0) {
            // Email sent.
          } else {
            // An error happened.
            printf("Error %d: %s", completed_future.error(),
                   completed_future.error_message());
          }
        },
        nullptr);

Anda dapat menyesuaikan template email yang digunakan di bagian Authentication pada Firebase console, di halaman Template Email. Lihat Template Email di Pusat Bantuan Firebase.

Anda juga bisa mengirim email reset sandi dari Firebase console.

Menghapus pengguna

Anda dapat menghapus akun pengguna dengan metode Delete. Contoh:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.Delete().OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        if (completed_future.error() == 0) {
          // User deleted.
        } else {
          // An error happened.
          printf("Error %d: %s", completed_future.error(),
                 completed_future.error_message());
        }
      },
      nullptr);
}

Anda juga bisa menghapus pengguna dari bagian Authentication pada Firebase console, di halaman Pengguna.

Mengautentikasi ulang pengguna

Beberapa tindakan yang rentan terhadap ancaman keamanan, seperti menghapus akun, menetapkan alamat email utama, dan mengubah sandi mengharuskan pengguna untuk pernah login baru-baru ini. Jika Anda melakukan salah satu tindakan ini dan sudah cukup lama sejak pengguna terakhir kali login, tindakan tersebut akan gagal.

Jika hal ini terjadi, autentikasi ulang pengguna dengan mendapatkan kredensial login baru dari pengguna tersebut dan meneruskan kredensial ke Reauthenticate. Contoh:

firebase::auth::User user = auth->current_user();

// 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.is_valid()) {
  user.Reauthenticate(credential)
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            if (completed_future.error() == 0) {
              printf("User re-authenticated.");
            }
          },
          nullptr);
}

Mengimpor akun pengguna

Anda dapat mengimpor akun pengguna dari file ke project Firebase menggunakan perintah auth:import Firebase CLI. Contoh:

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