Autentikasi dengan Firebase menggunakan Nomor Telepon dan C++

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

Dokumen ini menjelaskan cara mengimplementasikan proses login dengan nomor telepon menggunakan Firebase SDK.

Nomor telepon yang dimasukkan pengguna akhir untuk autentikasi akan dikirim dan disimpan oleh Google untuk meningkatkan pencegahan spam dan penyalahgunaan di seluruh layanan Google, termasuk, tetapi tidak terbatas pada, Firebase. Para developer harus memastikan bahwa mereka memiliki izin pengguna akhir yang sesuai sebelum menggunakan layanan login dengan nomor telepon dari Firebase Authentication.

Sebelum memulai

1. Tambahkan Firebase ke project C++ Anda.
2. Jika Anda belum menghubungkan aplikasi ke project Firebase, lakukanlah dari Firebase console.
3. Pahami persyaratan platform untuk login dengan Nomor Telepon:
   • Login dengan Nomor Telepon hanya tersedia untuk platform seluler.
   • Pada iOS, login dengan Nomor Telepon memerlukan perangkat fisik dan tidak akan berfungsi pada simulator.

Masalah keamanan

Meskipun mudah, autentikasi hanya melalui nomor telepon kurang aman dibandingkan metode lain yang tersedia, karena nomor tersebut dapat berpindah tangan antarpengguna 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 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 Sign-in Method, aktifkan metode login dengan Phone Number.

Mulai menerima notifikasi APNs (platform Apple)

Untuk menggunakan autentikasi nomor telepon di platform Apple, aplikasi Anda harus dapat menerima notifikasi APNs dari Firebase. Saat Anda membuat pengguna login dengan nomor telepon untuk pertama kalinya di perangkat, Firebase Authentication akan mengirimkan notifikasi push senyap 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 APNs Anda ke Firebase. Jika Anda belum memiliki sertifikat APNs, pastikan untuk membuat sertifikat di Apple Developer Member Center.

   1. Pada project Anda di Firebase console, pilih ikon roda gigi, pilih Project Settings, lalu pilih tab Cloud Messaging.

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

   3. Untuk setiap sertifikat, pilih file .p12, dan masukkan sandi jika ada. Pastikan ID paket untuk sertifikat ini cocok dengan ID paket aplikasi Anda. Pilih Save.

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.

   class PhoneListener : public PhoneAuthProvider::Listener {
    public:
     ~PhoneListener() override {}
   
     void OnVerificationCompleted(PhoneAuthCredential credential) override {
       // Auto-sms-retrieval or instant validation has succeeded (Android only).
       // No need for the user to input the verification code manually.
       // `credential` can be used instead of calling GetCredential().
     }
   
     void OnVerificationFailed(const std::string& error) override {
       // Verification code not sent.
     }
   
     void OnCodeSent(const std::string& verification_id,
                     const PhoneAuthProvider::ForceResendingToken&
                         force_resending_token) override {
       // Verification code successfully sent via SMS.
       // Show the Screen to enter the Code.
       // Developer may want to save that verification_id along with other app states in case
       // the app is terminated before the user gets the SMS verification code.
     }
   };
   
   PhoneListener phone_listener;
   PhoneAuhtOptions options;
   options.timeout_milliseconds = kAutoVerifyTimeOut;
   options.phone_number = phone_number;
   PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth);
   phone_provider->VerifyPhoneNumber(options, &phone_listener);

   Saat Anda memanggil PhoneAuthProvider::VerifyPhoneNumber, Firebase,
   • (di iOS) akan mengirimkan notifikasi push senyap ke aplikasi Anda.
   • 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.
     Catatan: Lihat Batas Firebase Authentication untuk mengetahui batas dan kuota penggunaan yang berlaku.

3. Simpan ID verifikasi dan pulihkan saat aplikasi Anda 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. Jika Anda menulis dengan framework C++ lintas platform, notifikasi harus diberikan untuk menghentikan dan memulihkan aplikasi. Dalam peristiwa ini, Anda dapat menyimpan dan memulihkan ID verifikasi.

Jika panggilan ke VerifyPhoneNumber menyebabkan OnCodeSent dipanggil pada pemroses, Anda dapat meminta pengguna untuk mengetik kode verifikasi yang mereka terima dalam pesan SMS.

Di sisi lain, jika panggilan ke VerifyPhoneNumber menghasilkan OnVerificationCompleted, verifikasi otomatis telah berhasil dan Anda sekarang akan memiliki PhoneAuthCredential yang dapat digunakan seperti yang dijelaskan di bawah.

Untuk mencegah penyalahgunaan, Firebase memberlakukan batasan jumlah pesan SMS yang bisa dikirimkan ke satu nomor telepon dalam jangka waktu tertentu. Jika Anda melewati batas ini, permintaan verifikasi nomor telepon dapat tertahan. Jika Anda mengalami masalah ini selama proses pengembangan, gunakan nomor telepon lain untuk melakukan pengujian, atau ulangi permintaan tersebut nanti.

Memproses login pengguna dengan kode verifikasi

Setelah pengguna memasukkan kode verifikasi yang diterima melalui SMS ke aplikasi Anda, proses login pengguna dengan membuat objek PhoneAuthCredential dari kode dan ID verifikasi, lalu teruskan objek tersebut ke Auth::SignInWithCredential.

1. Dapatkan kode verifikasi dari pengguna.
2. Buat objek Credential dari kode verifikasi dan ID verifikasi.

   PhoneAuthCredential credential = phone_auth_provider->GetCredential(
       verification_id_.c_str(), verification_code.c_str());
       

3. Buat pengguna login dengan objek Credential:

   Future<User> future = auth_->SignInWithCredential(credential);
   future.OnCompletion(
       [](const Future<User*>& result, void*) {
         if (result.error() == kAuthErrorNone) {
           // Successful.
           // User is signed in.
           User user = *result.result();
   
           // This should display the phone number.
           printf("Phone number: %s", user.phone_number().c_str());
   
           // The phone number provider UID is the phone number itself.
           printf("Phone provider uid: %s", user.uid().c_str());
   
           // The phone number providerID is 'phone'
           printf("Phone provider ID: %s", user.provider_id().c_str());
         } else {
           // Error.
           printf("Sign in error: %s", result.error_message().c_str());
         }
       },
       nullptr);

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::User:

  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();
  }

• Di Aturan Keamanan Firebase Realtime Database dan Cloud Storage, Anda bisa mendapatkan ID pengguna unik milik pengguna 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.

Untuk memproses logout pengguna, panggil SignOut():

auth->SignOut();