Dokumen ini menjelaskan penggunaan Pengelola Kredensial untuk mendapatkan alamat email yang diverifikasi secara kriptografis dari perangkat pengguna. Proses ini menghilangkan kebutuhan pengguna aplikasi Anda untuk memverifikasi email mereka dengan sandi sekali pakai (OTP) atau magic link.
Dokumen ini menjelaskan area berikut:
- Kompatibilitas Android
- Pengalaman pengguna
- Akun yang didukung
- Implikasi kemampuan pengiriman email
- Perbandingan dengan Login dengan Google
Panduan ini mengasumsikan bahwa Anda sudah memahami konsep berikut:
Keterampilan Android
Lihat di GitHubMengambil email terverifikasi
android skills add verified-emailKompatibilitas Android
Fitur ini didukung di perangkat seluler, tablet, dan perangkat foldable yang menjalankan Android 9 (level API 28) dan yang lebih baru. Versi minimum layanan Google Play (GMS) yang diperlukan adalah 25.49.x.
Pengalaman pengguna
Bagian berikut menjelaskan pengalaman pengguna selama alur verifikasi, kebutuhan untuk menyertakan metode verifikasi penggantian, serta pengalaman pengguna yang direkomendasikan untuk berbagai kasus penggunaan.
Alur verifikasi
Pengalaman pengguna untuk membagikan email terverifikasi adalah sebagai berikut:
- Pengguna berfokus pada kolom input atau mengetuk tombol yang memanggil Credential Manager API. Bergantung pada desain layar, Anda juga dapat memanggil API saat pemuatan layar aplikasi.
- Panel bawah akan muncul, menampilkan informasi yang akan dibagikan kepada aplikasi. Jika tidak ada informasi yang tersedia di perangkat tersebut, pengguna akan melihat pesan error umum.
- Setelah pengguna mengetuk Setuju dan Lanjutkan, tampilkan pesan berhasil atau gagal.
- Catatan: Jika email terverifikasi yang Anda terima tidak sesuai dengan yang Anda harapkan, beri tahu pengguna tentang ketidakcocokan tersebut dan minta mereka untuk mencoba lagi dengan kredensial yang berbeda atau berikan metode verifikasi alternatif, seperti melalui OTP.
- (Opsional, direkomendasikan) Jika pengguna mendaftar ke layanan Anda, Anda harus meminta pengguna untuk membuat kunci sandi agar lebih mudah login setelahnya.
- Catatan: Proses verifikasi email tidak otomatis memicu pembuatan kunci sandi. Namun, sangat disarankan untuk menyertakan langkah-langkah untuk pembuatan kunci sandi. Kunci sandi membantu pengguna dengan mempermudah dan mengamankan proses login, serta menghilangkan kebutuhan akan interaksi nama pengguna dan sandi konvensional.
Menyertakan alur utama dan penggantian
Untuk memastikan pengalaman pengguna yang efisien, sertakan opsi berikut di layar yang memerlukan verifikasi email:
- Opsi verifikasi utama: Kolom atau tombol email untuk memicu alur Credential Manager API untuk verifikasi cepat.
- Opsi verifikasi alternatif: Link atau tombol bagi pengguna untuk "Memverifikasi dengan cara lain" atau dengan "Opsi lain" untuk memasukkan email secara manual jika terjadi kegagalan, seperti tidak ada informasi yang tersedia di perangkat, atau ketidakcocokan antara email yang diambil dan yang diharapkan. Tindakan ini akan memungkinkan pengguna mencoba verifikasi dengan kredensial lain atau dengan memberikan OTP manual.
Kasus penggunaan
Bagian berikut menjelaskan kasus penggunaan yang direkomendasikan, serta pengalaman pengguna yang disarankan, untuk verifikasi email.
Daftar
Pengguna dapat langsung membuat akun dengan email terverifikasi tanpa langkah verifikasi terpisah. Jika perlu, minta pengguna untuk menambahkan kunci sandi. Jika mereka memilih untuk menambahkan kunci sandi, picu alur pembuatan kunci sandi.
Pemulihan akun
Untuk menghilangkan rasa frustrasi pengguna yang mencari kode pemulihan di folder spam, izinkan mereka memulihkan akun menggunakan email terverifikasi yang disimpan dengan aman di perangkat mereka. Selain itu, sarankan agar mereka membuat kunci sandi untuk penggunaan di masa mendatang.
Autentikasi ulang untuk tindakan sensitif
Lindungi tindakan pengguna yang sensitif, seperti mengubah setelan atau memperbarui detail profil, dengan mewajibkan langkah autentikasi ulang yang cepat.
Akun yang didukung
Verifikasi email melalui Credential Manager hanya mendukung verifikasi Akun Google konsumen. Akun Workspace dan akun yang diawasi tidak didukung.
Akun Google konsumen dapat dibuat dengan alamat email dari penyedia mana pun, tidak harus @gmail.com. Namun, Google memverifikasi akun ini secara berbeda:
- Untuk akun @gmail.com: Google adalah sumber otoritatif, dan email tersebut diketahui telah diverifikasi.
- Untuk akun non-@gmail.com: Google bukan sumber otoritatif untuk alamat email ini dalam jangka panjang. Meskipun Google memverifikasi email saat akun dibuat, kepemilikan alamat email tersebut dapat berubah seiring waktu. Oleh karena itu, untuk alamat non-@gmail.com, Anda harus mempertimbangkan langkah verifikasi tambahan, seperti mengirim OTP, untuk memastikan bahwa pengguna masih memiliki akses ke akun email tersebut.
Untuk mengetahui informasi selengkapnya tentang implikasi verifikasi, lihat Kredensial Digital.
Catatan: Selain informasi email pengguna, Anda dapat meminta kolom lain yang belum diverifikasi, seperti nama depan, nama belakang, nama, dan foto profil Akun Google pengguna. Namun, hanya email yang diverifikasi oleh Google.
Untuk verifikasi nomor telepon, lihat Memverifikasi nomor telepon dengan kredensial digital. Untuk solusi Firebase, lihat Firebase Phone Number Verification.
Validitas dan keaktualan
Sistem akan menerbitkan kredensial yang dapat diverifikasi (VC) berdasarkan email pengguna saat ini dari Akun Google yang aktif di perangkat. Kredensial ini diberikan ke perangkat terlebih dahulu, biasanya saat perangkat tidak ada aktivitas. Meskipun kredensial ini mungkin tetap valid selama beberapa hari, sistem akan melakukan pemeriksaan pada saat membagikan kredensial untuk memastikan bahwa akun masih ada, berada di perangkat, dan alamat emailnya valid—secara efektif memprioritaskan status akun langsung daripada periode validitas kredensial.
Untuk membantu memastikan keaslian, tanda tangan Key Binding (kb) dibuat pada saat berbagi, yang menyertakan nonce.
Jika perangkat offline atau akun dihapus, prosesnya akan gagal, bukan memberikan VC yang sudah tidak berlaku atau VC untuk Akun Google yang tidak aktif.
Kemampuan pengiriman email
Meskipun proses ini mengonfirmasi legitimasi akun, proses ini tidak menjamin pengiriman ke kotak masuk (misalnya, email mungkin dialihkan ke spam). OTP tetap menjadi metode pasti untuk mengonfirmasi pengiriman email.
Perbandingan dengan Login dengan Google
Meskipun solusi Kredensial Digital dan Login dengan Google memberikan email terverifikasi, alur penggunaan dan kasus penggunaannya berbeda:
- Kasus penggunaan: Alur verifikasi email Credential Manager tidak hanya digunakan dalam kasus penggunaan pendaftaran atau login, tetapi dapat digunakan dalam kasus penggunaan apa pun yang melibatkan pengambilan email terverifikasi. Hal ini juga dapat mencakup pemulihan akun.
- Pendaftaran: Alur Credential Manager tidak memerlukan pendaftaran Google, tidak seperti Login dengan Google.
Dukungan platform: Alur Pengelola Kredensial adalah solusi khusus Android.
Cakupan: Tidak seperti Login dengan Google, yang dapat menggunakan OAuth 2.0 untuk meminta akses ke data pengguna (seperti Kalender atau Drive melalui cakupan), Digital Credentials API hanya ditujukan untuk mengambil atribut identitas terverifikasi. Token ini tidak dapat digunakan untuk meminta cakupan otorisasi tambahan.
Langkah berikutnya
Untuk menerapkan fitur ini di aplikasi Anda, lihat Panduan penerapan.