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 Credential Manager 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. Implementasi 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 pengukuran yang Anda sesuaikan untuk 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. Implementasi kunci sandi Credential Manager 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 sudah 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 Pengelola Kredensial Wear

Batasan

Penggunaan Credential Manager di Wear OS memiliki batasan berikut:

• Tidak mendukung pembuatan kunci sandi.
• Tidak mendukung Tentang Restore Credentials.

Android XR

Dengan Android XR (yang mencakup virtual reality dan augmented reality), aplikasi dirender dalam ruang 3D. Input pengguna pada dasarnya berbeda dengan input pada faktor bentuk lainnya, yang 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 mungkin 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: Image Sistem Atom Intel x86_64 Google Play XR Revisi 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 bersifat komunal, dilihat dari jarak jauh, dan dinavigasi menggunakan remote D-pad. Memasukkan nama pengguna dan sandi di lingkungan ini dapat menyulitkan pengguna. Credential Manager menyederhanakan autentikasi di Android TV dengan mendukung Login dengan Google, sandi tersimpan, dan kunci sandi lintas perangkat. Karena beberapa profil Google sering ada di TV bersama, Pengelola Kredensial beradaptasi dengan setelan komunal ini dengan mengambil dan menampilkan semua kredensial yang tersedia di perangkat, bukan membatasi pilihan hanya pada akun yang aktif saat ini.

Sifat komunal ini juga menentukan cara penanganan kunci sandi. Karena televisi tidak memiliki Faktor Pengetahuan Layar Kunci (LSKF) pribadi, kunci sandi tidak disimpan atau dibuat langsung di TV. Sebagai gantinya, autentikasi kunci sandi memanfaatkan alur hybrid lintas perangkat yang menampilkan kode QR di TV, dan pengguna memindainya dengan perangkat seluler mereka untuk menyelesaikan autentikasi biometrik.

Alur tanpa klik dapat dilakukan di Google TV jika Anda menyetel isAutoSelectAllowed = true, tetapi hanya jika ada tepat satu kredensial yang cocok yang tersedia. Sheet bawah TV native akan tetap muncul, menampilkan konfirmasi akun pengguna. Jika pengguna tidak membatalkan, kredensial akan otomatis ditampilkan tanpa memerlukan klik jarak jauh. Jika ada beberapa kredensial yang cocok, kredensial tidak akan dipilih secara otomatis, dan pengguna akan diminta untuk memilih.

Jika aplikasi seluler dan TV Anda memiliki nama paket Android dan kunci penandatanganan yang sama persis, Pengelola Sandi Google akan mengenalinya sebagai identitas aplikasi yang sama. Oleh karena itu, sandi yang disimpan di perangkat seluler dapat ditawarkan langsung di TV tanpa memerlukan konfigurasi Digital Asset Links (asset_statements). Digital Asset Links hanya diperlukan saat membagikan kredensial lintas batas, seperti antara aplikasi dan situs, atau lintas aplikasi dengan nama paket yang berbeda.

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 bersama, 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 tetapkan preferImmediatelyAvailableCredentials ke true dalam permintaan Anda; melakukannya 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.
• Tidak ada Restore Credentials: Login otomatis ke perangkat baru menggunakan Tentang Restore Credentials tidak didukung di Android TV.

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

Android Automotive OS

Perangkat Android Automotive OS (AAOS) adalah sistem komunal yang terintegrasi ke dalam kendaraan. Mengadaptasi Credential Manager untuk AAOS memerlukan dukungan autentikasi yang aman (biasanya saat kendaraan diparkir) dan mengakomodasi beberapa profil pengguna di perangkat bersama.

Jika Anda menghadirkan aplikasi yang dioptimalkan untuk tablet atau perangkat layar besar ke mobil, dan aplikasi Anda sudah mendukung Credential Manager dan kunci sandi di perangkat seluler atau tablet, aplikasi tersebut akan berfungsi di Android Automotive OS tanpa memerlukan perubahan pada alur autentikasi Anda.

Autentikasi di Android Automotive OS mendukung metode berikut:

• Kunci sandi (alur hybrid lintas perangkat): Pengguna dapat mengautentikasi dengan kunci sandi yang ada melalui alur lintas perangkat. Sistem akan menampilkan kode QR di layar mobil yang dipindai pengguna dengan perangkat selulernya. Karena verifikasi biometrik dan kunci layar dilakukan di ponsel pengguna, pengguna tidak perlu mengonfigurasi kunci layar di layar mobil.
• Login dengan Google: Menampilkan layar Login dengan Google native langsung di layar mobil.
• Sandi tersimpan: Pengguna dapat mengambil sandi tersimpan dari Pengelola Sandi Google untuk login tanpa memasukkan kredensial secara manual di layar kendaraan.

Android Automotive OS mengelola sesi dan kredensial per profil, mengisolasi data sesi khusus pengguna di antara profil (misalnya, Profil A, Profil B, atau profil tamu).

Penggunaan Credential Manager untuk Android Automotive OS memiliki persyaratan berikut:

• Level API minimum: Android 9 (level API 28, minSdkVersion 28) atau yang lebih tinggi. Pengambilan kunci sandi lintas perangkat memerlukan Android 14 (level API 34) atau yang lebih tinggi.
• Versi GMS: Sama seperti yang diperlukan untuk aplikasi seluler.

Batasan pengujian

Pengujian kunci sandi memerlukan perangkat fisik yang menjalankan build Android Automotive OS sebagai platform utama. Untuk mengetahui petunjuk penyiapan, lihat Menguji menggunakan Android Automotive OS di Pixel Tablet. Emulator tidak dapat digunakan untuk pengujian kunci sandi karena tidak mendukung Bluetooth Hemat Energi (BLE), yang diperlukan untuk alur hybrid FIDO.

Batasan dan alur yang tidak didukung

Penggunaan Credential Manager di Android Automotive OS memiliki batasan berikut:

• Tidak ada penyimpanan atau pengambilan kunci sandi lokal: Pengambilan kunci sandi lokal langsung tidak didukung karena kendaraan adalah perangkat bersama. Menyinkronkan kunci sandi langsung ke kendaraan menimbulkan risiko keamanan, sehingga kunci sandi harus digunakan melalui alur hybrid lintas perangkat.
• Kredensial yang langsung tersedia tidak didukung: Jika aplikasi Anda meminta kunci sandi dan menetapkan preferImmediatelyAvailableCredentials ke true, UI otomotif akan segera dihentikan dan menampilkan NoCredentialException. Berikan UX penggantian yang sesuai untuk skenario ini.
• Tidak ada penyedia kredensial pihak ketiga: Pengelola sandi pihak ketiga tidak didukung di Android Automotive OS. Pengguna harus menggunakan Pengelola Sandi Google atau alur hybrid lintas perangkat untuk melakukan autentikasi.
• Tidak ada pembuatan sandi tersimpan: API tidak mendukung pembuatan dan penyimpanan sandi tersimpan baru langsung dari antarmuka mobil. Pembuatan kredensial dibatasi untuk kunci sandi baru menggunakan alur hybrid FIDO.

Untuk mempelajari pengembangan Automotive OS lebih lanjut, lihat Ringkasan Android Automotive OS.

Referensi lainnya

• Tentang Pengelola Kredensial
• Tentang Restore Credentials
• Ringkasan Android TV
• Ringkasan Android Automotive OS