Struct Signature 

pub struct Signature {
    pub id: String,
    pub algorithm: SignatureAlgorithm,
    pub signed_at: DateTime<Utc>,
    pub signer: SignerInfo,
    pub value: String,
    pub certificate_chain: Option<Vec<String>>,
    pub scope: Option<SignatureScope>,
    pub timestamp: Option<TrustedTimestamp>,
    pub webauthn: Option<WebAuthnSignature>,
}

Available on crate feature signatures only.

A digital signature.

Fields

id: String

Unique signature identifier.

algorithm: SignatureAlgorithm

Signature algorithm.

signed_at: DateTime<Utc>

Signing timestamp.

signer: SignerInfo

Signer information.

value: String

Base64-encoded signature value.

For standard signatures, this contains the signature bytes. For WebAuthn signatures, this may be empty if webauthn is present.

certificate_chain: Option<Vec<String>>

Optional certificate chain.

scope: Option<SignatureScope>

Optional signature scope for layout attestation.

When present, the signature covers the scope object (serialized with JCS) instead of just the document ID. This allows signatures to attest to specific layout renditions in addition to the semantic content.

timestamp: Option<TrustedTimestamp>

Optional RFC 3161 trusted timestamp token.

webauthn: Option<WebAuthnSignature>

Optional WebAuthn/FIDO2 signature data.

When present, this contains the full WebAuthn assertion data instead of using the value field. The document ID is used as the challenge for WebAuthn verification.

Implementations

impl Signature

pub fn new( id: impl Into<String>, algorithm: SignatureAlgorithm, signer: SignerInfo, value: impl Into<String>, ) -> Self

Create a new signature.

pub fn new_webauthn( id: impl Into<String>, signer: SignerInfo, webauthn: WebAuthnSignature, ) -> Self

Create a new WebAuthn signature.

WebAuthn signatures use ES256 algorithm and store the full assertion data rather than a simple signature value.

pub fn with_scope(self, scope: SignatureScope) -> Self

Set the signature scope for layout attestation.

pub fn with_timestamp(self, timestamp: TrustedTimestamp) -> Self

Set the trusted timestamp for this signature.

pub fn is_scoped(&self) -> bool

Check if this signature has a scope (scoped signature).

pub fn is_webauthn(&self) -> bool

Check if this is a WebAuthn signature.

pub fn webauthn_data(&self) -> Option<&WebAuthnSignature>

Get the WebAuthn signature data, if present.

Trait Implementations

impl Clone for Signature

fn clone(&self) -> Signature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Signature

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Signature

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Signature

fn eq(&self, other: &Signature) -> 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 Signature

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Signature

impl StructuralPartialEq for Signature