Mendaftarkan nomor telepon pengujian

Dokumen ini menunjukkan cara mendaftarkan nomor telepon ke Identity Platform untuk tujuan pengembangan. Dengan begitu, Anda dapat menguji metode autentikasi yang mencakup pengiriman pesan SMS, seperti login dengan nomor telepon dan autentikasi multi-faktor.

Menggunakan nomor pengujian (bukan angka asli yang Anda miliki) memiliki beberapa manfaat:

  • Alat ini terintegrasi lancar dengan emulator iOS dan Android.
  • Teknologi ini menghilangkan overhead saat mengirim SMS yang sebenarnya.
  • Anda dapat menjalankan pengujian berturut-turut dengan nomor telepon yang sama tanpa throttling.
  • Anda dapat menulis pengujian integrasi tanpa diblokir oleh pemeriksaan keamanan.
  • Laporan ini tidak menghabiskan kuota penggunaan Anda.

Anda dapat mendaftarkan hingga 10 nomor telepon untuk pengembangan.

Mendaftarkan nomor telepon pengujian

Untuk mendaftarkan nomor telepon pengujian:

  1. Buka halaman Identity Provider di Konsol Google Cloud.
    Buka halaman Penyedia Identitas

  2. Jika Anda menguji autentikasi dengan ponsel, cari autentikasi tersebut di daftar penyedia, lalu klik ikon Edit. Jika Anda menguji autentikasi multi-faktor, pilih tab SMS multi-faktor, lalu klik Edit.

  3. Pada bagian Nomor telepon untuk pengujian, masukkan nomor telepon dan kode verifikasi untuk mendaftar.

    Nomor telepon harus menggunakan format E.164 dan harus ditetapkan ke pengguna Identity Platform yang sudah ada. Kode verifikasi harus terdiri dari enam digit. Untuk tujuan keamanan, pilih angka yang sulit ditebak, dan hindari pola yang jelas seperti +1 123-456-7890.

  4. Klik Simpan.

Nomor telepon pengujian diperlakukan seperti nomor telepon asli oleh Identity Platform, jadi simpan dengan aman dan putar nomor tersebut pada interval reguler.

Pengujian manual

Anda dapat segera mulai menggunakan nomor telepon pengujian di aplikasi, baik secara langsung maupun menggunakan emulator iOS dan Android. Saat login dengan nomor telepon pengujian, tidak ada kode verifikasi SMS yang dikirim. Sebagai gantinya, masukkan kode yang Anda daftarkan saat membuat nomor pengujian.

Setelah login, pengguna Identity Platform akan dibuat menggunakan nomor telepon pengujian. Pengguna ini memiliki perilaku dan properti yang sama seperti pengguna sebenarnya, termasuk token ID yang valid, yang berarti ia dapat mengakses semua aplikasi dan layanan Anda.

Untuk membatasi akses dari pengguna uji coba, pertimbangkan untuk membuat peran pengujian dengan izin terbatas dan menetapkannya menggunakan klaim kustom.

Pengujian integrasi

Selain pengujian manual, SDK Klien berisi API yang dapat membantu menulis pengujian integrasi. API ini menonaktifkan persyaratan reCAPTCHA dan verifikasi aplikasi, sehingga lebih mudah untuk dilewati dengan otomatisasi.

Contoh berikut menunjukkan cara menguji proses login pengguna dengan nomor telepon:

JavaScript 

// Turn off phone app verification.
firebase.auth().settings.appVerificationDisabledForTesting = true;

var phoneNumber = "+16505554567";
var testVerificationCode = "123456";

// Render a fake reCAPTCHA and resolve without app verification.
var appVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container');
// signInWithPhoneNumber will call appVerifier.verify(), which will resolve
// with a fake reCAPTCHA response.
firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier)
  .then(function (confirmationResult) {
    // confirmationResult can resolve using testVerificationCode.
    return confirmationResult.confirm(testVerificationCode)
  }).catch(function (error) {
    // Error; SMS not sent
    // ...
  });

Pemverifikasi reCAPTCHA fiktif yang terlihat dan tidak terlihat berperilaku berbeda jika verifikasi aplikasi dinonaktifkan:

  • reCAPTCHA Terlihat: Untuk menyimulasikan klik pengguna, reCAPTCHA akan menyelesaikan masalah dengan sendirinya secara otomatis setelah penundaan singkat.

  • reCAPTCHA Tidak Terlihat: Untuk menyimulasikan verifikasi aplikasi, reCAPTCHA akan otomatis melakukan penyelesaian saat appVerifier.verify() dipanggil.

reCAPTCHA fiktif masih akan memicu callback-nya setelah di-resolve atau habis masa berlakunya.

Langkah selanjutnya

  • Tambahkan autentikasi multi-faktor ke aplikasi web, iOS, atau Android.