---
url: 'https://www.corbado.com/id/blog/pemecahan-masalah-passkey-solusi'
title: 'Pemecahan Masalah Kunci Sandi: Solusi untuk Isu & Kesalahan Kunci Sandi'
description: 'Postingan blog ini membantu memahami pesan kesalahan kunci sandi (passkey) yang umum, penyebabnya, dan cara menyelesaikan masalah kunci sandi ini.'
lang: 'id'
author: 'Vincent Delitz'
date: '2025-06-20T15:07:52.455Z'
lastModified: '2026-09-16T06:06:39.937Z'
keywords: 'pemecahan masalah kunci sandi, kunci sandi tidak berfungsi, kesalahan kunci sandi, kunci sandi tidak berfungsi di iphone, kunci sandi tidak berfungsi di android, tidak ada kunci sandi yang tersedia, notallowederror kunci sandi, kesalahan webauthn'
category: 'Passkeys User Tips'
---

# Pemecahan Masalah Kunci Sandi: Solusi untuk Isu & Kesalahan Kunci Sandi

## Key Facts

- **Rantai Kunci iCloud (iCloud Keychain)** harus diaktifkan pada perangkat Apple yang
  menjalankan iOS 16 atau macOS Ventura atau yang lebih baru untuk menyimpan dan
  menyinkronkan kunci sandi. Aplikasi Passwords di iOS 18 adalah tempat pusat baru untuk
  mengelolanya.
- Properti WebAuthn **excludeCredentials** membatasi pendaftaran kunci sandi ganda per
  perangkat, memicu kesalahan "kunci sandi sudah ada".
- **Prompt kode QR** saat login berarti tidak ada kunci sandi di perangkat saat ini.
  Pengguna memindainya untuk mengautentikasi melalui ponsel cerdas yang telah terdaftar
  melalui transportasi hibrida.
- Penghapusan kunci sandi di sisi klien tanpa **penghapusan di sisi server** menyebabkan
  kesalahan "tidak ada kunci sandi yang cocok", karena server masih mengharapkan
  kredensial tersebut.
- Dukungan kunci sandi Android memerlukan **kunci layar** diaktifkan plus Android 9 atau
  yang lebih baru, dan sebagian besar browser memetakan kegagalan seremoni ke kesalahan
  umum **NotAllowedError**.

## 1. Pengantar

