Struct SigningKey

pub struct SigningKey<D>
where
    D: Digest,
{ /* private fields */ }

Signing key for RSASSA-PKCS1-v1_5 signatures as described in RFC8017 § 8.2.

Implementations

impl<D> SigningKey<D>

where D: Digest + AssociatedOid,

pub fn new(key: RsaPrivateKey) -> Self

Create a new signing key with a prefix for the digest D.

pub fn random<R: CryptoRngCore + ?Sized>( rng: &mut R, bit_size: usize, ) -> Result<Self>

Generate a new signing key with a prefix for the digest D.

pub fn new_with_prefix(key: RsaPrivateKey) -> Self

👎Deprecated since 0.9.0: use SigningKey::new instead

Create a new signing key with a prefix for the digest D.

pub fn random_with_prefix<R: CryptoRngCore + ?Sized>( rng: &mut R, bit_size: usize, ) -> Result<Self>

👎Deprecated since 0.9.0: use SigningKey::random instead

Generate a new signing key with a prefix for the digest D.

impl<D> SigningKey<D>

where D: Digest,

pub fn new_unprefixed(key: RsaPrivateKey) -> Self

Create a new signing key from the give RSA private key with an empty prefix.

Note: unprefixed signatures are uncommon

In most cases you’ll want to use SigningKey::new.

pub fn random_unprefixed<R: CryptoRngCore + ?Sized>( rng: &mut R, bit_size: usize, ) -> Result<Self>

Generate a new signing key with an empty prefix.

Trait Implementations

impl<D> AsRef<RsaPrivateKey> for SigningKey<D>

where D: Digest,

fn as_ref(&self) -> &RsaPrivateKey

Converts this type into a shared reference of the (usually inferred) input type.

impl<D> AssociatedAlgorithmIdentifier for SigningKey<D>

where D: Digest,

const ALGORITHM_IDENTIFIER: AlgorithmIdentifierRef<'static> = pkcs1::ALGORITHM_ID

AlgorithmIdentifier for this structure.

type Params = AnyRef<'static>

Algorithm parameters.

impl<D> Clone for SigningKey<D>

where D: Digest + Clone,

fn clone(&self) -> SigningKey<D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<D> Debug for SigningKey<D>

where D: Digest + Debug,

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

Formats the value using the given formatter.

impl<D> DigestSigner<D, Signature> for SigningKey<D>

where D: Digest,

fn try_sign_digest(&self, digest: D) -> Result<Signature>

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

fn sign_digest(&self, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> EncodePrivateKey for SigningKey<D>

where D: Digest,

fn to_pkcs8_der(&self) -> Result<SecretDocument>

Serialize a SecretDocument containing a PKCS#8-encoded private key.

fn to_pkcs8_pem( &self, line_ending: LineEnding, ) -> Result<Zeroizing<String>, Error>

Serialize this private key as PEM-encoded PKCS#8 with the given LineEnding.

fn write_pkcs8_der_file(&self, path: impl AsRef<Path>) -> Result<(), Error>

Write ASN.1 DER-encoded PKCS#8 private key to the given path

fn write_pkcs8_pem_file( &self, path: impl AsRef<Path>, line_ending: LineEnding, ) -> Result<(), Error>

Write ASN.1 DER-encoded PKCS#8 private key to the given path

impl<D> From<RsaPrivateKey> for SigningKey<D>

where D: Digest,

fn from(key: RsaPrivateKey) -> Self

Converts to this type from the input type.

impl<D> From<SigningKey<D>> for RsaPrivateKey

where D: Digest,

fn from(key: SigningKey<D>) -> Self

Converts to this type from the input type.

impl<D> Keypair for SigningKey<D>

where D: Digest,

type VerifyingKey = VerifyingKey<D>

Verifying key type for this keypair.

fn verifying_key(&self) -> Self::VerifyingKey

Get the verifying key which can verify signatures produced by the signing key portion of this keypair.

impl<D> PrehashSigner<Signature> for SigningKey<D>

where D: Digest,

fn sign_prehash(&self, prehash: &[u8]) -> Result<Signature>

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

impl<D> RandomizedDigestSigner<D, Signature> for SigningKey<D>

where D: Digest,

fn try_sign_digest_with_rng( &self, rng: &mut impl CryptoRngCore, digest: D, ) -> Result<Signature>

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

fn sign_digest_with_rng(&self, rng: &mut impl CryptoRngCore, digest: D) -> S

Sign the given prehashed message Digest, returning a signature.

impl<D> RandomizedSigner<Signature> for SigningKey<D>

where D: Digest,

fn try_sign_with_rng( &self, rng: &mut impl CryptoRngCore, msg: &[u8], ) -> Result<Signature>

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

fn sign_with_rng(&self, rng: &mut impl CryptoRngCore, msg: &[u8]) -> S

Sign the given message and return a digital signature

impl<D> SignatureAlgorithmIdentifier for SigningKey<D>

where D: Digest + RsaSignatureAssociatedOid,

const SIGNATURE_ALGORITHM_IDENTIFIER: AlgorithmIdentifierRef<'static> = _

AlgorithmIdentifier for the corresponding singature system.

type Params = AnyRef<'static>

Algorithm parameters.

impl<D> Signer<Signature> for SigningKey<D>

where D: Digest,

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

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<D> TryFrom<PrivateKeyInfo<'_>> for SigningKey<D>

where D: Digest + AssociatedOid,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(private_key_info: PrivateKeyInfo<'_>) -> Result<Self>

Performs the conversion.

impl<D> ZeroizeOnDrop for SigningKey<D>

where D: Digest,