Flutter: Register a passkey

Registers a new passkey (WebAuthn credential) for the signed in user.

• Available on supabase_flutter 2.15.0 and later as an extension on GoTrueClient.
• Drives the full WebAuthn ceremony end to end: starts the registration with the Supabase server, calls the authenticator you supply to create a credential on the device, and verifies it with the server.
• Requires a signed in (non-anonymous) user. If the user has verified MFA factors, the session has to be at aal2 to manage passkeys.
• supabase_flutter does not depend on a passkey plugin directly. Pass an implementation of PasskeyAuthenticatorInterface, such as the passkeys plugin's PasskeyAuthenticator (since passkeys 2.21.0).
• For native flows or custom UI, use the lower-level auth.passkey namespace instead.
• Passkeys are a BETA feature and must be enabled for your project in the Supabase Dashboard under Authentication > Configuration > Passkeys.

Parameters

• authenticator

  (Required)

  Performs the platform passkey ceremony (FaceID/TouchID/security key). For example, a `PasskeyAuthenticator` from the `passkeys` package.

Examples

Register a passkey for the current user

import 'package:passkeys/authenticator.dart';

final authenticator = PasskeyAuthenticator();

final Passkey passkey = await supabase.auth.registerPasskey(authenticator);