Add WebAuthn Passkey

On this page
Licensed Community plan required

This feature requires at least a Licensed Community plan as of version 1.52.0.

Available since 1.41.0

WebAuthn is disabled by default on a tenant. To toggle navigate to Tenants -> Edit Tenant -> WebAuthn . In order for the user to use the registered passkey, at least one WebAuthn workflow must be enabled for the tenant.

Enable WebAuthn on Tenant (Admin Facing)#

WebAuthn is disabled by default at the tenant level. It can be toggled on and off as needed.

The tenant WebAuthn tab with the Bootstrap passkey authentication settings highlighted.

In order for a user to use a passkey, one or more WebAuthn workflows must be enabled at the tenant or application level. See the WebAuthn Admin Guide for more details on configuration.

Add a Passkey from Account Management (User Facing)#

The account page with the edit button and the two-factor and passkey links.
  1. Navigate back to your account page
  2. Click Manage passkeys
  3. Click Add passkey
The self-service passkeys management page.
The Add passkey form with a display name entered.

Next,

  1. Enter a display name for the new passkey. You should choose something that helps you remember the authenticator and browser it was registered.
  2. Click the Submit button.
  3. Complete the WebAuthn registration with your authenticator of choice.

See It in Action (User Facing)#

You can use a registered passkey to complete enabled WebAuthn workflows. This example uses the bootstrap authentication workflow by clicking the Fingerprint, device or key button on the login screen.

The FusionAuth login page showing the Fingerprint, device or key button.
  1. Click the Fingerprint, device or key button to go to the WebAuthn bootstrap login page.
  2. Enter your username or email address.
  3. Click the Submit button.
  4. Complete the WebAuthn authentication with the registered passkey.
The WebAuthn bootstrap login page.

WebAuthn Bootstrap Prompt

WebAuthn Bootstrap Prompt