Struct AuthenticatorData 

pub struct AuthenticatorData {
    pub flags: Flags,
    pub counter: Option<u32>,
    pub attested_credential_data: Option<AttestedCredentialData>,
    pub extensions: Option<Value>,
    /* private fields */
}

The authenticator data structure encodes contextual bindings made by the authenticator. These bindings are controlled by the authenticator itself, and derive their trust from the WebAuthn Relying Party’s assessment of the security properties of the authenticator. In one extreme case, the authenticator may be embedded in the client, and its bindings may be no more trustworthy than the client data. At the other extreme, the authenticator may be a discrete entity with high-security hardware and software, connected to the client over a secure channel. In both cases, the Relying Party receives the authenticator data in the same format, and uses its knowledge of the authenticator to make trust decisions.

https://w3c.github.io/webauthn/#sctn-authenticator-data

Fields

flags: Flags

The flags representing the information of this credential. See Flags for more information.

counter: Option<u32>

Signature counter, 32-bit unsigned big-endian integer.

attested_credential_data: Option<AttestedCredentialData>

An optional AttestedCredentialData, if present, the Flags::AT needs to be set to true. See AttestedCredentialData for more information. Its length depends on the length of the credential ID and credential public key being attested.

extensions: Option<Value>

Extension-defined authenticator data. This is a CBOR RFC8949 map with extension identifiers as keys, and authenticator extension outputs as values. See WebAuthn Extensions for details.

This field uses the generic Value rather than a HashMap or the internal map representation for the following reasons:

1. Value does not implement Hash so it can’t be used as a key in a HashMap
2. Even if Vec<(Value, Value)> is the internal representation of a map in Value, it serializes to an array rather than a map, so in order to serialize it needs to be cloned into a Value::Map.

Instead we just assert that it is a map during deserialization.

Implementations

impl AuthenticatorData

pub fn new(rp_id: &str, counter: Option<u32>) -> Self

Create a new AuthenticatorData object for an RP ID and an optional counter.

The flags will be set to their default values.

pub fn set_attested_credential_data(self, acd: AttestedCredentialData) -> Self

Add an AttestedCredentialData to the authenticator data.

This sets the Flags::AT value as well.

pub fn set_flags(self, flags: Flags) -> Self

Set additional Flags to the authenticator data.

pub fn rp_id_hash(&self) -> &[u8]

Get read access to the RP ID hash

pub fn set_make_credential_extensions( self, extensions: Option<SignedExtensionOutputs>, ) -> Result<Self, Ctap2Error>

Set make credential authenticator extensions

pub fn set_assertion_extensions( self, extensions: Option<SignedExtensionOutputs>, ) -> Result<Self, Ctap2Error>

Set assertion authenticator extensions

impl AuthenticatorData

pub fn from_slice(v: &[u8]) -> Result<Self>

Decode an Authenticator data from a byte slice

pub fn to_vec(&self) -> Vec<u8>

Encode an authenticator data to its byte representation.

Trait Implementations

impl Debug for AuthenticatorData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuthenticatorData

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AuthenticatorData

fn eq(&self, other: &AuthenticatorData) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AuthenticatorData

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AuthenticatorData