Mengautentikasi di berbagai faktor bentuk

Pengelola Kredensial menyederhanakan autentikasi di seluruh ekosistem Android. API ini memberikan pengalaman yang konsisten bagi pengguna dan platform API terpadu bagi developer untuk menggunakan kunci sandi, sandi, dan mekanisme login gabungan seperti Login dengan Google. Meskipun antarmuka pemrograman inti tetap konsisten di seluruh faktor bentuk, setiap faktor bentuk memiliki pertimbangan UI dan UX yang unik. Penerapan yang berhasil memerlukan penyesuaian alur autentikasi aplikasi Anda dengan metode input, ukuran layar, dan konteks pengguna tertentu dari setiap perangkat.

Panduan ini memberikan ringkasan tentang cara menerapkan Pengelola Kredensial pada berbagai faktor bentuk Android, yang menyoroti pertimbangan utama dan menautkan ke dokumentasi yang lebih mendetail.

Perangkat seluler

Perangkat seluler, termasuk ponsel, tablet, dan perangkat foldable, merupakan target paling umum untuk pengembangan Android. Penerapan Credential Manager standar sangat cocok untuk perangkat ini, yang biasanya dilengkapi layar sentuh dan keyboard di perangkat. Pengalaman pengguna pada faktor bentuk ini berfungsi sebagai dasar untuk mengadaptasi faktor bentuk lainnya. Alur autentikasi harus disesuaikan dengan faktor bentuk dan menggunakan kemampuan penuh ruang layar dan metode input perangkat.

Wear OS

Perangkat Wear OS dicirikan oleh layar kecil dan input di perangkat yang terbatas. Penerapan kunci sandi Pengelola Kredensial menyediakan lingkungan yang aman bagi pengguna untuk login ke aplikasi, tanpa memerlukan ponsel yang terhubung dan dipasangkan, serta tanpa perlu mengingat sandi.

API untuk Wear OS sama dengan API untuk perangkat seluler, sehingga Anda dapat menggunakan kembali integrasi seluler yang ada. Selain kunci sandi, Login dengan Google, dan sandi dengan Credential Manager, Anda dapat menggunakan metode autentikasi lain termasuk Berbagi Token Lapisan Data, OAuth, atau solusi yang ada. Kredensial ini dapat digunakan sebagai cadangan saat Anda memindahkan pengguna ke Credential Manager, atau dalam kasus Berbagi Token Lapisan Data, sebagai solusi jangka panjang.

Penggunaan Credential Manager untuk Wear OS memiliki persyaratan berikut:

• Level API minimum: minSdkVersion 33 atau yang lebih tinggi
  • Mencakup dukungan untuk sandi, kunci sandi, dan Login dengan Google
• Versi GMS: Sama seperti yang diperlukan untuk aplikasi seluler

Antarmuka pengguna di perangkat Wear OS adalah sebagai berikut:

Untuk panduan penerapan dan contoh kode yang mendetail, lihat referensi berikut:

• Autentikasi di perangkat wearable: Credential Manager
• Rekomendasi desain UI untuk Wear OS
• Contoh Wear Credential Manager

Batasan

Penggunaan Credential Manager di Wear OS memiliki batasan berikut:

• Tidak mendukung pembuatan kunci sandi.
• Tidak mendukung Tentang Memulihkan Kredensial.

Android XR

Dengan Android XR—yang mencakup virtual reality dan augmented reality—aplikasi dirender dalam ruang 3D. Input pengguna pada perangkat ini sangat berbeda dengan input pada faktor bentuk lainnya, karena mengandalkan input alami seperti gestur tangan.

Menyesuaikan Credential Manager untuk XR berarti memikirkan ulang UI autentikasi—baik dengan kunci sandi, sandi, atau metode login gabungan—untuk ruang 3D. Misalnya, dialog autentikasi muncul di panel mengambang, dan pengguna membuat pilihan menggunakan gestur tangan. Anda juga perlu mempertimbangkan prasyarat hardware atau software tertentu untuk perangkat XR target Anda.

