Struct ecdsa::SignatureWithOid
source · pub struct SignatureWithOid<C: EcdsaCurve> { /* private fields */ }
digest
only.Expand description
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§
source§impl<C> SignatureWithOid<C>where
C: EcdsaCurve,
impl<C> SignatureWithOid<C>where
C: EcdsaCurve,
sourcepub fn new(signature: Signature<C>, oid: ObjectIdentifier) -> Result<Self>
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.
sourcepub fn new_with_digest<D>(signature: Signature<C>) -> Result<Self>where
D: AssociatedOid + Digest,
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.
sourcepub fn from_bytes_with_digest<D>(bytes: &SignatureBytes<C>) -> Result<Self>where
D: AssociatedOid + Digest,
SignatureSize<C>: ArraySize,
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.
sourcepub fn from_slice_with_digest<D>(slice: &[u8]) -> Result<Self>where
D: AssociatedOid + Digest,
SignatureSize<C>: ArraySize,
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.
sourcepub 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,
Available on crate feature der
only.
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,
der
only.Parse a signature from ASN.1 DER and associate the given digest’s OID with it.
sourcepub fn from_der_with_oid(
der_bytes: &[u8],
oid: ObjectIdentifier
) -> Result<Self>
Available on crate feature der
only.
pub fn from_der_with_oid( der_bytes: &[u8], oid: ObjectIdentifier ) -> Result<Self>
der
only.Parse a signature from ASN.1 DER and associate the given OID with it.
sourcepub fn to_bytes(&self) -> SignatureBytes<C>where
SignatureSize<C>: ArraySize,
pub fn to_bytes(&self) -> SignatureBytes<C>where
SignatureSize<C>: ArraySize,
Serialize this signature as fixed-width bytes.
sourcepub fn to_der(&self) -> Signature<C>
Available on crate feature der
only.
pub fn to_der(&self) -> Signature<C>
der
only.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§
source§impl<C: Clone + EcdsaCurve> Clone for SignatureWithOid<C>
impl<C: Clone + EcdsaCurve> Clone for SignatureWithOid<C>
source§fn clone(&self) -> SignatureWithOid<C>
fn clone(&self) -> SignatureWithOid<C>
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl<C, D> DigestSigner<D, SignatureWithOid<C>> for SigningKey<C>where
C: EcdsaCurve + CurveArithmetic + DigestPrimitive,
D: AssociatedOid + Digest + FixedOutput,
Scalar<C>: Invert<Output = CtOption<Scalar<C>>>,
SignatureSize<C>: ArraySize,
Available on crate feature signing
only.
impl<C, D> DigestSigner<D, SignatureWithOid<C>> for SigningKey<C>where
C: EcdsaCurve + CurveArithmetic + DigestPrimitive,
D: AssociatedOid + Digest + FixedOutput,
Scalar<C>: Invert<Output = CtOption<Scalar<C>>>,
SignatureSize<C>: ArraySize,
signing
only.source§fn try_sign_digest(&self, msg_digest: D) -> Result<SignatureWithOid<C>>
fn try_sign_digest(&self, msg_digest: D) -> Result<SignatureWithOid<C>>
Digest
, returning a
digital signature on success, or an error if something went wrong.source§fn sign_digest(&self, digest: D) -> S
fn sign_digest(&self, digest: D) -> S
source§impl<C> DynAssociatedAlgorithmIdentifier for SignatureWithOid<C>where
C: EcdsaCurve,
Available on crate features alloc
and pkcs8
only.
impl<C> DynAssociatedAlgorithmIdentifier for SignatureWithOid<C>where
C: EcdsaCurve,
alloc
and pkcs8
only.source§fn algorithm_identifier(&self) -> Result<AlgorithmIdentifierOwned>
fn algorithm_identifier(&self) -> Result<AlgorithmIdentifierOwned>
AlgorithmIdentifier
for this structure.source§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 feature der
only.
impl<C> From<&SignatureWithOid<C>> for Signature<C>where
C: EcdsaCurve,
MaxSize<C>: ArraySize,
<FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,
der
only.source§fn from(sig: &SignatureWithOid<C>) -> Signature<C>
fn from(sig: &SignatureWithOid<C>) -> Signature<C>
source§impl<C> From<SignatureWithOid<C>> for SignatureBytes<C>where
C: EcdsaCurve,
SignatureSize<C>: ArraySize,
impl<C> From<SignatureWithOid<C>> for SignatureBytes<C>where
C: EcdsaCurve,
SignatureSize<C>: ArraySize,
source§fn from(signature: SignatureWithOid<C>) -> SignatureBytes<C>
fn from(signature: SignatureWithOid<C>) -> SignatureBytes<C>
source§impl<C> From<SignatureWithOid<C>> for Signature<C>where
C: EcdsaCurve,
impl<C> From<SignatureWithOid<C>> for Signature<C>where
C: EcdsaCurve,
source§fn from(sig: SignatureWithOid<C>) -> Signature<C>
fn from(sig: SignatureWithOid<C>) -> Signature<C>
source§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 feature der
only.
impl<C> From<SignatureWithOid<C>> for Signature<C>where
C: EcdsaCurve,
MaxSize<C>: ArraySize,
<FieldBytesSize<C> as Add>::Output: Add<MaxOverhead> + ArraySize,
der
only.source§fn from(sig: SignatureWithOid<C>) -> Signature<C>
fn from(sig: SignatureWithOid<C>) -> Signature<C>
source§impl<C: PartialEq + EcdsaCurve> PartialEq for SignatureWithOid<C>
impl<C: PartialEq + EcdsaCurve> PartialEq for SignatureWithOid<C>
source§fn eq(&self, other: &SignatureWithOid<C>) -> bool
fn eq(&self, other: &SignatureWithOid<C>) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl<C> SignatureEncoding for SignatureWithOid<C>
Available on crate feature hazmat
only.
impl<C> SignatureEncoding for SignatureWithOid<C>
hazmat
only.NOTE: this implementation assumes the default digest for the given elliptic
curve as defined by hazmat::DigestPrimitive
.
When working with alternative digests, you will need to use e.g.
SignatureWithOid::new_with_digest
.
source§impl<C> Signer<SignatureWithOid<C>> for SigningKey<C>where
C: EcdsaCurve + CurveArithmetic + DigestPrimitive,
C::Digest: AssociatedOid,
Scalar<C>: Invert<Output = CtOption<Scalar<C>>>,
SignatureSize<C>: ArraySize,
Available on crate feature signing
only.
impl<C> Signer<SignatureWithOid<C>> for SigningKey<C>where
C: EcdsaCurve + CurveArithmetic + DigestPrimitive,
C::Digest: AssociatedOid,
Scalar<C>: Invert<Output = CtOption<Scalar<C>>>,
SignatureSize<C>: ArraySize,
signing
only.source§impl<C> TryFrom<&[u8]> for SignatureWithOid<C>
Available on crate feature hazmat
only.
impl<C> TryFrom<&[u8]> for SignatureWithOid<C>
hazmat
only.NOTE: this implementation assumes the default digest for the given elliptic
curve as defined by hazmat::DigestPrimitive
.
When working with alternative digests, you will need to use e.g.
SignatureWithOid::new_with_digest
.
source§impl<C> Verifier<SignatureWithOid<C>> for VerifyingKey<C>
Available on crate features verifying
and sha2
only.
impl<C> Verifier<SignatureWithOid<C>> for VerifyingKey<C>
verifying
and sha2
only.