Struct passkey_types::webauthn::CollectedClientData

pub struct CollectedClientData {
    pub ty: ClientDataType,
    pub challenge: String,
    pub origin: String,
    pub cross_origin: Option<bool>,
    pub unknown_keys: IndexMap<String, Value>,
}

The client data represents the contextual bindings of both the Relying Party and the client. It is a key-value mapping whose keys are strings. Values can be any type that has a valid encoding in JSON.

Note: The CollectedClientData may be extended in the future. Therefore it’s critical when parsing to be tolerant of unknown keys and of any reordering of the keys

This struct conforms to the JSON byte serialization format expected of CollectedClientData, detailed in section 5.8.1.1 Serialization of the WebAuthn spec. Namely the following requirements:

• type, challenge, origin, crossOrigin must always be present in the serialized format in that order.
• Any extra parameters must keep the order in which they were used in the signature, hence the use of IndexMap.

https://w3c.github.io/webauthn/#dictionary-client-data

Fields

ty: ClientDataType

This member contains the value ClientDataType::Create when creating new credentials, and ClientDataType::Get when getting an assertion from an existing credential. The purpose of this member is to prevent certain types of signature confusion attacks (where an attacker substitutes one legitimate signature for another).

challenge: String

This member contains the base64url encoding of the challenge provided by the Relying Party. See the Cryptographic Challenges security consideration.

origin: String

This member contains the fully qualified origin of the requester, as provided to the authenticator by the client, in the syntax defined by RFC6454.

cross_origin: Option<bool>

This OPTIONAL member contains the inverse of the sameOriginWithAncestors argument value that was passed into the internal method

unknown_keys: IndexMap<String, Value>

CollectedClientData can be extended in the future, this accounts for unknown keys Uses an IndexMap to preserve order of keys for JSON byte serialization

Trait Implementations

impl Clone for CollectedClientData

fn clone(&self) -> CollectedClientData

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CollectedClientData

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CollectedClientData

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CollectedClientData

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.