Passkeys in Tesseral

Passkeys offer a secure authentication method for Users in Tesseral

What is a Passkey?

A Passkey is a modern, secure alternative to passwords, based on public-key cryptography. It enables Users to authenticate using their devices existing advanced authentication methods (such as biometric authentication).

When a User registers a Passkey, Tesseral stores a public key and a few additional metadata fields. The corresponding private key stays on the User’s device. During login, Tesseral verifies the User’s identity by confirming a cryptographic signature generated by the private key.

Within Tesseral, Passkeys are secondary authentication factors, meaning that they are used in conjunction with a primary authentication method (like a password or SSO). This two-factor approach enhances security by requiring both something the User knows (the primary factor) and something the User has (the Passkey).

Properties of Passkeys

Passkeys in Tesseral are associated with Users and expose the following properties:

Passkeys and Users

Each Passkey is linked to a single User through the userId field. Users can register multiple Passkeys, typically one per device. When a User authenticates, Tesseral verifies the signature using the public key associated with their Passkey.

This allows seamless, secure sign-in across different devices and sessions.

Learn more about Users here.

Passkeys and Authentication

Tesseral supports Passkeys via WebAuthn-compatible flows. This includes support for biometric authenticators, security keys, and platform authenticators across iOS, Android, Windows, macOS, and Linux.

Passkeys help protect against phishing, credential stuffing, and other common attack vectors.

Top-level properties of Passkeys

ID

Each Passkey has a unique identifier in Tesseral, represented by the id field. Passkey IDs always begin with the prefix passkey_.

Example: passkey_2mk0zv3qt9fdn2d5gq8ae13yh

User ID

The userId field identifies the User to whom the Passkey belongs. This must match the ID of an existing Tesseral User (e.g. user_83n6pr2lz5tmgdc7w45j1ybm8).

Create time

The createTime field is a timestamp indicating when the Passkey was first registered with Tesseral.

Update time

The updateTime field records the most recent time the Passkey record was modified—for example, due to changes in metadata or status.

Disabled

The optional disabled field is a boolean flag indicating whether the Passkey has been disabled. A disabled Passkey cannot be used for authentication but remains in the system for auditing purposes.

Credential ID

The credentialId field contains a binary value uniquely identifying the credential. This is used during the authentication ceremony to look up the correct Passkey.

Public key

The publicKeyPkix field contains the PEM-encoded PKIX public key associated with the Passkey. This key is used to verify authentication assertions from the User’s device.

Example:

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
-----END PUBLIC KEY-----

AAGUID

The aaguid (Authenticator Attestation GUID) identifies the model of the authenticator used to create the Passkey. It can be useful for auditing or applying policies based on device type.

Relying party ID

The rpId represents the relying party (RP) for which the Passkey is valid. In most cases, this corresponds to your Tesseral Vault domain (e.g. project_xxxxxxxx.tesseral.app, vault.yourcompanydomain.com).