Skip to main content

Passkeys

Passkeys (FIDO2 and WebAuthn) let your users log in without a password. A passkey is a unique digital key held on the user's device and confirmed with a fingerprint, face recognition or the device PIN, which protects the account from phishing and stolen passwords.

Passkeys are part of the free plugin since version 4.4. If you also use AJAX Auth Pro, update it to version 2.1 or later.

info

This page covers the basics to get you started, it is not a full reference yet.

Requirements​

  • Your site must be served over HTTPS, passkeys require a secure connection to work.
  • The visitor's browser must support passkeys. Visitors on a browser with no support, or limited support, are told so.

Enabling Passkeys​

  1. Visit the WP Dashboard > Settings > Login With Ajax > Security tab and scroll down to the Passkeys (FIDO2 & Webauth) section.
  2. Check the Enable Passkeys checkbox.
  3. If you'd like passkeys to count as a 2FA method, check Enable as a 2FA method?. A user who logs in with a regular password can then verify their identity with their passkey.
  4. Save your settings.

Registering a Passkey​

Each user registers their own passkeys. They can do this from their WordPress profile page, or on any page where you add the [lwa_passkeys_editor] shortcode (the user must be logged in to see it). A passkey can be given a name, which is only for the user's own reference.

Once a user has a passkey, they can choose Login with Passkeys on the login form and confirm on their device.

Disabling Passkeys​

If you disable passkeys later, users who have set one up will no longer be able to log in that way. They fall back to the other enabled methods, or to their regular username and password.