Memulai Firebase Authentication di Apple Platform

Anda dapat menggunakan Firebase Authentication untuk mengizinkan pengguna login ke aplikasi Anda menggunakan satu atau beberapa metode login, termasuk login dengan alamat email dan sandi, serta penyedia identitas gabungan seperti Login dengan Google dan Login dengan Facebook. Tutorial ini akan memandu Anda memulai Firebase Authentication dengan menunjukkan cara menambahkan login dengan alamat email dan sandi ke aplikasi Anda.

Menghubungkan aplikasi ke Firebase

Instal Firebase SDK.
Di Firebase console, tambahkan aplikasi Anda ke project Firebase.

Menambahkan Firebase Authentication ke aplikasi

Catatan: Sebaiknya gunakan CocoaPods untuk menginstal library Firebase. Jika memilih menyiapkan Firebase menggunakan Swift Package Manager, Anda dapat mengabaikan langkah-langkah terkait CocoaPods seperti mengubah Podfile dan menjalankan perintah pod.

Tambahkan dependensi untuk Firebase Authentication ke Podfile project Anda:
```
pod 'Firebase/Auth'
```
Jalankan pod install, lalu buka file .xcworkspace yang dihasilkan.

(Opsional) Membuat prototipe dan melakukan pengujian dengan Firebase Local Emulator Suite

Sebelum membahas cara aplikasi Anda mengautentikasi pengguna, kami akan memperkenalkan serangkaian alat yang dapat digunakan untuk membuat prototipe dan menguji fungsionalitas Authentication: Firebase Local Emulator Suite. Jika sedang memilih teknik dan penyedia autentikasi, sedang mencoba berbagai model data dengan data publik dan pribadi menggunakan Authentication dan Aturan Keamanan Firebase, atau sedang membuat prototipe desain UI login, akan sangat bermanfaat jika Anda bisa bekerja secara lokal tanpa men-deploy layanan langsung.

Emulator Authentication adalah bagian dari Local Emulator Suite, yang memungkinkan aplikasi Anda berinteraksi dengan konten dan konfigurasi database teremulasi, serta, jika diinginkan, dengan resource project teremulasi (fungsi, database lain, dan aturan keamanan).

Hanya diperlukan beberapa langkah untuk menggunakan emulator Authentication:

Menambahkan satu baris kode ke konfigurasi pengujian aplikasi untuk menghubungkannya ke emulator.
Menjalankan firebase emulators:start dari root direktori project lokal Anda.
Menggunakan UI Local Emulator Suite untuk pembuatan prototipe interaktif, atau REST API emulator Authentication untuk pengujian noninteraktif.

Panduan terperinci tersedia di bagian Menghubungkan aplikasi Anda ke emulator Authentication. Untuk informasi selengkapnya, lihat Pengantar Local Emulator Suite.

Sekarang, mari kita lanjutkan dengan cara mengautentikasi pengguna.

Menginisialisasi Firebase SDK

Dalam delegasi aplikasi, impor Firebase SDK terlebih dahulu:

Swift

import FirebaseAppDelegate.swift

Objective-C

@import Firebase;AppDelegate.m

Kemudian, pada metode application:didFinishLaunchingWithOptions:, inisialisasi objek FirebaseApp:

Swift

// Use Firebase library to configure APIs
FirebaseApp.configure()AppDelegate.swift

Objective-C

// Use Firebase library to configure APIs
[FIRApp configure];AppDelegate.m

Memproses status autentikasi

Untuk setiap tampilan aplikasi yang membutuhkan informasi tentang pengguna yang login, tambahkan pemroses ke objek FIRAuth. Pemroses ini akan dipanggil setiap kali status login pengguna berubah.

Tambahkan pemroses dalam metode viewWillAppear pengontrol tampilan:

Swift

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

Objective-C

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

Selanjutnya lepaskan pemroses dalam metode viewWillDisappear pengontrol tampilan:

Swift

Auth.auth().removeStateDidChangeListener(handle!)MainViewController.swift

Objective-C

[[FIRAuth auth] removeAuthStateDidChangeListener:_handle];MainViewController.m

Mendaftarkan pengguna baru

Buat formulir yang dapat dipakai pengguna baru untuk mendaftar ke aplikasi Anda menggunakan alamat email dan sandi. Saat pengguna selesai mengisi formulir, validasikan alamat email dan sandi yang diberikan oleh pengguna, lalu teruskan ke metode createUser:

Swift

Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
  // ...
}EmailViewController.swift

Objective-C

[[FIRAuth auth] createUserWithEmail:email
                           password:password
                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
  // ...
}];EmailViewController.m

Memproses login pengguna yang ada

Buat formulir yang dapat dipakai pengguna yang ada untuk login menggunakan alamat email dan sandinya. Saat pengguna selesai mengisi formulir, panggil metode signIn:

Swift

Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
  guard let strongSelf = self else { return }
  // ...
}EmailViewController.swift

Objective-C

[[FIRAuth auth] signInWithEmail:self->_emailField.text
                       password:self->_passwordField.text
                     completion:^(FIRAuthDataResult * _Nullable authResult,
                                  NSError * _Nullable error) {
  // ...
}];EmailViewController.m

Mendapatkan informasi pengguna

Setelah pengguna berhasil login, Anda bisa mendapatkan informasi tentang pengguna. Misalnya, dalam pemroses status autentikasi Anda:

Swift

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 += " "
  }
  // ...
}MainViewController.swift

Objective-C

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;
  // ...
}MainViewController.m

Langkah berikutnya

Pelajari cara menambahkan dukungan untuk penyedia identitas lainnya dan akun tamu anonim: