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

fn to_pkcs1(&self) -> Result<Vec<u8>>

Encodes a Public key to into PKCS1 bytes.

fn to_pkcs8(&self) -> Result<Vec<u8>>

Encodes a Public key to into PKCS8 bytes.

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

const PKCS1_HEADER: &'static str

const PKCS8_HEADER: &'static str

fn to_pem_pkcs1(&self) -> Result<String>

Converts a Public key into PKCS1 encoded bytes in pem format.

fn to_pem_pkcs1_with_config(&self, config: EncodeConfig) -> Result<String>

Converts a Public key into PKCS1 encoded bytes in pem format with encoding config.

fn to_pem_pkcs8(&self) -> Result<String>

Converts a Public key into PKCS8 encoded bytes in pem format.

fn to_pem_pkcs8_with_config(&self, config: EncodeConfig) -> Result<String>

Converts a Public key into PKCS8 encoded bytes in pem format with encoding config.

impl TryFrom<Pem> for RSAPublicKey

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");

type Error = Error

The type returned in the event of a conversion error.

impl Eq for RSAPublicKey

impl StructuralEq for RSAPublicKey

impl StructuralPartialEq for RSAPublicKey