Passkey: Authentication Guide

Authenticating with a previously created Passkey is a three-step process.

1. Fetch the Request Options from the Server.
2. Retrieve the Passkey using the Request Options.
3. Post the Assertion Response from an authenticator to the Server.

Who is this for?

• Wallets/Credential Managers that want to adopt Liquid Auth.
• Ecosystems that want to leverage Liquid Auth for their networks.

🧮 Options

Note

Only passkeys that have been previously registered with the liquid extension are supported.

PublicKeyCredentialRequestOptions are used to retrieve existing Passkey and are generated by the service. The URI for this request is /assertion/request/:credId using the POST method.

Android: Options Learn how to get options for an existing Passkey.

Browser: Options Learn how to get options for an existing Passkey.

🎉 Retrieving

Getting the existing Passkey from an authenticator can vary depending on the platform. Most platforms will accept the Request Options and return an AuthenticatorAssertionResponse.

Android: Retreiving Learn how to use the options to retreive a Passkey.

Browser: Retreiving Learn how to use the options to retreive a Passkey.

🚚 Response

Note

The liquid extension can be optionally be used to create peer-to-peer connections.

Registering a new Passkey with the service. Prove the authenticity of the Passkey by sending the Attestation Response to the service. The URI for this request is /assertion/response using the POST method.

Android: Response Learn how to use the options to retreive a Passkey.

Browser: Response Learn how to use the options to retreive a Passkey.