Buka konsol

Melakukan Autentikasi dengan Firebase menggunakan Nomor Telepon pada Unity

Anda dapat menggunakan Firebase Authentication untuk membuat pengguna login dengan mengirim pesan SMS ke ponselnya. Selanjutnya, pengguna login menggunakan kode sekali pakai yang dikirimkan dalam pesan SMS.

Dokumen ini berisi penjelasan mengenai cara mengimplementasikan proses login dengan nomor telepon menggunakan Firebase SDK.

Sebelum memulai

  1. Sebelum dapat menggunakan Firebase Authentication, Anda perlu menambahkan Firebase Unity SDK (khususnya, FirebaseAuth.unitypackage) ke project Unity yang dimiliki.

    Temukan petunjuk detail seputar langkah-langkah penyiapan awal ini di Menambahkan Firebase ke project Unity Anda.

  2. Jika Anda belum menghubungkan aplikasi ke project Firebase, lakukanlah dari Firebase console.

Pada iOS, harap diperhatikan bahwa login dengan nomor telepon memerlukan perangkat fisik dan tidak akan berfungsi pada simulator.

Masalah keamanan

Autentikasi hanya melalui nomor telepon, meski nyaman, kurang aman dibandingkan metode lain yang tersedia, karena nomor tersebut dapat berpindah tangan antara pengguna dengan mudah. Selain itu, pada perangkat yang memuat beberapa profil pengguna, setiap pengguna yang dapat menerima pesan SMS dapat login ke akun menggunakan nomor telepon perangkat tersebut.

Jika Anda menggunakan fitur login dengan nomor telepon di aplikasi, Anda harus menawarkannya bersama metode login yang lebih aman, dan memberi tahu pengguna tentang kelemahan keamanan jika menggunakan metode login dengan nomor telepon.

Mengaktifkan login dengan Nomor Telepon untuk project Firebase

Untuk membuat pengguna login melalui SMS, Anda harus mengaktifkan metode login dengan Nomor Telepon untuk project Firebase terlebih dahulu:

  1. Di Firebase console, buka bagian Authentication.
  2. Di halaman Metode Login, aktifkan metode login dengan Nomor Telepon.

Kuota permintaan login dengan nomor telepon di Firebase cukup tinggi, sehingga sebagian besar aplikasi tidak akan terpengaruh. Namun, jika Anda perlu membuat banyak sekali pengguna login dengan autentikasi telepon, Anda mungkin harus mengupgrade paket harga. Lihat halaman harga.

Mulai menerima notification APN (khusus iOS)

Untuk menggunakan autentikasi nomor telepon di iOS, aplikasi Anda harus dapat menerima notification APN dari Firebase. Saat Anda membuat pengguna login dengan nomor teleponnya untuk pertama kalinya di perangkat, Firebase Authentication akan mengirimkan push notification diam ke perangkat untuk memverifikasi bahwa permintaan login dengan nomor telepon tersebut berasal dari aplikasi Anda. (Karena alasan inilah, metode login dengan nomor telepon tidak dapat digunakan pada simulator.)

Untuk mengaktifkan notification APN agar dapat digunakan dengan Firebase Authentication:

  1. Di Xcode, aktifkan notifikasi push untuk project Anda.
  2. Upload sertifikat APN Anda ke Firebase. Jika Anda belum memiliki sertifikat APN, lihat Menyediakan Sertifikat SSL APN.

    1. Di dalam project Anda dalam Firebase console, pilih ikon roda gigi, pilih Setelan Project, kemudian pilih tab Cloud Messaging.

    2. Pilih tombol Upload Sertifikat untuk sertifikat development, sertifikat produksi, atau keduanya. Anda harus memilih setidaknya satu dari keduanya.

    3. Untuk masing-masing sertifikat, pilih file .p12, dan masukkan sandi jika ada. Pastikan ID paket untuk sertifikat ini cocok dengan ID paket dari aplikasi Anda. Pilih Simpan.

Mengirim kode verifikasi ke ponsel pengguna

