Halaman ini diterjemahkan secara otomatis. Baca versi asli berbahasa Inggris di sini.
Kunci sandi kini didukung oleh 20% dari 100 situs web teratas dunia dan 53% konsumen secara global telah mengaktifkan kunci sandi di setidaknya satu akun, menurut FIDO Alliance Authentication Barometer 2024. Amazon, WhatsApp, Coinbase, TikTok, Facebook, LinkedIn, dan X/Twitter semuanya telah meluncurkan dukungan sejak 2023.

Cheatsheet Passkeys. Panduan praktis, pola peluncuran, dan KPI untuk program passkeys.
Spesifikasi W3C WebAuthn Level 3 mendefinisikan
serangkaian pengecualian DOM, tetapi browser dengan sengaja menggabungkan sebagian besar
kegagalan (pembatalan pengguna, waktu habis, autentikator yang tidak memenuhi syarat)
menjadi NotAllowedError yang umum untuk menghindari kebocoran privasi, menurut
Pertimbangan Privasi W3C.
Banyak pihak pengandal (relying parties) juga mendefinisikan pesan kesalahan mereka
sendiri, karena tidak banyak praktik terbaik yang didemonstrasikan selain dari
panduan UX FIDO Alliance. Panduan ini memetakan
kata-kata yang berhadapan dengan konsumen yang paling umum ke penyebab yang jelas dan
perbaikan praktis, dengan tangkapan layar dari rilis awal dan build
iOS serta
Android terbaru.
Diskusikan berita dan pertanyaan passkeys di r/passkey.
Jika "kunci sandi google tidak berfungsi" di perangkat Anda, pemeriksaan pertama adalah apakah browser, OS, dan layanan Google Play semuanya berada pada build terbaru, karena sebagian besar regresi diperbaiki dalam satu atau dua rilis.
Artikel terbaru
♟️
Mengapa Anda Membutuhkan Observabilitas Autentikasi untuk CIAM
🔑
Penjelasan Kredensial Sesi Terikat Perangkat (DBSC)
📖
Relying Party ID (rpID) WebAuthn & Kunci Sandi: Domain & Aplikasi Native
♟️
Strategi Kunci Sandi: Mengapa Implementasi Kunci Sandi Anda Akan Gagal
♟️
Masalah Hari Ke-2 Kunci Sandi: 5 Risiko setelah Peluncuran
Kunci sandi adalah kredensial tanpa kata sandi berdasarkan API WebAuthn dan spesifikasi CTAP 2.2 yang mendasarinya dari FIDO Alliance. W3C menstandarkan WebAuthn Level 1 pada Maret 2019, Level 2 pada April 2021, dan Level 3 pada 2024. Adopsi mencapai sekitar 1 miliar kredensial yang terdaftar di seluruh ekosistem utama pada Q4 2024, menurut FIDO Alliance Authenticate 2024.
Coba passkeys dalam demo live.
Perangkat menghasilkan pasangan kunci unik saat pendaftaran. Hanya kunci publik yang dikirim ke pihak pengandal, sementara kunci privat tetap berada di dalam enclave aman, TPM, atau TEE. Saat masuk (sign-in), server mengirimkan tantangan, perangkat membuka kunci privat dengan Face ID, Touch ID, atau Windows Hello, menandatangani tantangan, dan mengembalikan tanda tangan. Pihak pengandal memverifikasinya dengan kunci publik.
Karena kunci privat tidak pernah meninggalkan perangkat, phishing dan penggunaan ulang kata sandi berhenti bekerja sebagai vektor serangan. Dari sudut pandang pengguna, seluruh alur adalah satu prompt biometrik.
Lihat berapa banyak orang yang benar-benar memakai passkeys.
Rantai Kunci iCloud Diaktifkan:
Rantai Kunci iCloud (iCloud Keychain) adalah lokasi penyimpanan untuk kredensial di perangkat Apple dan disertakan pada iOS 16, iPadOS 16, dan macOS Ventura 13 atau yang lebih baru. Apple melaporkan sekitar 2,2 miliar perangkat aktif pada awal 2024, di mana lebih dari 90% menjalankan iOS 16 atau yang lebih baru, menurut dasbor pengembang Apple. Untuk mengaktifkan Rantai Kunci iCloud, navigasikan ke pengaturan perangkat Anda, pilih ID Apple Anda, buka iCloud, dan kemudian aktifkan Rantai Kunci iCloud (baca selengkapnya di sini). Menurut dokumentasi pengembang Apple, akun iCloud dengan Keychain yang diaktifkan diwajibkan untuk menggunakan MFA.
iOS 16 atau macOS Ventura Diperlukan:
iOS 16 diluncurkan pada 12 September 2022 dan macOS Ventura 13 pada 24 Oktober 2022. Pada iOS 18, penyimpanannya pindah ke aplikasi Passwords khusus, itulah sebabnya beberapa prompt sekarang berbunyi "Passwords" alih-alih "iCloud Keychain". Menurut dukungan Apple, pengguna pada build OS lama tidak dapat membuat atau menggunakan kunci sandi sama sekali.
Berlangganan Passkeys Substack kami untuk berita terbaru.
Penyiapan Windows Hello:
Windows Hello diperlukan untuk membuat atau menggunakan kunci sandi di perangkat Windows 10 dan Windows 11. Menurut dokumentasi kunci sandi Windows dari Microsoft, Windows 11 build 22631 (November 2024) mengirimkan UI kunci sandi asli dan Windows 11 25H2 (November 2025) menambahkan dukungan untuk pengelola kunci sandi pihak ketiga seperti 1Password dan Bitwarden. Windows Hello menerima sidik jari, pemindaian wajah, atau PIN 6 digit. Konfigurasikan di bawah Pengaturan > Akun > Opsi masuk (baca selengkapnya di sini).
Android Versi 9 atau Lebih Baru:
Android 9 (Pie) diluncurkan pada 6 Agustus 2018 dan merupakan versi minimum untuk API Pengelola Kredensial (Credential Manager API). Menurut dasbor distribusi Android, Android 9 dan yang lebih baru berjalan pada sekitar 95% perangkat Android aktif pada tahun 2026. Build lama tidak dapat menggunakan kunci sandi sama sekali karena tidak memiliki StrongBox Keymaster dan Pengelola Kredensial.
Layanan Google Play Diperbarui:
Layanan Google Play versi 23.40 atau yang lebih baru diperlukan untuk Pengelola Kredensial. Layanan Google Play diperbarui kira-kira setiap 4 hingga 6 minggu dan sebagian besar masalah "kunci sandi google tidak berfungsi" menelusuri kembali ke versi yang kedaluwarsa. Perbarui layanan Google Play dan WebView sistem di bawah Pengaturan > Aplikasi lalu coba lagi.
Di semua platform, perbarui browser pada build terbaru. Safari, Chrome, dan Edge mengirimkan pembaruan stabil secara kasar setiap minggu dan sebagian besar regresi diperbaiki dalam satu atau dua rilis.
Lihat berapa banyak orang yang benar-benar memakai passkeys.
Kami melacak sekitar 15 pola kesalahan berulang di seluruh klien iOS, Android, dan Windows, yang secara bersama-sama merupakan sebagian besar tiket dukungan konsumen yang diamati di berbagai pihak pengandal utama. 6 bagian berikutnya mengelompokkan kesalahan tersebut berdasarkan akar penyebab: Rantai Kunci iCloud dan aplikasi Apple Passwords, tidak ada kredensial yang tersedia, kode QR dan alur lintas perangkat, masalah spesifik Windows, masalah spesifik Android, serta kelompok WebAuthn atau browser umum.
Setiap entri menyertakan tangkapan layar dari rilis awal serta build iOS dan build Pengelola Kredensial Android terbaru, penyebab yang paling mungkin, dan solusi yang telah berhasil bagi pengguna lain. Jika bermanfaat, entri tersebut merujuk pada Spesifikasi W3C WebAuthn Level 3, spesifikasi FIDO Alliance, atau dokumentasi platform yang relevan dari Apple, Microsoft, dan Pengelola Kredensial Android.
Kelompok ini mencakup dua kesalahan yang ditampilkan perangkat Apple ketika Rantai Kunci iCloud tidak disiapkan dengan benar. Keduanya dimunculkan oleh sistem, bukan oleh pihak pengandal. Rantai Kunci iCloud adalah persyaratan mutlak untuk kunci sandi di iOS 16, iPadOS 16, atau macOS Ventura 13 dan yang lebih baru, menurut dokumentasi pengembang Apple. Pada iOS 18 penyimpanannya pindah ke aplikasi Passwords yang baru, itulah sebabnya kata-katanya berubah.
Pada iOS terbaru, kata-katanya berbunyi "Untuk menggunakan kunci sandi, Anda perlu mengaktifkan Rantai Kunci iCloud" dan jalurnya diganti nama menjadi Pengaturan > Akun Apple > iCloud > Kata Sandi dan Rantai Kunci (Settings > Apple Account > iCloud > Passwords and Keychain):
Pada iOS terbaru, prompt tersebut kini bermerek aplikasi Passwords baru dan berbunyi "Tidak ada kunci sandi yang cocok yang disimpan di Passwords untuk ...":
Kesalahan ini muncul ketika kredensial yang diharapkan pengguna tidak ada di perangkat saat ini, sudah terdaftar, atau telah dihapus di satu sisi tetapi tidak di sisi lain. Properti WebAuthn AllowCredentials dan excludeCredentials mendorong sebagian besar perilaku ini di sisi server.
Di Android, kesalahan yang sama dimunculkan oleh layanan Google Play dengan "Tidak ada kunci sandi yang tersedia. Tidak ada kunci sandi untuk <pihak pengandal> di perangkat ini" dan opsi cadangan "Gunakan perangkat lain":
Alur kode QR menggunakan transportasi hibrida FIDO (juga disebut hibrida CTAP 2.2). Menurut spesifikasi CTAP FIDO, kedua perangkat bertukar rahasia sekali pakai melalui kode QR dan kemudian berkomunikasi melalui Bluetooth Rendah Energi (Bluetooth Low Energy) pada jarak maksimum sekitar 3 meter. Baik Bluetooth maupun jarak dekat diperlukan, jika tidak, alur akan gagal secara diam-diam.
Pada iOS terbaru, lembar silang perangkat kode QR sekarang berbunyi "Pindai Kode QR. Pindai kode QR ini dengan perangkat yang kompatibel untuk masuk ke ...":
Di Android, Pengelola Kredensial memunculkan alur yang sama sebagai "Tidak ada info masuk yang tersedia" dengan opsi Tampilkan kode QR dan cadangan untuk Buka Google Pengelola Kata Sandi:
Build Windows telah mengirimkan beberapa regresi terkait kunci sandi selama 18 bulan terakhir. Menurut dokumentasi kunci sandi Windows dari Microsoft, build 22631 (November 2024) menambahkan UI kunci sandi asli dan Windows 11 25H2 (November 2025) menambahkan dukungan pengelola kunci sandi pihak ketiga. Kedua pergeseran ini mengatur ulang beberapa status Windows Hello.
C:\Windows\ServiceProfiles\LocalService\AppData\Local\Microsoft\Ngc), lalu daftarkan
ulang Windows Hello. Perlakukan masuk akun Microsoft di Windows sebagai upaya terbaik
dan selalu aktifkan setidaknya satu opsi MFA non-kunci sandi.API Pengelola Kredensial Android memerlukan layanan Google Play 23.40 atau yang lebih baru dan mengandalkan layar kunci aman untuk verifikasi pengguna, menurut dokumentasi Pengelola Kredensial Android. Perangkat tanpa kunci layar tidak dapat mendaftarkan atau menggunakan kredensial sama sekali.
Kesalahan ini datang langsung dari browser atau lapisan
WebAuthn. Mereka sengaja bersifat umum untuk
melindungi privasi pengguna. Browser mengekspos antara 10 dan 14 pengecualian DOM yang
berbeda selama seremoni menurut spesifikasi W3C, dan yang paling umum (NotAllowedError)
mencakup pembatalan, batas waktu, dan penolakan platform diam-diam dalam satu ember.
Kunci sandi menghilangkan kelas kerentanan kata sandi dengan mengganti rahasia bersama dengan kriptografi kunci publik. Penerapan di dunia nyata melaporkan proses masuk 4x hingga 6x lebih cepat dibandingkan dengan kata sandi plus OTP, dengan Laporan Investigasi Pelanggaran Data Verizon 2024 mengaitkan 68% pelanggaran ke elemen manusia yang tidak berbahaya termasuk penyalahgunaan kredensial. Mengurangi area permukaan itulah intinya.
Dalam praktiknya, ke-15 kesalahan di atas merupakan sebagian besar tiket dukungan konsumen yang kami lihat di komunitas kunci sandi, dan melakukan pemecahan masalah dengan benar sangat penting untuk adopsi kunci sandi yang lebih luas. Mengikuti praktik terbaik pembuatan dan praktik terbaik proses masuk akan mengurangi tingkat kesalahan secara signifikan. Untuk tetap mendapatkan informasi terbaru mengenai penanganan kesalahan dan detail peluncuran, berlangganan Substack kunci sandi atau bergabunglah dengan komunitas di Slack.
Corbado adalah Passkey Intelligence Platform untuk tim CIAM yang menjalankan autentikasi consumer dalam skala besar. Kami membantu Anda melihat apa yang tidak bisa ditunjukkan oleh log IDP dan tool analytics generik: device, versi OS, browser, dan credential manager mana yang mendukung passkey; mengapa enrollment tidak menjadi login; di mana flow WebAuthn gagal; dan kapan update OS atau browser diam-diam merusak login — semuanya tanpa mengganti Okta, Auth0, Ping, Cognito, atau IDP internal Anda. Dua produk: Corbado Observe menambah observability untuk passkey dan metode login lainnya. Corbado Connect menghadirkan managed passkey dengan analytics terintegrasi (berdampingan dengan IDP Anda). VicRoads menjalankan passkey untuk 5M+ pengguna dengan Corbado (aktivasi passkey +80%). Bicara dengan pakar Passkey →
Prompt ini muncul saat Windows Hello dinonaktifkan atau tidak ada TPM yang tersedia, menyebabkan sistem kembali ke autentikasi kunci keamanan perangkat keras. Mengaktifkan Windows Hello di pengaturan masuk perangkat Anda menyelesaikan masalah ini, tetapi Anda harus terlebih dahulu membuat kunci sandi Windows Hello sebelum menggunakannya untuk login.
Kesalahan ini biasanya disebabkan oleh gangguan aplikasi, masalah server sementara, atau pengaturan perangkat yang tidak kompatibel. Memulai ulang aplikasi atau perangkat dan memeriksa pembaruan OS serta aplikasi biasanya menyelesaikannya. Jika masalah tersebut muncul di sisi server, disarankan untuk menunggu dan mencoba lagi nanti.
Kesalahan batas waktu terjadi ketika server membutuhkan waktu terlalu lama untuk merespons, biasanya karena ketidakstabilan jaringan atau beban server yang tinggi. Memverifikasi koneksi internet Anda adalah langkah pertama. Jika konektivitas stabil, masalahnya kemungkinan besar berada di sisi server dan mencoba lagi setelah menunggu sebentar seharusnya menyelesaikannya.
Menghapus kunci sandi dari sisi klien, seperti dari Rantai Kunci iCloud atau Google Pengelola Kata Sandi, tanpa menghapusnya di pengaturan akun pihak pengandal akan menyebabkan kesalahan 'tidak ada kunci sandi yang cocok'. Server masih memegang kunci publik dan mengharapkan kredensial, sehingga penghapusan di sisi klien maupun di sisi server diperlukan sebelum mendaftarkan kunci sandi baru.
NotAllowedError adalah kesalahan WebAuthn umum yang dikembalikan browser ketika seremoni
kunci sandi tidak selesai. Ini bisa berarti pembatalan oleh pengguna, habis waktu, gerakan
pengguna tidak ada, origin diblokir, atau autentikator platform yang menolak permintaan.
Browser menyembunyikan penyebab pastinya demi alasan privasi. Mencoba lagi alur tersebut
setelah tindakan pengguna secara langsung dan mengonfirmasi biometrik atau PIN biasanya
akan menyelesaikannya.
Pada iOS 18 dan yang lebih baru, lokasi penyimpanan dipindahkan ke aplikasi Passwords baru, sehingga kata-katanya berubah dari "Rantai Kunci iCloud" menjadi "Passwords". Kesalahan tersebut berarti kredensial hilang pada perangkat ini atau sinkronisasi iCloud tidak aktif. Konfirmasi bahwa Rantai Kunci iCloud diaktifkan pada setiap perangkat Apple yang digunakan oleh ID Apple yang sama, paksakan sinkronisasi dengan mematikan dan menghidupkan Rantai Kunci iCloud, lalu coba masuk lagi. Jika tidak ada kredensial sama sekali, daftarkan yang baru dari pengaturan akun pihak pengandal.
Pengelola Kredensial Android menampilkan prompt ini saat tidak ada kredensial yang cocok yang disimpan untuk pihak pengandal yang diminta pada perangkat saat ini. Ini biasanya menawarkan opsi "Tampilkan kode QR" untuk menggunakan kunci sandi dari perangkat lain melalui transportasi hibrida FIDO, ditambah cadangan untuk membuka Google Pengelola Kata Sandi. Pindai kode QR dengan ponsel yang sudah memegang kredensial tersebut, masuk dengan metode cadangan, atau daftarkan kredensial baru pada perangkat saat ini dari pengaturan akun pihak pengandal.
Alur lintas perangkat adalah transportasi hibrida FIDO yang didefinisikan dalam CTAP 2.2. Browser desktop menunjukkan kode QR yang berisi rahasia sekali pakai. Ponsel memindainya dengan kamera dan kemudian terhubung kembali melalui Bluetooth Rendah Energi dengan jarak maksimal sekitar 3 meter. Setelah pengguna melakukan verifikasi pada ponsel, seremoni WebAuthn selesai di desktop. Baik Bluetooth maupun jarak dekat diwajibkan, jika tidak, alur akan gagal diam-diam dengan pesan "Ada yang salah" atau "Kami tidak dapat memasukkan Anda" yang umum.
Artikel terkait
Daftar isi