Struct rsa::RSAPublicKey

pub struct RSAPublicKey { /* fields omitted */ }

Represents the public part of an RSA key.

Implementations

impl RSAPublicKey

pub fn new(n: BigUint, e: BigUint) -> Result<Self>

Create a new key from its components.

pub fn from_pkcs1(der: &[u8]) -> Result<RSAPublicKey>

Parse a PKCS1 encoded RSA Public Key.

The der data is expected to be the base64 decoded content following a -----BEGIN RSA PUBLIC KEY----- header.

https://tls.mbed.org/kb/cryptography/asn1-key-structures-in-der-and-pem

Example

use rsa::RSAPublicKey;

let file_content = r#"
-----BEGIN RSA PUBLIC KEY-----
MEgCQQCuWe45NapeQ6rkb5T5hYMgQwr3T0NE9rItqDwFJjcNmf6m9kq/wRAaFqWo
BX/BpdSuD0YqSUrnQ5ejf1XW9gmJAgMBAAE=
-----END RSA PUBLIC KEY-----
"#;

let der_encoded = file_content
    .lines()
    .filter(|line| !line.starts_with("-"))
    .fold(String::new(), |mut data, line| {
        data.push_str(&line);
        data
    });
let der_bytes = base64::decode(&der_encoded).expect("failed to decode base64 content");
let public_key = RSAPublicKey::from_pkcs1(&der_bytes).expect("failed to parse key");

pub fn from_pkcs8(der: &[u8]) -> Result<RSAPublicKey>

Parse a PKCS8 encoded RSA Public Key.

The der data is expected to be the base64 decoded content following a -----BEGIN PUBLIC KEY----- header.

https://tls.mbed.org/kb/cryptography/asn1-key-structures-in-der-and-pem

Example

use rsa::RSAPublicKey;

let file_content = r#"
-----BEGIN PUBLIC KEY-----
MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK5Z7jk1ql5DquRvlPmFgyBDCvdPQ0T2
si2oPAUmNw2Z/qb2Sr/BEBoWpagFf8Gl1K4PRipJSudDl6N/Vdb2CYkCAwEAAQ==
-----END PUBLIC KEY-----
"#;

let der_encoded = file_content
    .lines()
    .filter(|line| !line.starts_with("-"))
    .fold(String::new(), |mut data, line| {
        data.push_str(&line);
        data
    });
let der_bytes = base64::decode(&der_encoded).expect("failed to decode base64 content");
let public_key = RSAPublicKey::from_pkcs8(&der_bytes).expect("failed to parse key");

Trait Implementations

impl Clone for RSAPublicKey

fn clone(&self) -> RSAPublicKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RSAPublicKey

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

Formats the value using the given formatter.

impl Eq for RSAPublicKey

impl<'_> From<&'_ RSAPrivateKey> for RSAPublicKey

fn from(private_key: &RSAPrivateKey) -> Self

Performs the conversion.

impl From<RSAPrivateKey> for RSAPublicKey

fn from(private_key: RSAPrivateKey) -> Self

Performs the conversion.

impl PartialEq<RSAPublicKey> for RSAPublicKey

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

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

fn ne(&self, other: &RSAPublicKey) -> bool

This method tests for !=.

impl PublicKey for RSAPublicKey

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

Encrypt the given message.

fn verify(
    &self,
    padding: PaddingScheme,
    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.

impl<'a> PublicKey for &'a RSAPublicKey

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

Encrypt the given message.

fn verify(
    &self,
    padding: PaddingScheme,
    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.

impl PublicKeyParts for RSAPublicKey

fn n(&self) -> &BigUint

Returns the modulus of the key.

fn e(&self) -> &BigUint

Returns the public exponent of the key.

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> PublicKeyParts for &'a RSAPublicKey

fn n(&self) -> &BigUint

Returns the modulus of the key.

fn e(&self) -> &BigUint

Returns the public exponent of the key.

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 StructuralEq for RSAPublicKey

impl StructuralPartialEq for RSAPublicKey

impl TryFrom<Pem> for RSAPublicKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(pem: Pem) -> Result<RSAPublicKey>

Parses a PKCS8 or PKCS1 encoded RSA Public Key.

Expects one of the following pem headers:

• -----BEGIN PUBLIC KEY-----
• -----BEGIN RSA PUBLIC KEY-----

Example

use std::convert::TryFrom;
use rsa::RSAPublicKey;

let file_content = r#"
-----BEGIN PUBLIC KEY-----
MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK5Z7jk1ql5DquRvlPmFgyBDCvdPQ0T2
si2oPAUmNw2Z/qb2Sr/BEBoWpagFf8Gl1K4PRipJSudDl6N/Vdb2CYkCAwEAAQ==
-----END PUBLIC KEY-----
"#;

let pem = rsa::pem::parse(file_content).expect("failed to parse pem file");
let public_key = RSAPublicKey::try_from(pem).expect("failed to parse key");