You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
trezor-firmware/core/src/apps/webauthn
Martin Milata 2f987c3c5e
refactor(core/ui): remove dependencies on old layouts
2 years ago
..
metadata fix(core): remove tcDisplay from metadata/trezor-ctap2.json 3 years ago
res chore(common/defs/fido): add coinbase u2f 3 years ago
README.md docs: fix typos in comments 3 years ago
__init__.py refactor(core): move app registrations to a single handler function 3 years ago
add_resident_credential.py refactor(core/ui): remove dependencies on old layouts 2 years ago
common.py core/webauthn: Implement support for Ed25519 signatures in FIDO2. 4 years ago
credential.py style(core): full pyright-based type-checking 2 years ago
fido2.py refactor(core/ui): remove dependencies on old layouts 2 years ago
knownapps.py refactor(core): convert if/elif chains to if-chains 2 years ago
knownapps.py.mako refactor(core): convert if/elif chains to if-chains 2 years ago
list_resident_credentials.py refactor(core): fix imports and use new protobuf API in apps 3 years ago
remove_resident_credential.py refactor(core/ui): remove dependencies on old layouts 2 years ago
resident_credentials.py style(core): full pyright-based type-checking 2 years ago

README.md

WebAuthn

MAINTAINER = Andrew R. Kozlik andrew.kozlik@satoshilabs.com

AUTHOR = Andrew R. Kozlik andrew.kozlik@satoshilabs.com

REVIEWER = Jan Pochyla jan.pochyla@satoshilabs.com, Ondrej Vejpustek ondrej.vejpustek@satoshilabs.com


This app implements WebAuthn authenticator functionality in accordance with the following specifications:

Supported features and algorithms

This implementation supports client-side credential storage on the device and user verification by PIN entry, making the Trezor T a first-factor roaming authenticator usable for passwordless login.

User verification

The device is capable of verifying the user within itself by direct PIN entry via the touchscreen. Client PIN is not supported, because it is less secure than direct PIN verification. The authenticatorClientPIN command is therefore implemented only to the extent required by the hmac-secret extension. Namely, only the getKeyAgreement subcommand is supported.

Credential selection

Credential selection is supported directly on the device. The authenticatorGetNextAssertion command is therefore not implemented.

Public key credential algorithms

  • COSE algorithm ES256 (-7): ECDSA using the NIST P-256 curve with SHA-256.
  • COSE algorithm EdDSA (-8): Pure EdDSA using the Ed25519 curve.

Extensions

  • hmac-secret extension.

Attestation types

  • Basic attestation for login.microsoft.com.
  • Self attestation for all other sites.

AAGUID

The AAGUID is a 128-bit globally unique identifier indicating the type (e.g. make and model) of the authenticator. The AAGUID for Trezor T is d6d0bdc3-62ee-c4db-de8d-7a656e4a4487.

Certificates for basic attestation