[Kunci sandi](https://www.corbado.com/id/glossary/cda) kini didukung oleh 20% dari 100 situs web teratas dunia
dan 53% konsumen secara global telah mengaktifkan [kunci sandi](https://www.corbado.com/id/glossary/cda) di
setidaknya satu akun, menurut
[FIDO Alliance Authentication Barometer 2024](https://fidoalliance.org/content/research/).
Amazon, [WhatsApp](https://www.corbado.com/blog/whatsapp-passkeys), [Coinbase](https://www.corbado.com/blog/coinbase-passkey),
[TikTok](https://www.corbado.com/blog/tiktok-passkeys), [Facebook](https://www.corbado.com/blog/facebook-passkeys),
[LinkedIn](https://www.corbado.com/blog/linkedin-passkeys), dan X/[Twitter](https://www.corbado.com/blog/x-twitter-passkeys) semuanya
telah meluncurkan dukungan sejak 2023.

[Spesifikasi W3C WebAuthn Level 3](https://www.w3.org/TR/webauthn-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](https://www.w3.org/TR/webauthn-3/#sctn-privacy-considerations).
Banyak pihak pengandal (relying parties) juga mendefinisikan pesan kesalahan mereka
sendiri, karena tidak banyak praktik terbaik yang didemonstrasikan selain dari
[panduan UX FIDO Alliance](https://fidoalliance.org/ux-guidelines/). 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](https://www.corbado.com/blog/how-to-enable-passkeys-ios) serta
[Android](https://www.corbado.com/blog/how-to-enable-passkeys-android) terbaru.

Jika "[kunci sandi](https://www.corbado.com/id/glossary/cda) google tidak berfungsi" di perangkat Anda,
pemeriksaan pertama adalah apakah browser, OS, dan
[layanan Google Play](https://www.corbado.com/id/blog/passkeys-brave-browser) semuanya berada pada build terbaru,
karena sebagian besar regresi diperbaiki dalam satu atau dua rilis.

## 2. Bagaimana Cara Kerja Kunci Sandi?

Kunci sandi adalah kredensial tanpa
[kata sandi](https://www.corbado.com/id/blog/cara-mengaktifkan-passkey-android) berdasarkan
[API WebAuthn](https://www.w3.org/TR/webauthn-3/) dan spesifikasi
[CTAP](https://www.corbado.com/id/glossary/ctap) 2.2 yang mendasarinya dari
[FIDO Alliance](https://www.corbado.com/glossary/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](https://fidoalliance.org/content/event/2024-authenticate-conference/).

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](https://www.corbado.com/faq/is-face-id-passkey), Touch ID, atau
[Windows Hello](https://www.corbado.com/glossary/windows-hello), menandatangani tantangan, dan mengembalikan
tanda tangan. Pihak pengandal memverifikasinya dengan kunci publik.

Karena kunci privat tidak pernah meninggalkan perangkat, [phishing](https://www.corbado.com/glossary/phishing)
dan penggunaan ulang [kata sandi](https://www.corbado.com/id/blog/cara-mengaktifkan-passkey-android) berhenti
bekerja sebagai vektor serangan. Dari sudut pandang pengguna, seluruh alur adalah satu
prompt biometrik.

## 3. Persyaratan Kunci Sandi

### 3.1 iOS atau macOS

**Rantai Kunci iCloud Diaktifkan:**

Rantai Kunci iCloud (iCloud Keychain) adalah lokasi penyimpanan untuk kredensial di
perangkat [Apple](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android) dan
disertakan pada [iOS](https://www.corbado.com/blog/how-to-enable-passkeys-ios) 16, iPadOS 16, dan macOS Ventura
13 atau yang lebih baru.
[Apple](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android) melaporkan sekitar 2,2
miliar perangkat aktif pada awal 2024, di mana lebih dari 90% menjalankan
[iOS](https://www.corbado.com/blog/how-to-enable-passkeys-ios) 16 atau yang lebih baru, menurut
[dasbor pengembang Apple](https://developer.apple.com/support/app-store/). 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](https://support.apple.com/guide/ipad/passkeys-passwords-devices-ipada39a7fa0/ipados#:~:text=If%20you%20didn%27t%20turn,then%20follow%20the%20onscreen%20instructions)).
Menurut [dokumentasi pengembang Apple](https://developer.apple.com/passkeys/), 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](https://www.corbado.com/blog/ios-18-passkeys-automatic-passkey-upgrades), penyimpanannya pindah ke
aplikasi **Passwords** khusus, itulah sebabnya beberapa prompt sekarang berbunyi
"Passwords" alih-alih "[iCloud Keychain](https://www.corbado.com/glossary/icloud-keychain)". Menurut
[dukungan Apple](https://support.apple.com/HT204085), pengguna pada build OS lama tidak
dapat membuat atau menggunakan kunci sandi sama sekali.

### 3.2 Windows

**Penyiapan Windows Hello:**

[Windows Hello](https://www.corbado.com/glossary/windows-hello) diperlukan untuk membuat atau menggunakan kunci
sandi di perangkat [Windows](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android) 10
dan [Windows 11](https://www.corbado.com/blog/passkeys-windows-11). Menurut
[dokumentasi kunci sandi Windows dari Microsoft](https://learn.microsoft.com/en-us/windows/security/identity-protection/passkeys/),
[Windows 11](https://www.corbado.com/blog/passkeys-windows-11) build 22631 (November 2024) mengirimkan UI kunci
sandi asli dan [Windows 11](https://www.corbado.com/blog/passkeys-windows-11) 25H2 (November 2025) menambahkan
dukungan untuk pengelola
[kunci sandi pihak ketiga](https://www.corbado.com/id/blog/penyedia-passkey-aaguid-adopsi) seperti
[1Password](https://www.corbado.com/blog/1password-passkeys-best-practices-analysis) dan
[Bitwarden](https://www.corbado.com/blog/passkey-analysis-bitwarden-developer-survey-2024).
[Windows Hello](https://www.corbado.com/glossary/windows-hello) menerima sidik jari, pemindaian wajah, atau PIN 6
digit. Konfigurasikan di bawah Pengaturan > Akun > Opsi masuk (baca selengkapnya
[di sini](https://support.microsoft.com/en-us/windows/learn-about-windows-hello-and-set-it-up-dae28983-8242-bb2a-d3d1-87c9d265a5f0)).

### 3.3 Android

**Android Versi 9 atau Lebih Baru:**

[Android](https://www.corbado.com/blog/how-to-enable-passkeys-android) 9 (Pie) diluncurkan pada 6 Agustus 2018
dan merupakan versi minimum untuk
[API Pengelola Kredensial (Credential Manager API)](https://developer.android.com/identity/sign-in/credential-manager).
Menurut [dasbor distribusi Android](https://developer.android.com/about/dashboards),
[Android](https://www.corbado.com/blog/how-to-enable-passkeys-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](https://www.corbado.com/id/blog/passkeys-brave-browser) 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](https://www.corbado.com/blog/native-app-passkeys) 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.

## 4. Kesalahan Kunci Sandi yang Umum, Penyebabnya, dan Pemecahan Masalah

Kami melacak sekitar 15 pola kesalahan berulang di seluruh klien iOS, Android, dan
[Windows](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android), 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](https://www.corbado.com/blog/how-to-use-apple-passwords), tidak ada kredensial yang tersedia,
[kode QR](https://www.corbado.com/id/blog/kode-qr-login-autentikasi) dan alur lintas perangkat, masalah spesifik
[Windows](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android), 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](https://www.w3.org/TR/webauthn-3/),
[spesifikasi FIDO Alliance](https://fidoalliance.org/specifications/), atau dokumentasi
platform yang relevan dari
[Apple](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android),
[Microsoft](https://learn.microsoft.com/en-us/windows/security/identity-protection/passkeys/),
dan
[Pengelola Kredensial Android](https://developer.android.com/identity/sign-in/credential-manager).

Sebelum membahas kesalahan satu per satu, berikut adalah cara untuk men-debug pengguna
kunci sandi tertentu dalam hitungan detik:

[Watch on YouTube](https://www.youtube.com/watch?v=1mQBtnjtNLw)

## 5. Kesalahan Rantai Kunci iCloud dan Aplikasi Apple Passwords

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](https://developer.apple.com/passkeys/). Pada
[iOS 18](https://www.corbado.com/blog/ios-18-passkeys-automatic-passkey-upgrades) penyimpanannya pindah ke
aplikasi **Passwords** yang baru, itulah sebabnya kata-katanya berubah.

### Pesan Kesalahan: Untuk menyimpan kunci sandi, Anda perlu mengaktifkan Rantai Kunci iCloud. Anda dapat mengaktifkan Rantai Kunci di panel ID Apple pada Pengaturan Sistem (To save a passkey, you need to enable iCloud Keychain. You can enable Keychain in the Apple ID pane of System Settings)

![Aktifkan Rantai Kunci iCloud Kunci Sandi](https://www.corbado.com/website-assets/65553708bd11bf05d145a0f3_enable_icloud_keychain_passkey_334fc7ae64.png)

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)**:

![Prompt Untuk menggunakan kunci sandi, Anda perlu mengaktifkan Rantai Kunci iCloud di iOS terbaru](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/IMG_0005_56857de86c.jpg)

- **Penyebab:** Rantai Kunci iCloud, lokasi penyimpanan untuk kredensial di perangkat
  Apple, tidak diaktifkan.
- **Solusi:** Aktifkan Rantai Kunci iCloud di panel ID Apple pada Pengaturan Sistem (atau
  Pengaturan > Akun Apple > iCloud >
  [Kata Sandi](https://www.corbado.com/id/blog/cara-mengaktifkan-passkey-android) dan Rantai Kunci pada
  [iOS 18](https://www.corbado.com/blog/ios-18-passkeys-automatic-passkey-upgrades)). Pastikan itu menyinkronkan
  antar perangkat Anda, jika tidak, kredensial hanya akan ada secara lokal.

### Pesan Kesalahan: Tidak ada kunci sandi yang cocok / Tidak ada kunci sandi yang cocok yang disimpan di Rantai Kunci iCloud Anda (There are no matching passkeys / There are no matching passkeys saved in your iCloud Keychain)

Pada iOS terbaru, prompt tersebut kini bermerek aplikasi **Passwords** baru dan berbunyi
"Tidak ada kunci sandi yang cocok yang disimpan di Passwords untuk ...":

![Prompt Tidak ada kunci sandi yang cocok yang disimpan di Passwords di iOS terbaru](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/ios_no_matching_passkeys_passwords_d7613bb2c4.png)

- **Penyebab:** Pengguna mencoba masuk dengan kredensial yang tidak disimpan di Rantai
  Kunci iCloud pada perangkat saat ini, atau sinkronisasi antar perangkat rusak.
- **Solusi:** Konfirmasikan bahwa Rantai Kunci iCloud diaktifkan pada setiap perangkat
  Apple yang digunakan oleh ID Apple yang sama. Jika kredensial ada di iPhone atau Mac
  lain tetapi tidak pada yang saat ini, paksa sinkronisasi Rantai Kunci 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.

## 6. Tidak Ada Kunci Sandi yang Tersedia dan Kesalahan Sudah Ada

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](https://www.corbado.com/glossary/allowcredentials) dan
[excludeCredentials](https://www.corbado.com/glossary/excludecredentials) mendorong sebagian besar perilaku ini
di sisi server.

### Pesan Kesalahan: Tidak ada kunci sandi yang tersedia. Tidak ada kunci sandi untuk Pihak Pengandal di perangkat ini (No passkeys available. There aren't any passkeys for Relying Party on this device)

![Tidak Ada Kunci Sandi Tersedia Pihak Pengandal](https://www.corbado.com/website-assets/6555372bb1d6b8f487e146a5_no_passkeys_available_relying_party_297ab7646a.png)

Di Android, kesalahan yang sama dimunculkan oleh
[layanan Google Play](https://www.corbado.com/id/blog/passkeys-brave-browser) dengan "Tidak ada kunci sandi yang
tersedia. Tidak ada kunci sandi untuk \<pihak pengandal&gt; di perangkat ini" dan opsi
cadangan "Gunakan perangkat lain":

![Prompt Tidak ada kunci sandi yang tersedia di layanan Google Play Android](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/android_no_passkeys_available_f511afdae5.png)

- **Penyebab:** Tidak ada kredensial yang cocok pada perangkat saat ini dan server
  WebAuthn tidak mengizinkan autentikator lintas platform mana pun. Pesan kesalahan yang
  sama juga muncul ketika pengguna telah menghapus kredensial lokal tetapi server masih
  mengharapkannya.
- **Solusi:** Verifikasi apakah ada kredensial di perangkat. Jika telah dihapus di
  pengaturan Rantai Kunci iCloud atau Google
  [Pengelola Kata Sandi](https://www.corbado.com/id/blog/pengujian-password-manager-pihak-ketiga-passkey-aplikasi)
  (Google Password Manager), hapus juga dari sisi server di pengaturan akun pihak
  pengandal. Jika tidak, server terus meminta kredensial yang hilang dan kesalahan akan
  terus muncul.

### Pesan Kesalahan: Kunci sandi sudah ada (atau pesan kesalahan serupa seperti yang ditentukan oleh pihak pengandal)

![Kesalahan Kunci Sandi Sudah Ada](https://www.corbado.com/website-assets/65553746feb3c94be9ef7bc6_passkey_already_exists_error_f2250d5175.png)

- **Penyebab:** Pendaftaran baru dicoba pada perangkat yang sudah memiliki kredensial
  untuk akun yang sama. Banyak pihak pengandal hanya mengizinkan satu kredensial per
  perangkat atau per ekosistem (mis. Rantai Kunci iCloud yang disinkronkan atau
  [1Password](https://www.corbado.com/blog/1password-passkeys-best-practices-analysis)) dengan menetapkan
  [excludeCredentials](https://www.corbado.com/glossary/excludecredentials) di server WebAuthn.
- **Solusi:** Gunakan kredensial yang ada, atau daftarkan yang baru dari perangkat yang
  berbeda. Alternatifnya, hapus kredensial lama di pengaturan akun pihak pengandal, lalu
  daftarkan yang baru.

### Pesan Kesalahan: Kami tidak dapat menemukan kunci sandi yang cocok (atau pesan serupa dari pihak pengandal)

![Kunci Sandi yang Cocok Tidak Ditemukan](https://www.corbado.com/website-assets/655537dafecc451ba3db8359_matching_passkey_not_found_fd8094dc71.png)

- **Penyebab:** Kredensial telah dihapus secara manual, baik di sisi klien maupun di sisi
  server. Bahkan jika kunci privat lokal masih ada, tidak adanya kunci publik yang cocok
  di server memicu kesalahan ini.
- **Solusi:** Masuk dari perangkat lain atau gunakan metode
  [autentikasi](https://www.corbado.com/id/blog/cara-menjadi-sepenuhnya-tanpa-password) cadangan. Kemudian buat
  kredensial baru dari pengaturan akun, yang akan membuat ulang pasangan klien-server.

## 7. Kesalahan Kode QR dan Masuk Lintas Perangkat

Alur [kode QR](https://www.corbado.com/id/blog/kode-qr-login-autentikasi) menggunakan **transportasi hibrida**
FIDO (juga disebut hibrida [CTAP](https://www.corbado.com/id/glossary/ctap) 2.2). Menurut
[spesifikasi CTAP FIDO](https://fidoalliance.org/specifications/), kedua perangkat
bertukar rahasia sekali pakai melalui [kode QR](https://www.corbado.com/id/blog/kode-qr-login-autentikasi) dan
kemudian berkomunikasi melalui Bluetooth Rendah Energi (Bluetooth Low
[Energy](https://www.corbado.com/passkeys-for-energy)) pada jarak maksimum sekitar 3 meter. Baik Bluetooth maupun
jarak dekat diperlukan, jika tidak, alur akan gagal secara diam-diam.

### Pesan Kesalahan: Saya melihat kode QR

![Masuk Kunci Sandi Kode QR](https://www.corbado.com/website-assets/6555375cd48902e4d09be98b_qr_code_passkey_login_a07239cd0d.png)

Pada iOS terbaru, lembar silang perangkat kode QR sekarang berbunyi "Pindai Kode QR.
Pindai kode QR ini dengan perangkat yang kompatibel untuk masuk ke ...":

![Prompt Pindai Kode QR untuk masuk kunci sandi lintas perangkat di iOS terbaru](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/IMG_0012_39a060a4a2.jpg)

Di Android,
[Pengelola Kredensial](https://developer.android.com/identity/sign-in/credential-manager)
memunculkan alur yang sama sebagai "Tidak ada info masuk yang tersedia" dengan opsi
**Tampilkan kode QR** dan cadangan untuk **Buka Google Pengelola Kata Sandi**:

![Prompt Tidak ada info masuk yang tersedia dengan opsi Tampilkan kode QR di Pengelola Kredensial Android](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/android_credential_manager_no_signin_f76cb63bb3.png)

- **Penyebab:** Kredensial terikat ke akun dan platform tertentu (perangkat atau akun
  platform yang disinkronkan awan seperti Rantai Kunci iCloud). Melihat kode QR berarti
  tidak ada kredensial di perangkat saat ini, meskipun pengguna sebelumnya mendaftarkan
  satu di iOS atau Android. Penyebab umum lainnya adalah bahwa server membatasi kredensial
  yang diterimanya melalui properti WebAuthn
  [AllowCredentials](https://www.corbado.com/glossary/allowcredentials) dan kredensial lokal yang tersedia tidak
  cocok.
- **Solusi:** Jika perangkat asli memiliki kamera, pindai kode QR untuk masuk melalui
  transportasi hibrida. Jika tidak, gunakan metode cadangan, masuk dan kemudian daftarkan
  kredensial baru untuk perangkat saat ini di pengaturan akun pihak pengandal.

### Pesan Kesalahan: Bluetooth diperlukan untuk masuk kunci sandi lintas perangkat

![Nyalakan Bluetooth untuk menggunakan kunci sandi Anda dari perangkat lain](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/turn_on_bleuthoot_ef0367e52c.png)

- **Penyebab:** Transportasi hibrida memerlukan Bluetooth Rendah Energi (Bluetooth Low
  [Energy](https://www.corbado.com/passkeys-for-energy)) di antara kedua perangkat. Jika Bluetooth dimatikan di
  PC atau ponsel, alur gagal secara diam-diam dengan pesan umum "Ada yang salah" atau
  "Kami tidak dapat memasukkan Anda".
- **Solusi:** Aktifkan Bluetooth pada kedua perangkat dan jaga agar keduanya berjarak
  kira-kira 3 meter satu sama lain, lalu coba lagi alur kode QR. Jika Bluetooth tidak
  dapat dihidupkan (misalnya kebijakan perusahaan atau perangkat keras yang lebih lama),
  gunakan info masuk cadangan dan kemudian daftarkan kredensial lokal perangkat sehingga
  info masuk berikutnya tidak lagi bergantung pada transportasi hibrida.

## 8. Kesalahan Khusus Windows

Build Windows telah mengirimkan beberapa regresi terkait kunci sandi selama 18 bulan
terakhir. Menurut
[dokumentasi kunci sandi Windows dari Microsoft](https://learn.microsoft.com/en-us/windows/security/identity-protection/passkeys/),
build 22631 (November 2024) menambahkan UI kunci sandi asli dan Windows 11 25H2
(November 2025) menambahkan dukungan pengelola
[kunci sandi pihak ketiga](https://www.corbado.com/id/blog/penyedia-passkey-aaguid-adopsi). Kedua pergeseran ini
mengatur ulang beberapa status Windows Hello.

### Pesan Kesalahan: Masukkan kunci keamanan Anda ke port USB (Insert your security key into the USB port)

![Masukkan Kunci Keamanan Kunci Sandi](https://www.corbado.com/website-assets/655537aef760155f523b0a5b_insert_security_key_passkey_3654cde82d.png)

- **Penyebab:**
  [Kunci keamanan perangkat keras](https://www.corbado.com/id/blog/kunci-keamanan-perangkat-keras-fido2-terbaik)
  (mis. [YubiKey](https://www.corbado.com/glossary/yubikey)) diperlukan karena perangkat tidak memiliki TPM atau
  Windows Hello dinonaktifkan. Prompt yang sama juga muncul di mesin tanpa Bluetooth yang
  tidak dapat menggunakan transportasi hibrida dan tidak memiliki kredensial lokal.
- **Solusi:** Masukkan kunci keamanan (mis. [YubiKey](https://www.corbado.com/glossary/yubikey)) ke dalam port
  USB. Untuk melewati kunci perangkat keras, aktifkan Windows Hello terlebih dahulu dan
  kemudian buat kredensial Windows Hello sebelum masuk berikutnya.

### Pesan Kesalahan: Kunci sandi akun Microsoft terus gagal setelah pembaruan Windows terbaru

![Kami tidak dapat memasukkan Anda: masuk kunci sandi akun Microsoft gagal di Windows](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/We_couldnt_sign_you_in_a1fe7f5294.jpg)

- **Penyebab:** Beberapa build Insider dan rilis Windows 11 telah merusak alur masuk akun
  Microsoft, yang muncul sebagai "Ada yang salah", "Kami tidak dapat memasukkan Anda",
  atau kegagalan diam-diam saat pembuatan. Akar penyebabnya biasanya adalah status Windows
  Hello yang rusak atau akun Microsoft yang awalnya dikonfigurasi dengan penyiapan lama.
- **Solusi:** Masuk dengan kata sandi plus MFA, hapus kredensial yang rusak di pengaturan
  [keamanan akun](https://www.corbado.com/id/blog/kata-sandi-rumit-akan-terpecahkan) Microsoft dan buat yang
  baru. Di akun lokal, cadangkan dan hapus folder NGC 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.

## 9. Kesalahan Khusus Android

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](https://developer.android.com/identity/sign-in/credential-manager).
Perangkat tanpa kunci layar tidak dapat mendaftarkan atau menggunakan kredensial sama
sekali.

### Pesan Kesalahan: Kunci sandi tidak ditawarkan (Passkeys not offered)

- **Penyebab:** Perangkat Android tidak memiliki kunci layar yang diaktifkan. Android
  memerlukan PIN, pola, kata sandi, atau kunci biometrik untuk membatasi akses ke
  kredensial, jadi tanpa kunci, opsinya disembunyikan.
- **Solusi:** Aktifkan kunci layar di bawah Pengaturan &gt; Keamanan di perangkat, lalu
  coba lagi. Pada build Android yang lebih lama, konfirmasikan juga bahwa layanan Google
  Play sudah yang terbaru.

## 10. Kesalahan WebAuthn dan Browser Umum

Kesalahan ini datang langsung dari browser atau lapisan
[WebAuthn](https://www.w3.org/TR/webauthn-3/). 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.

### Pesan Kesalahan: Tidak dapat membuat kunci sandi Anda / Kesalahan saat membuat Kunci Sandi / Kesalahan saat menghasilkan kunci sandi (Couldn't create your passkey / Error while creating Passkey / Error while generating passkey)

![Kesalahan Membuat Kunci Sandi](https://www.corbado.com/website-assets/655537c41f99840f8d3b4150_error_creating_passkey_539312c346.png)

- **Penyebab:** Kesalahan dalam aplikasi pihak pengandal, masalah server sementara, atau
  pengaturan perangkat yang tidak kompatibel (misalnya OS lama tanpa dukungan WebAuthn).
- **Solusi:** Mulai ulang aplikasi atau perangkat dan coba lagi. Jika masalah berlanjut,
  perbarui sistem operasi dan browser. Jika hanya satu pihak pengandal yang terpengaruh,
  masalahnya ada di sisi server dan percobaan ulang setelah beberapa menit biasanya
  menyelesaikannya.

### Pesan Kesalahan: Kunci sandi tidak tersedia di perangkat atau browser ini (Passkeys not available on this device or browser)

- **Penyebab:** Browser atau sistem operasi tidak mendukung WebAuthn atau pihak pengandal
  (mis. [PayPal](https://www.corbado.com/blog/paypal-passkeys)) memblokir kombinasi saat ini. Contoh umumnya
  adalah build browser lama, browser khusus tanpa dukungan WebAuthn, atau perangkat yang
  dikelola perusahaan dengan kebijakan restriktif.
- **Solusi:** Perbarui browser dan OS. Jika perangkat pada dasarnya tidak kompatibel,
  beralihlah ke perangkat yang didukung (Safari di iOS 16+, Chrome di Android 9+, Edge
  atau Chrome di Windows 10+).

### Pesan Kesalahan: Ada yang salah. Ada masalah saat masuk dengan kunci sandi Anda. (Something went wrong. There was a problem signing in with your passkey.)

![Masalah Masuk Kunci Sandi](https://www.corbado.com/website-assets/655537f290e69c5bac8c68e2_problem_signing_in_passkey_0c81ad9869.png)

- **Penyebab:** Salah memilih kredensial, gangguan jaringan sementara antara perangkat dan
  server, atau kerusakan di lapisan WebAuthn browser.
- **Solusi:** Konfirmasikan bahwa kredensial yang tepat telah dipilih dari prompt. Coba
  lagi setelah menunggu sebentar. Jika masalah berlanjut, periksa jaringan dan setel ulang
  kredensial dengan mendaftar ulang dari pengaturan akun.

### Pesan Kesalahan: Ada yang salah. Permintaan habis waktu. (Something went wrong. The request timed out.)

![Permintaan Kunci Sandi Habis Waktu](https://www.corbado.com/website-assets/6555380f13354914f49e2be5_passkey_request_timed_out_458426aa22.png)

- **Penyebab:** Server membutuhkan waktu terlalu lama untuk merespons, biasanya karena
  ketidakstabilan jaringan atau beban tinggi. Batas waktu WebAuthn default di Chrome
  adalah 60 detik, dengan maksimum 600 detik ditentukan oleh spesifikasi W3C.
- **Solusi:** Coba lagi pada koneksi yang stabil. Jika koneksinya bagus, masalahnya ada di
  sisi server dan mencoba lagi setelah beberapa menit biasanya akan menghilangkannya.
  Pihak pengandal dapat menaikkan batas waktu hingga batas W3C jika backend mereka secara
  teratur melampaui default.

### Pesan Kesalahan: NotAllowedError. Operasi habis waktu atau tidak diizinkan (NotAllowedError. The operation either timed out or was not allowed)

![Pendaftaran kunci sandi gagal: operasi berakhir waktu atau tidak diizinkan](https://s3.eu-central-1.amazonaws.com/corbado-cloud-staging-website-assets/passkey_registration_time_out_or_not_allowed_e98c70cbb9.png)

- **Penyebab:** [Kesalahan WebAuthn](https://www.corbado.com/id/blog/webauthn-errors) umum yang dikembalikan oleh
  browser ketika suatu seremoni tidak selesai. Ini bisa berarti pembatalan oleh pengguna,
  waktu habis, asal yang diblokir, tidak ada gestur pengguna, atau autentikator platform
  yang menolak permintaan tersebut. Browser menyembunyikan penyebab pastinya demi alasan
  privasi.
- **Solusi:** Tingkatkan waktu habis WebAuthn di sisi pihak pengandal dan pastikan
  panggilan dipicu oleh tindakan pengguna langsung seperti klik tombol. Pastikan bahwa ID
  pihak pengandal cocok dengan asalnya, bahwa pengguna memiliki autentikator yang dapat
  digunakan, dan bahwa tidak ada ekstensi browser yang mencegat panggilan tersebut.
  Pengguna akhir biasanya dapat memperbaikinya dengan membuka kunci perangkat,
  mengonfirmasi prompt biometrik atau PIN, lalu mencoba lagi.

## 11. Bagaimana Corbado Dapat Membantu

Jika Anda merilis kunci sandi, kesalahan-kesalahan ini menjadi bagian terbesar dari
antrean dukungan Anda, dan `NotAllowedError` sendiri menggabungkan pembatalan, waktu
habis, serta penolakan diam-diam oleh platform ke dalam satu ember.
[Corbado Observe](https://www.corbado.com/observe) berada di atas alur kunci sandi Anda saat ini dan mengubah
pengecualian browser mentah tersebut menjadi pola yang terklasifikasi dan dapat di-debug,
tanpa mengubah implementasi Anda.

[Video: Error overview](https://www.corbado.com/videos/features/error-overview.mp4) ([See Passkey Errors in Corbado Observe](https://www.corbado.com/observe/passkey-errors))

- **Klasifikasikan kesalahan berdasarkan konteks nyata:** setiap seremoni yang gagal
  ditangkap dengan jenis operasi, waktu-ke-kesalahan (time-to-error), dan lingkungan
  lengkap (OS, versi OS, browser, autentikator), sehingga `NotAllowedError` yang sama
  dapat diselesaikan menjadi "pengguna membatalkan" vs "waktu habis" vs "tidak ada
  kredensial", bukan hanya satu ember yang buram.
- **Lihat di mana kegagalan terpusat:** pola kesalahan dikelompokkan berdasarkan OS,
  browser, dan pesan dengan dampak keberhasilan, sehingga Anda dapat mengetahui secara
  sekilas apakah suatu lonjakan terisolasi pada satu kombinasi Android atau browser, bukan
  masalah global.
- **Debug pengguna tunggal dari tiket:** pencarian pengguna merekonstruksi alur yang
  tepat, sub-alur, peristiwa, dan lingkungan klien di balik satu upaya kunci sandi,
  mengubah laporan samar "ini tidak berfungsi" menjadi kasus yang dapat direproduksi.

Ini membuat pemecahan masalah konsumen tetap terikat pada perjalanan pengguna (user
journey) yang sebenarnya, sementara Anda mempertahankan tumpukan
[autentikasi](https://www.corbado.com/id/blog/cara-menjadi-sepenuhnya-tanpa-password) saat ini.

## 12. Kesimpulan

Kunci sandi menghilangkan kelas kerentanan kata sandi dengan mengganti rahasia bersama
dengan [kriptografi kunci publik](https://www.corbado.com/id/blog/webauthn-pubkeycredparams-credentialpublickey).
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](https://www.verizon.com/business/resources/reports/dbir/)
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](https://bit.ly/passkeys-community), dan
melakukan pemecahan masalah dengan benar sangat penting untuk
[adopsi](https://state-of-passkeys.io/) 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](https://passkeys.substack.com/)
atau bergabunglah dengan [komunitas di Slack](https://bit.ly/passkeys-community).

## Pertanyaan yang Sering Diajukan (FAQ)

### Mengapa saya diminta untuk memasukkan kunci keamanan alih-alih menggunakan kunci sandi saya?

Prompt ini muncul saat Windows Hello dinonaktifkan atau tidak ada TPM yang tersedia,
menyebabkan sistem kembali ke
[autentikasi](https://www.corbado.com/id/blog/cara-menjadi-sepenuhnya-tanpa-password)
[kunci keamanan perangkat keras](https://www.corbado.com/id/blog/kunci-keamanan-perangkat-keras-fido2-terbaik).
Mengaktifkan Windows Hello di pengaturan masuk perangkat Anda menyelesaikan masalah ini,
tetapi Anda harus terlebih dahulu membuat
[kunci sandi Windows](https://www.corbado.com/id/faq/di-mana-kunci-sandi-disimpan-di-windows) Hello sebelum
menggunakannya untuk login.

### Bagaimana cara memperbaiki kesalahan 'tidak dapat membuat kunci sandi Anda'?

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.

### Mengapa autentikasi kunci sandi terus habis waktu?

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.

### Apa yang terjadi jika saya menghapus kunci sandi di perangkat saya tetapi tidak di pengaturan akun?

[Menghapus kunci sandi](https://www.corbado.com/id/blog/cara-menghapus-kunci-sandi-apple-windows-android) dari
sisi klien, seperti dari Rantai Kunci iCloud atau Google
[Pengelola Kata Sandi](https://www.corbado.com/id/blog/pengujian-password-manager-pihak-ketiga-passkey-aplikasi),
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.

### Apa arti NotAllowedError saat menggunakan kunci sandi?

`NotAllowedError` adalah [kesalahan WebAuthn](https://www.corbado.com/id/blog/webauthn-errors) 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.

### Mengapa iOS menampilkan 'Tidak ada kunci sandi yang cocok yang disimpan di Passwords'?

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.

### Mengapa Android menampilkan 'Tidak ada info masuk yang tersedia untuk 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](https://www.corbado.com/id/blog/pengujian-password-manager-pihak-ketiga-passkey-aplikasi).
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.

### Bagaimana cara kerja alur kode QR kunci sandi lintas perangkat?

Alur lintas perangkat adalah **transportasi hibrida** FIDO yang didefinisikan dalam
[CTAP](https://www.corbado.com/id/glossary/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.