Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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. Agar dapat menggunakan Firebase Authentication, Anda harus menambahkan Firebase Unity SDK (khususnya, FirebaseAuth.unitypackage) ke project Unity Anda.

    Temukan petunjuk detail seputar langkah-langkah penyiapan awal ini di artikel 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 notifikasi APN dari Firebase. Saat Anda membuat pengguna login dengan nomor telepon untuk pertama kalinya di perangkat, Firebase Authentication akan mengirimkan notifikasi push diam ke perangkat untuk memverifikasi bahwa permintaan login dengan nomor telepon tersebut berasal dari aplikasi Anda. (Inilah mengapa login dengan nomor telepon tidak bisa digunakan pada simulator).

Untuk mengaktifkan notifikasi 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 aplikasi Anda. Pilih Simpan.

Mengirim kode verifikasi ke ponsel pengguna

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

  1. Dapatkan nomor telepon pengguna.

    Persyaratan hukum yang berlaku berbeda-beda, tetapi sebagai praktik terbaik dan untuk menetapkan ekspektasi pengguna, sebaiknya informasikan bahwa jika mereka menggunakan metode login melalui telepon, akan muncul pesan SMS untuk melakukan verifikasi dan berlaku tarif standar.

  2. Panggil PhoneAuthProvider.VerifyPhoneNumber, lalu teruskan ke nomor telepon pengguna.
    PhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth);
    provider.VerifyPhoneNumber(phoneNumber, phoneAuthTimeoutMs, null,
      verificationCompleted: (credential) => {
        // 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) => {
        // The verification code was not sent.
        // `error` contains a human readable explanation of the problem.
      },
      codeSent: (id, token) => {
        // 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) => {
        // 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 notifikasi push 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 berhasil dan Anda akan memiliki Credential yang dapat digunakan seperti yang dijelaskan di bawah.

Membuat pengguna login dengan kode verifikasi

Setelah pengguna memasukkan kode verifikasi yang diterima melalui SMS ke aplikasi Anda, buat mereka 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 verifikasi dan ID verifikasi.
    Credential credential =
        phoneAuthProvider.GetCredential(verificationId, verificationCode);
        
  3. Buat pengguna login dengan objek Credential:
    auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
      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 ditautkan 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, terlepas dari cara pengguna login.

  • Di aplikasi, Anda bisa mendapatkan 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;
    }
    
  • Di Aturan Keamanan Firebase Realtime Database dan Cloud Storage, Anda bisa mendapatkan ID pengguna unik yang login dari variabel auth, dan menggunakannya untuk mengontrol data yang dapat diakses oleh pengguna.

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

Agar pengguna logout, panggil SignOut():

auth.SignOut();