Updating passkeys on a user's device (updateUserDetails)

TL;DR

You can update a passkey username on a local device by calling updateUserDetails in your frontend code. This is useful when a user changes their account identifier.

Becomes…

Note

Changing a passkey username has no impact on the user’s account identifier; it’s purely for display purposes. You will identify the user based on their userId or authenticatorId, which remain unchanged.

Updating the username on the device

Use the updateUserDetails function in your frontend code to perform local (device) updates:

frontend/passkeys.ts

import {
  isPasskeyUpdateSupport,
  updateUserDetails
} from "@passlock/client";

const username = "newUsername@example.com";
const displayName = "My new username";

if (isPasskeyUpdateSupport()) {
  // this will update the names in the user's password manager
  await updateUserDetails({
    tenancyId,
    passkeyId,
    username,
    displayName
  });
}

Note

Local (device) passkey updates rely on WebAuthn signals, a relatively new extension to the Web Authentication API. Not all browsers support signals, which is why you should test for support, falling back to informing the user what they should do if you can’t perform the operation programmatically.