Tantangan desain yang penting adalah menciptakan pengalaman autentikasi yang intuitif dan aman dalam lingkungan VR atau AR. Anda juga harus mempertimbangkan cara mengelola identitas dalam skenario XR multi-pengguna, di mana orang yang berbeda dapat menggunakan perangkat yang sama.

Penggunaan Credential Manager untuk Android XR memiliki persyaratan berikut:

• Level API minimum: minSdkVersion 34 atau yang lebih tinggi
• Versi GMS: Sama seperti yang diperlukan untuk aplikasi seluler
• Emulator:
  • Image sistem emulator minimum:
    • macOS: Revisi 7 Image Sistem ARM 64 v8a Google Play XR
    • Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
  • Versi Emulator yang lebih tinggi dari 35.6.11 Stabil

Pengalaman login di XR mungkin terlihat seperti berikut:

Flow yang tidak didukung oleh XR

Credential Manager di Android XR tidak mendukung alur autentikasi yang memerlukan perangkat lain untuk memindai kode QR. Hal ini dapat diamati selama proses login di headset XR dan saat pengujian dengan emulator.

Untuk mempelajari XR lebih lanjut, lihat Android XR.

Android TV

Perangkat Android TV biasanya digunakan bersama, dilihat dari jarak jauh, dan dinavigasi menggunakan remote D-pad. Memasukkan nama pengguna dan sandi di lingkungan ini bisa sulit bagi pengguna. Credential Manager menyederhanakan autentikasi di Android TV dengan mendukung Login dengan Google, sandi tersimpan, dan kunci sandi lintas perangkat.

Karena TV adalah perangkat komunal dan tidak memiliki faktor pengetahuan layar kunci (LSKF), kunci sandi tidak dibuat atau disimpan langsung di TV. Sebagai gantinya, autentikasi kunci sandi menggunakan alur hybrid lintas perangkat: TV menampilkan kode QR yang dipindai pengguna dengan perangkat seluler mereka untuk menyelesaikan autentikasi biometrik.

Penggunaan Credential Manager untuk Android TV memiliki persyaratan berikut:

• Level API minimum: Android 14 (level API 34, minSdkVersion 34) atau yang lebih tinggi
• Versi GMS: 2026W30 atau yang lebih baru
• Hardware untuk kunci sandi: Perangkat seluler sekunder dengan kamera dan Bluetooth diperlukan untuk memindai kode QR dan menyelesaikan alur hybrid FIDO

Batasan

Karena Android TV adalah perangkat komunal, penggunaan Credential Manager di platform ini memiliki batasan yang disengaja berikut untuk melindungi privasi dan keamanan pengguna:

• Tidak ada pembuatan atau penyimpanan kunci sandi lokal: Kunci sandi tidak dapat dibuat atau disimpan langsung di TV. Karena kredensial lokal tidak didukung, jangan menetapkan preferImmediatelyAvailableCredentials ke true dalam permintaan Anda; tindakan ini akan memfilter kunci sandi lintas perangkat dan gagal menampilkan kredensial.
• Tidak ada penyedia kredensial pihak ketiga: Android TV tidak mendukung isi otomatis, sehingga pengelola sandi pihak ketiga tidak tersedia di platform. Pengguna harus menggunakan Pengelola Sandi Google.
• Tanpa Fitur Restore Credentials: Login otomatis ke perangkat baru menggunakan Tentang Fitur Restore Credentials tidak didukung di Android TV.

Untuk mempelajari pengembangan TV lebih lanjut, lihat Ringkasan Android TV.

Referensi lainnya

• Tentang Pengelola Kredensial
• Tentang Restore Credentials
• Autentikasi di perangkat wearable: Credential Manager
• Ringkasan Android TV