Untuk memulai metode login dengan nomor telepon, perlihatkan antarmuka yang akan meminta pengguna untuk memasukkan nomor teleponnya, lalu panggil PhoneAuthProvider.VerifyPhoneNumber untuk meminta Firebase agar mengirimkan kode autentikasi ke ponsel pengguna melalui SMS:

  1. Dapatkan nomor telepon pengguna.

    Persyaratan hukum dapat berbeda-beda, namun sebagai praktik terbaik dan untuk menetapkan ekspektasi bagi pengguna, sebaiknya beri tahukan bahwa jika mereka menggunakan metode login melalui ponsel, mereka akan menerima pesan SMS untuk verifikasi dan tarif standar berlaku.

  2. Panggil PhoneAuthProvider.VerifyPhoneNumber, lalu teruskan ke nomor telepon pengguna.
    PhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth);
    provider.VerifyPhoneNumber(phoneNumber, phoneAuthTimeoutMs, null,
      verificationCompleted: (credential) =&gt {
        // Auto-sms-retrieval or instant validation has succeeded (Android only).
        // There is no need to input the verification code.
        // `credential` can be used instead of calling GetCredential().
      },
      verificationFailed: (error) =&gt {
        // The verification code was not sent.
        // `error` contains a human readable explanation of the problem.
      },
      codeSent: (id, token) =&gt {
        // Verification code was successfully sent via SMS.
        // `id` contains the verification id that will need to passed in with
        // the code from the user when calling GetCredential().
        // `token` can be used if the user requests the code be sent again, to
        // tie the two requests together.
      },
      codeAutoRetrievalTimeout: (id) =&gt {
        // Called when the auto-sms-retrieval has timed out, based on the given
        // timeout parameter.
        // `id` contains the verification id of the request that timed out.
      });
    
    Saat Anda memanggil PhoneAuthProvider.VerifyPhoneNumber, Firebase,
    • (di iOS), mengirimkan push notification diam ke aplikasi Anda.
    • Firebase akan mengirimkan pesan SMS yang berisi kode autentikasi ke nomor telepon yang ditentukan dan meneruskan ID verifikasi ke fungsi penyelesaian Anda. Baik kode verifikasi maupun ID verifikasi diperlukan untuk membuat pengguna login.
  3. Simpan ID verifikasi dan pulihkan saat aplikasi dimuat. Dengan begitu, dapat dipastikan bahwa Anda masih memiliki ID verifikasi valid jika aplikasi dihentikan sebelum pengguna menyelesaikan proses login (misalnya, saat beralih ke aplikasi SMS).

    Anda dapat mempertahankan ID verifikasi dengan cara apa pun sesuai keinginan. Cara mudahnya adalah dengan menyimpan ID verifikasi dengan UnityEngine.PlayerPrefs.

Jika callback yang diteruskan ke codeSent dipanggil, Anda dapat meminta pengguna untuk mengetik kode verifikasi yang mereka terima dalam pesan SMS.

Di sisi lain, jika callback untuk verificationCompleted dipanggil, maka verifikasi otomatis telah berhasil. Sekarang Anda akan memiliki Credential yang dapat digunakan seperti dijelaskan di bawah ini.

Membuat pengguna login dengan kode verifikasi

Setelah pengguna memasukkan kode verifikasi yang diterima melalui SMS ke aplikasi Anda, buat agar ia login dengan membuat objek Credential dari kode dan ID verifikasi, lalu teruskan objek tersebut ke FirebaseAuth.SignInWithCredential.

  1. Dapatkan kode verifikasi dari pengguna.
  2. Buat objek Credential dari kode dan ID verifikasi.
    Credential credential =
        phoneAuthProvider.GetCredential(verificationId, verificationCode);
        
  3. Buat pengguna login dengan objek Credential:
    auth.SignInWithCredentialAsync(credential).ContinueWith(task =&gt {
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCredentialAsync encountered an error: " +
                       task.Exception);
        return;
      }
    
      FirebaseUser newUser = task.Result;
      Debug.Log("User signed in successfully");
      // This should display the phone number.
      Debug.Log("Phone number: " + newUser.PhoneNumber);
      // The phone number providerID is 'phone'.
      Debug.Log("Phone provider ID: " + newUser.ProviderId);
    });
    

Langkah berikutnya

Setelah pengguna login untuk pertama kalinya, akun pengguna baru akan dibuat dan dihubungkan ke kredensial—yaitu, nama pengguna dan sandi, nomor telepon, atau informasi penyedia autentikasi—yang digunakan pengguna tersebut untuk login. Akun baru ini disimpan sebagai bagian dari project Firebase Anda dan dapat digunakan untuk mengidentifikasi pengguna di setiap aplikasi dalam project Anda, terlepas dari cara pengguna login.

  • Pada aplikasi, Anda dapat memperoleh informasi profil dasar pengguna dari objek 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;
    }
    
  • Dalam Aturan Keamanan Firebase Realtime Database dan Cloud Storage, Anda dapat memperoleh ID unik milik pengguna yang login dari variabel auth dan menggunakannya untuk mengontrol data yang dapat diakses pengguna.

Anda dapat mengizinkan pengguna untuk login ke aplikasi Anda menggunakan beberapa penyedia autentikasi dengan menautkan kredensial penyedia autentikasi ke akun pengguna yang ada.

Agar pengguna logout, panggil SignOut():

auth.SignOut();