Struct rsa::RSAPrivateKey

pub struct RSAPrivateKey { /* fields omitted */ }

Represents a whole RSA key, public and private parts.

Methods

impl RSAPrivateKey

pub fn new<R: Rng>(rng: &mut R, bit_size: usize) -> Result<RSAPrivateKey>

Generate a new RSA key pair of the given bit size using the passed in rng.

pub fn from_components(
    n: BigUint,
    e: BigUint,
    d: BigUint,
    primes: Vec<BigUint>
) -> RSAPrivateKey

Constructs an RSA key pair from the individual components.

pub fn to_public_key(&self) -> RSAPublicKey

Get the public key from the private key, cloning n and e.

Generally this is not needed since RSAPrivateKey implements the PublicKey trait, but it can occationally be useful to discard the private information entirely.

pub fn precompute(&mut self)

Performs some calculations to speed up private key operations.

pub fn d(&self) -> &BigUint

Returns the private exponent of the key.

pub fn primes(&self) -> &[BigUint]

Returns the prime factors.

pub fn validate(&self) -> Result<()>

Performs basic sanity checks on the key. Returns Ok(()) if everything is good, otherwise an approriate error.

pub fn decrypt(
    &self,
    padding: PaddingScheme,
    ciphertext: &[u8]
) -> Result<Vec<u8>>

Decrypt the given message.

pub fn decrypt_blinded<R: Rng>(
    &self,
    rng: &mut R,
    padding: PaddingScheme,
    ciphertext: &[u8]
) -> Result<Vec<u8>>

Decrypt the given message. Uses rng to blind the decryption process.

pub fn sign<H: Hash>(
    &self,
    padding: PaddingScheme,
    hash: Option<&H>,
    digest: &[u8]
) -> Result<Vec<u8>>

Sign the given digest.

pub fn sign_blinded<R: Rng, H: Hash>(
    &self,
    rng: &mut R,
    padding: PaddingScheme,
    hash: Option<&H>,
    digest: &[u8]
) -> Result<Vec<u8>>

Sign the given digest. Use rng for blinding.

Trait Implementations

impl PublicKey for RSAPrivateKey

fn n(&self) -> &BigUint

Returns the modulus of the key.

fn e(&self) -> &BigUint

Returns the public exponent of the key.

fn encrypt<R: Rng>(
    &self,
    rng: &mut R,
    padding: PaddingScheme,
    msg: &[u8]
) -> Result<Vec<u8>>

Encrypt the given message.

fn verify<H: Hash>(
    &self,
    padding: PaddingScheme,
    hash: Option<&H>,
    hashed: &[u8],
    sig: &[u8]
) -> Result<()>

Verify a signed message. hashedmust be the result of hashing the input using the hashing function passed in through hash. If the message is valid Ok(()) is returned, otherwiese an Err indicating failure.

fn size(&self) -> usize

Returns the modulus size in bytes. Raw signatures and ciphertexts for or by this public key will have the same size.

impl<'a> PublicKey for &'a RSAPrivateKey

fn n(&self) -> &BigUint

Returns the modulus of the key.

fn e(&self) -> &BigUint

Returns the public exponent of the key.

fn encrypt<R: Rng>(
    &self,
    rng: &mut R,
    padding: PaddingScheme,
    msg: &[u8]
) -> Result<Vec<u8>>

Encrypt the given message.

fn verify<H: Hash>(
    &self,
    padding: PaddingScheme,
    hash: Option<&H>,
    hashed: &[u8],
    sig: &[u8]
) -> Result<()>

Verify a signed message. hashedmust be the result of hashing the input using the hashing function passed in through hash. If the message is valid Ok(()) is returned, otherwiese an Err indicating failure.

fn size(&self) -> usize

Returns the modulus size in bytes. Raw signatures and ciphertexts for or by this public key will have the same size.

impl Drop for RSAPrivateKey

fn drop(&mut self)

Executes the destructor for this type.

impl From<RSAPrivateKey> for RSAPublicKey

fn from(private_key: RSAPrivateKey) -> Self

Performs the conversion.

impl Clone for RSAPrivateKey

fn clone(&self) -> RSAPrivateKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for RSAPrivateKey

impl PartialEq<RSAPrivateKey> for RSAPrivateKey

fn eq(&self, other: &RSAPrivateKey) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Debug for RSAPrivateKey

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

Formats the value using the given formatter.

impl Zeroize for RSAPrivateKey

fn zeroize(&mut self)

Zero out this object from memory (using Rust or OS intrinsics which ensure the zeroization operation is not "optimized away")