Buka konsol

Mengelola Pengguna di Firebase

Membuat pengguna

Anda dapat membuat pengguna baru dalam project Firebase dengan memanggil metode createUserWithEmail:password:completion: atau dengan membuat 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.

Mengetahui pengguna yang sedang login

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

Swift

handle = Auth.auth().addStateDidChangeListener { (auth, user) in
  // ...
}

Objective-C

self.handle = [[FIRAuth auth]
    addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) {
      // ...
    }];

Dengan menggunakan listener, Anda memastikan bahwa objek Auth tidak dalam status pemrosesan—seperti inisialisasi—saat Anda mencari tahu pengguna saat ini.

Anda juga bisa mengetahui pengguna yang sedang login dengan menggunakan properti currentUser. Jika pengguna tidak login, currentUser akan bernilai nol:

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.
  // ...
}

Memperoleh profil pengguna

Untuk memperoleh informasi profil pengguna, gunakan properti instance FIRUser. Misalnya:

Swift

let user = Auth.auth().currentUserif 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
  // ...
}

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 *uid = user.uid;
  NSString *email = user.email;
  NSURL *photoURL = user.photoURL;
  // ...
}

Memperoleh informasi profil khusus-penyedia yang terhubung dengan pengguna

Untuk memperoleh informasi profil yang diambil dari penyedia proses login yang terhubung dengan pengguna, gunakan properti providerData. Misalnya:

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

Mengupdate profil pengguna

Anda bisa mengupdate informasi profil dasar pengguna—yaitu nama tampilan dan URL foto profil pengguna—dengan class FIRUserProfileChangeRequest. Misalnya:

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) {
  // ...
}];

Menetapkan alamat email pengguna

Anda dapat menetapkan alamat email pengguna dengan metode updateEmail:completion:. Misalnya:

Swift

Auth.auth().currentUser?.updateEmail(to: email) { (error) in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser updateEmail:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

Mengirim email verifikasi kepada pengguna

Anda dapat mengirim email verifikasi alamat kepada pengguna dengan metode sendEmailVerificationWithCompletion:. Misalnya:

Swift

Auth.auth().currentUser?.sendEmailVerification { (error) in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser sendEmailVerificationWithCompletion:^(NSError *_Nullable error) {
  // ...
}];

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 dapat meneruskan status melalui continue URL untuk mengalihkannya kembali ke aplikasi tersebut ketika mengirim email verifikasi.

Selain itu, Anda dapat melokalkan email verifikasi dengan memperbarui kode bahasa pada instance Auth sebelum mengirim email. Misalnya:

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

Menetapkan sandi pengguna

Anda bisa menetapkan sandi pengguna dengan metode updatePassword:completion:. Misalnya:

Swift

Auth.auth().currentUser?.updatePassword(to: password) { (error) in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser updatePassword:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

Mengirim email setel ulang sandi

Anda dapat mengirim email setel ulang sandi kepada pengguna dengan metode sendPasswordResetWithEmail:completion:. Misalnya:

Swift

Auth.auth().sendPasswordReset(withEmail: email) { error in
  // ...
}

Objective-C

[[FIRAuth auth] sendPasswordResetWithEmail:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

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 meneruskan status melalui continue URL untuk mengalihkan kembali ke aplikasi tersebut ketika mengirim email setel ulang sandi.

Selain itu, Anda dapat melokalkan email setel ulang sandi dengan memperbarui kode bahasa pada instance Auth sebelum mengirim email. Misalnya:

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

Anda juga bisa mengirim email setel ulang sandi dari Firebase console.

Menghapus pengguna

Anda bisa menghapus akun pengguna dengan metode deleteWithCompletion. Misalnya:

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

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 primer, 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 dengan error FIRAuthErrorCodeCredentialTooOld. Jika hal ini terjadi, lakukan autentikasi ulang pengguna dengan mendapatkan kredensial login baru dari pengguna dan meneruskan kredensial tersebut ke reauthenticate. Misalnya:

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

Mengimpor akun pengguna

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

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