docs: add webauthn / passkey troubleshoot

ory · Nov 12, 2024 · e31b44c · e31b44c
1 parent 4d28f84
commit e31b44c
Showing 1 changed file with 20 additions and 0 deletions.
diff --git a/docs/troubleshooting/45_passkeys-webauthn-security-error.mdx b/docs/troubleshooting/45_passkeys-webauthn-security-error.mdx
@@ -0,0 +1,20 @@
+---
+id: passkeys-webauthn-security-error
+title: SecurityError when using WebAuthn or PassKeys
+sidebar_label: WebAuthn / PassKeys SecurityError
+---
+
+## Relying party ID mismatch
+
+> The relying party ID is not a registrable domain suffix of, nor equal to the current domain. Subsequently, an attempt to fetch
+> the .well-known/webauthn resource of the claimed RP ID failed.
+
+### Solve relying party ID mismatch
+
+The error message indicates that the relying party ID (RP ID) is not a registrable domain suffix of, nor equal to the current
+domain. This error occurs when the RP ID is not a valid domain or subdomain.
+
+To resolve this issue, ensure that the RP ID is a valid domain or subdomain. If you are using a subdomain, ensure that the RP ID
+is a registrable domain suffix of the current domain.
+
+TODO: Add more information on how to fix this issue.