Struct rsa::RsaPublicKey

pub struct RsaPublicKey { /* private fields */ }

Represents the public part of an RSA key.

Implementations

impl RsaPublicKey

pub const MIN_PUB_EXPONENT: u64 = 2u64

Minimum value of the public exponent e.

pub const MAX_PUB_EXPONENT: u64 = 8_589_934_591u64

Maximum value of the public exponent e.

pub const MAX_SIZE: usize = 4_096usize

Maximum size of the modulus n in bits.

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

Create a new public key from its components.

This function accepts public keys with a modulus size up to 4096-bits, i.e. RsaPublicKey::MAX_SIZE.

pub fn new_with_max_size(n: BigUint, e: BigUint, max_size: usize) -> Result<Self>

Create a new public key from its components.

pub fn new_unchecked(n: BigUint, e: BigUint) -> Self

Create a new public key, bypassing checks around the modulus and public exponent size.

This method is not recommended, and only intended for unusual use cases. Most applications should use RsaPublicKey::new or RsaPublicKey::new_with_max_size instead.

Trait Implementations

impl<D> AsRef<RsaPublicKey> for VerifyingKey<D>where
    D: Digest,

fn as_ref(&self) -> &RsaPublicKey

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

impl<D> AsRef<RsaPublicKey> for VerifyingKey<D>where
    D: Digest,

fn as_ref(&self) -> &RsaPublicKey

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

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 DecodePublicKey for RsaPublicKey

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

Deserialize object from ASN.1 DER-encoded [SubjectPublicKeyInfo] (binary format).

fn from_public_key_pem(s: &str) -> Result<Self, Error>

Deserialize PEM-encoded [SubjectPublicKeyInfo].

fn read_public_key_der_file(path: impl AsRef<Path>) -> Result<Self, Error>

Load public key object from an ASN.1 DER-encoded file on the local filesystem (binary format).

fn read_public_key_pem_file(path: impl AsRef<Path>) -> Result<Self, Error>

Load public key object from a PEM-encoded file on the local filesystem.

impl<'de> Deserialize<'de> for RsaPublicKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EncodePublicKey for RsaPublicKey

fn to_public_key_der(&self) -> Result<Document>

Serialize a [Document] containing a SPKI-encoded public key.

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

Serialize this public key as PEM-encoded SPKI with the given [LineEnding].

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

Write ASN.1 DER-encoded public key to the given path

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

Write ASN.1 DER-encoded public key to the given path

impl From<&RsaPrivateKey> for RsaPublicKey

fn from(private_key: &RsaPrivateKey) -> Self

Converts to this type from the input type.

impl From<RsaPrivateKey> for RsaPublicKey

fn from(private_key: RsaPrivateKey) -> Self

Converts to this type from the input type.

impl<D> From<RsaPublicKey> for VerifyingKey<D>where
    D: Digest,

fn from(key: RsaPublicKey) -> Self

Converts to this type from the input type.

impl<D> From<RsaPublicKey> for VerifyingKey<D>where
    D: Digest,

fn from(key: RsaPublicKey) -> Self

Converts to this type from the input type.

impl<D> From<VerifyingKey<D>> for RsaPublicKeywhere
    D: Digest,

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

Converts to this type from the input type.

impl<D> From<VerifyingKey<D>> for RsaPublicKeywhere
    D: Digest,

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

Converts to this type from the input type.

impl Hash for RsaPublicKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

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: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PublicKey for RsaPublicKey

fn encrypt<R: RngCore + CryptoRng>(
    &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 Serialize for RsaPublicKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<SubjectPublicKeyInfo<'_>> for RsaPublicKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(spki: SubjectPublicKeyInfo<'_>) -> Result<Self>

Performs the conversion.

impl Eq for RsaPublicKey

impl StructuralEq for RsaPublicKey

impl StructuralPartialEq for RsaPublicKey