Skip to main content

Manage Passkeys

A passkey is a second authentication factor that you verify after your password when you sign in to Palette. Palette supports passkeys that use the WebAuthn standard. You create and store a passkey with an authenticator, such as a hardware security key, a password manager, or a platform authenticator (for example, Touch ID or Windows Hello).

After you add a passkey, Palette asks for it each time you sign in with an email address and password. Tenant administrators can also enforce passkeys, which requires every user who signs in to the tenant with a password to add one. Refer to Passkey Enforcement for more information. If you sign in through Single Sign-On (SSO), your identity provider handles multi-factor authentication instead.

Your passkeys belong to your user account, not to a tenant. If you belong to more than one tenant, you use the same passkeys in each one, including tenants that do not enforce passkeys.

danger

We recommend that you add at least two passkeys, in case you lose access to one. If you lose all your passkeys, you cannot sign in to any of your tenants with your password, and tenant administrators cannot reset your passkeys. Contact the support team to discuss recovery options.

Prerequisites​

  • A Palette user account that signs in with an email address and password.

  • An authenticator that supports WebAuthn, such as a hardware security key, a platform authenticator, or a password manager. We recommend that you use a hardware security key, such as a YubiKey, to create passkeys that meet the standards and regulations of your organization.

  • (Self-hosted Palette and Palette VerteX only) A Palette certificate that your browser trusts. If your instance uses a self-signed certificate or a certificate from a certificate authority (CA) that your browser does not trust, you might need to add the certificate to your operating system's trust store before you can add passkeys. Refer to the documentation of your operating system for guidance.

Add a Passkey​

  1. Log in to Palette.

  2. From the User Menu, select My Profile.

  3. Select the Security tab.

  4. Select Add passkey.

  5. In the Add a Passkey dialog box, enter a name for the passkey in Passkey nickname. The nickname must be 3 to 16 characters long and can contain letters, numbers, and spaces.

  6. Select Add Passkey.

  7. Follow the prompts from your browser to create the passkey with your authenticator. Depending on the authenticator, you might need to enter a PIN or scan your fingerprint.

The passkey appears in the list of passkeys on the Security tab.

Validate​

  1. Log out of Palette.

  2. Log in to Palette with your email address and password.

  3. After you enter your password, select the passkey you added, and verify it with your authenticator.

A successful sign-in confirms that the passkey works.

Delete a Passkey​

While any tenant you belong to enforces passkeys, you cannot delete your last passkey, and its trash can icon is unavailable. To replace it, add the new passkey first, and then delete the old one. If none of your tenants enforces passkeys, you can delete all your passkeys to sign in with your password only.

  1. Log in to Palette.

  2. From the User Menu, select My Profile.

  3. Select the Security tab.

  4. Select the trash can icon next to the passkey you want to delete.

  5. In the confirmation dialog box, select Delete.

Validate​

  1. From the User Menu, select My Profile.

  2. Select the Security tab.

  3. Verify that the deleted passkey is no longer listed.

Next Steps​

To learn what Palette asks for when you sign in, refer to Passkey Verification. To learn how passkeys affect API authentication, refer to Authorization Tokens and Passkeys.