Struct SignatureWithOid 

pub struct SignatureWithOid<C: EcdsaCurve> { /* private fields */ }

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)

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.

Errors

Returns Error if oid does not start with 1.2.840.10045.4.

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.

Errors

Returns Error if the [AssociatedOid] for D is not one from the SHA2 family.

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

where D: AssociatedOid + Digest,

Parse a signature from fixed-with bytes.

Errors

Returns Error if Signature fails to parse, or if D is not a valid digest. See SignatureWithOid::new_with_digest documentation.

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

where D: AssociatedOid + Digest,

Parse a signature from a byte slice.

Errors

Returns Error if Signature fails to parse, or if D is not a valid digest. See SignatureWithOid::new_with_digest documentation.

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.

Errors

Returns Error if input failed to parse as an ASN.1 DER-encoded ECDSA signature, or if D is not a valid digest.

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.

Errors

Returns Error if input failed to parse as an ASN.1 DER-encoded ECDSA signature, or if D is not a valid digest.

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>

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: Copy + EcdsaCurve> Copy for SignatureWithOid<C>

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

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

Formats the value using the given formatter.

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>>>,

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: Eq + EcdsaCurve> Eq for SignatureWithOid<C>

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 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 SignatureBytes<C>

where C: EcdsaCurve,

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, 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,

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>>>,

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,

Available on crate feature digest only.

NOTE: this implementation assumes the default digest for the given elliptic curve as defined by 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>>>,

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: PartialEq + EcdsaCurve> StructuralPartialEq for SignatureWithOid<C>

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

where C: DigestAlgorithm, C::Digest: AssociatedOid,

Available on crate feature digest only.

NOTE: this implementation assumes the default digest for the given elliptic curve as defined by 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.