Struct SignatureWithOid 

pub struct SignatureWithOid<C: EcdsaCurve> {
    pub(crate) signature: Signature<C>,
    pub(crate) oid: ObjectIdentifier,
}

An extended Signature type which is parameterized by an ObjectIdentifier which identifies the ECDSA variant used by a particular signature.

Valid ObjectIdentifiers are defined in RFC5758 § 3.2:

• SHA-224: ECDSA_SHA224_OID (1.2.840.10045.4.3.1)
• SHA-256: ECDSA_SHA256_OID (1.2.840.10045.4.3.2)
• SHA-384: ECDSA_SHA384_OID (1.2.840.10045.4.3.3)
• SHA-512: ECDSA_SHA512_OID (1.2.840.10045.4.3.4)

Fields

signature: Signature<C>

Inner signature type.

oid: ObjectIdentifier

OID which identifies the ECDSA variant used.

MUST be one of the ECDSA algorithm variants as defined in RFC5758.

These OIDs begin with 1.2.840.10045.4.

Implementations

impl<C> SignatureWithOid<C>

where C: EcdsaCurve,

pub fn new(signature: Signature<C>, oid: ObjectIdentifier) -> Result<Self>

Create a new signature with an explicitly provided OID.

OID must begin with 1.2.840.10045.4, the RFC5758 OID prefix for ECDSA variants.

pub fn new_with_digest<D>(signature: Signature<C>) -> Result<Self>

where D: AssociatedOid + Digest,

Create a new signature, determining the OID from the given digest.

Supports SHA-2 family digests as enumerated in RFC5758 § 3.2, i.e. SHA-224, SHA-256, SHA-384, or SHA-512.

pub fn from_bytes_with_digest<D>(bytes: &SignatureBytes<C>) -> Result<Self>

where D: AssociatedOid + Digest, SignatureSize<C>: ArraySize,

Parse a signature from fixed-with bytes.

pub fn from_slice_with_digest<D>(slice: &[u8]) -> Result<Self>

where D: AssociatedOid + Digest, SignatureSize<C>: ArraySize,

Parse a signature from a byte slice.

pub fn from_der_with_digest<D>(der_bytes: &[u8]) -> Result<Self>

where D: AssociatedOid + Digest, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Parse a signature from ASN.1 DER and associate the given digest’s OID with it.

pub fn from_der_with_oid( der_bytes: &[u8], oid: ObjectIdentifier, ) -> Result<Self>

where MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Parse a signature from ASN.1 DER and associate the given OID with it.

pub fn signature(&self) -> &Signature<C>

Get the fixed-width ECDSA signature.

pub fn oid(&self) -> ObjectIdentifier

Get the ECDSA OID for this signature.

pub fn to_bytes(&self) -> SignatureBytes<C>

where SignatureSize<C>: ArraySize,

Serialize this signature as fixed-width bytes.

pub fn to_der(&self) -> Signature<C>

where MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Serialize this signature as ASN.1 DER.

Note that this includes only the r and s signature components, and not the OID.

See der::Signature documentation for more information.

Trait Implementations

impl<C: Clone + EcdsaCurve> Clone for SignatureWithOid<C>

fn clone(&self) -> SignatureWithOid<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C, D> DigestSigner<D, SignatureWithOid<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, D: AssociatedOid + Digest + FixedOutput, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize,

fn try_sign_digest<F: Fn(&mut D) -> Result<()>>( &self, f: F, ) -> Result<SignatureWithOid<C>>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest<F>(&self, f: F) -> S

where F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<C> DynAssociatedAlgorithmIdentifier for SignatureWithOid<C>

where C: EcdsaCurve,

Available on crate features alloc and pkcs8 only.

fn algorithm_identifier(&self) -> Result<AlgorithmIdentifierOwned>

AlgorithmIdentifier for this structure.

impl<C> From<&SignatureWithOid<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate features der and digest only.

fn from(sig: &SignatureWithOid<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> From<SignatureWithOid<C>> for SignatureBytes<C>

where C: EcdsaCurve, SignatureSize<C>: ArraySize,

Available on crate feature digest only.

fn from(signature: SignatureWithOid<C>) -> SignatureBytes<C>

Converts to this type from the input type.

impl<C> From<SignatureWithOid<C>> for Signature<C>

where C: EcdsaCurve,

Available on crate feature digest only.

fn from(sig: SignatureWithOid<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> From<SignatureWithOid<C>> for Signature<C>

where C: EcdsaCurve, MaxSize<C>: ArraySize, <FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,

Available on crate features der and digest only.

fn from(sig: SignatureWithOid<C>) -> Signature<C>

Converts to this type from the input type.

impl<C> Hash for SignatureWithOid<C>

where C: EcdsaCurve, SignatureSize<C>: ArraySize,

Available on crate feature digest only.

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<C> MultipartSigner<SignatureWithOid<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, C::Digest: AssociatedOid, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize,

fn try_multipart_sign(&self, msg: &[&[u8]]) -> Result<SignatureWithOid<C>>

Equivalent of Signer::try_sign() but the message is provided in non-contiguous byte slices.

fn multipart_sign(&self, msg: &[&[u8]]) -> S

Equivalent of Signer::sign() but the message is provided in non-contiguous byte slices.

impl<C: PartialEq + EcdsaCurve> PartialEq for SignatureWithOid<C>

fn eq(&self, other: &SignatureWithOid<C>) -> 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<C> SignatureEncoding for SignatureWithOid<C>

where C: DigestAlgorithm, C::Digest: AssociatedOid, SignatureSize<C>: ArraySize,

Available on crate features digest and hazmat only.

NOTE: this implementation assumes the default digest for the given elliptic curve as defined by hazmat::DigestAlgorithm.

When working with alternative digests, you will need to use e.g. SignatureWithOid::new_with_digest.

type Repr = Array<u8, <<C as Curve>::FieldBytesSize as Add>::Output>

Byte representation of a signature.

fn to_bytes(&self) -> Self::Repr

Encode signature as its byte representation.

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

Encode signature as a byte vector.

fn encoded_len(&self) -> usize

Get the length of this signature when encoded.

impl<C> Signer<SignatureWithOid<C>> for SigningKey<C>

where C: EcdsaCurve + CurveArithmetic + DigestAlgorithm, C::Digest: AssociatedOid, Scalar<C>: Invert<Output = CtOption<Scalar<C>>>, SignatureSize<C>: ArraySize,

fn try_sign(&self, msg: &[u8]) -> Result<SignatureWithOid<C>>

Attempt to sign the given message, returning a digital signature on success, or an error if something went wrong.

fn sign(&self, msg: &[u8]) -> S

Sign the given message and return a digital signature.

impl<C> TryFrom<&[u8]> for SignatureWithOid<C>

where C: DigestAlgorithm, C::Digest: AssociatedOid, SignatureSize<C>: ArraySize,

Available on crate features digest and hazmat only.

NOTE: this implementation assumes the default digest for the given elliptic curve as defined by hazmat::DigestAlgorithm.

When working with alternative digests, you will need to use e.g. SignatureWithOid::new_with_digest.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(slice: &[u8]) -> Result<Self>

Performs the conversion.

impl<C> Copy for SignatureWithOid<C>

where C: EcdsaCurve, SignatureSize<C>: ArraySize, <SignatureSize<C> as ArraySize>::ArrayType<u8>: Copy,

Available on crate feature digest only.

impl<C: Eq + EcdsaCurve> Eq for SignatureWithOid<C>

impl<C: EcdsaCurve> StructuralPartialEq for SignatureWithOid<C>