Struct pkcs1::RsaPrivateKey

pub struct RsaPrivateKey<'a> {
    pub modulus: UIntBytes<'a>,
    pub public_exponent: UIntBytes<'a>,
    pub private_exponent: UIntBytes<'a>,
    pub prime1: UIntBytes<'a>,
    pub prime2: UIntBytes<'a>,
    pub exponent1: UIntBytes<'a>,
    pub exponent2: UIntBytes<'a>,
    pub coefficient: UIntBytes<'a>,
    pub other_prime_infos: Option<OtherPrimeInfos<'a>>,
}

PKCS#1 RSA Private Keys as defined in RFC 8017 Appendix 1.2.

ASN.1 structure containing a serialized RSA private key:

RSAPrivateKey ::= SEQUENCE {
    version           Version,
    modulus           INTEGER,  -- n
    publicExponent    INTEGER,  -- e
    privateExponent   INTEGER,  -- d
    prime1            INTEGER,  -- p
    prime2            INTEGER,  -- q
    exponent1         INTEGER,  -- d mod (p-1)
    exponent2         INTEGER,  -- d mod (q-1)
    coefficient       INTEGER,  -- (inverse of q) mod p
    otherPrimeInfos   OtherPrimeInfos OPTIONAL
}

Note: the version field is selected automatically based on the absence or presence of the other_prime_infos field.

Fields

modulus: UIntBytes<'a>

n: RSA modulus.

public_exponent: UIntBytes<'a>

e: RSA public exponent.

private_exponent: UIntBytes<'a>

d: RSA private exponent.

prime1: UIntBytes<'a>

p: first prime factor of n.

prime2: UIntBytes<'a>

q: Second prime factor of n.

exponent1: UIntBytes<'a>

First exponent: d mod (p-1).

exponent2: UIntBytes<'a>

Second exponent: d mod (q-1).

coefficient: UIntBytes<'a>

CRT coefficient: (inverse of q) mod p.

other_prime_infos: Option<OtherPrimeInfos<'a>>

Additional primes r_3, …, r_u, in order, if this is a multi-prime RSA key (i.e. version is multi).

Implementations

impl<'a> RsaPrivateKey<'a>

pub fn public_key(&self) -> RsaPublicKey<'a>

Get the public key that corresponds to this RsaPrivateKey.

pub fn version(&self) -> Version

Get the Version for this key.

Determined by the presence or absence of the RsaPrivateKey::other_prime_infos field.

pub fn to_der(&self) -> Result<RsaPrivateKeyDocument>

Encode this RsaPrivateKey as ASN.1 DER.

pub fn to_pem(&self, line_ending: LineEnding) -> Result<Zeroizing<String>>

Encode this RsaPrivateKey as PEM-encoded ASN.1 DER using the given LineEnding.

Trait Implementations

impl<'a> Clone for RsaPrivateKey<'a>

fn clone(&self) -> RsaPrivateKey<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RsaPrivateKey<'a>

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

Formats the value using the given formatter.

impl<'a> Decodable<'a> for RsaPrivateKey<'a>

fn decode(decoder: &mut Decoder<'a>) -> Result<Self>

Attempt to decode this message using the provided decoder.

fn from_der(bytes: &'a [u8]) -> Result<Self, Error>

Parse Self from the provided DER-encoded byte slice.

impl<'a> From<&RsaPrivateKey<'a>> for RsaPublicKey<'a>

fn from(private_key: &RsaPrivateKey<'a>) -> RsaPublicKey<'a>

Converts to this type from the input type.

impl<'a> From<RsaPrivateKey<'a>> for RsaPublicKey<'a>

fn from(private_key: RsaPrivateKey<'a>) -> RsaPublicKey<'a>

Converts to this type from the input type.

impl<'a> Sequence<'a> for RsaPrivateKey<'a>

fn fields<F, T>(&self, f: F) -> Result<T>

where F: FnOnce(&[&dyn Encodable]) -> Result<T>,

Call the provided function with a slice of Encodable trait objects representing the fields of this SEQUENCE.

impl<'a> TryFrom<&'a [u8]> for RsaPrivateKey<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &'a [u8]) -> Result<Self>

Performs the conversion.

impl TryFrom<&RsaPrivateKey<'_>> for RsaPrivateKeyDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(private_key: &RsaPrivateKey<'_>) -> Result<RsaPrivateKeyDocument>

Performs the conversion.

impl TryFrom<RsaPrivateKey<'_>> for RsaPrivateKeyDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(private_key: RsaPrivateKey<'_>) -> Result<RsaPrivateKeyDocument>

Performs the conversion.