Struct rpki::crypto::keys::PublicKey

pub struct PublicKey { /* private fields */ }

A public key.

Implementations

impl PublicKey

pub fn rsa_from_components( modulus: &[u8], exponent: &[u8] ) -> Result<Self, InvalidInteger>

Creates an RSA Public Key based on the supplied exponent and modulus.

See: [RFC 4055]: https://tools.ietf.org/html/rfc4055

An RSA Public Key uses the following DER encoded structure inside its BitString component:

RSAPublicKey  ::=  SEQUENCE  {
    modulus            INTEGER,    -- n
    publicExponent     INTEGER  }  -- e

pub fn rsa_from_bits_bytes( bytes: Bytes ) -> Result<Self, DecodeError<Infallible>>

Creates an RSA public key from the key’s bits.

Note that this is not the DER-encoded public key written by, for instance, the OpenSSL command line tools. These files contain the complete public key including the algorithm and need to be read with PublicKey::decode.

pub fn algorithm(&self) -> PublicKeyFormat

Returns the algorithm of this public key.

pub fn bits(&self) -> &[u8]

Returns the bits of this public key.

pub fn bits_bytes(&self) -> Bytes

Returns the bits as a Bytes value.

pub fn allow_rpki_cert(&self) -> bool

Returns whether the key is acceptable for RPKI-internal certificates.

RPKI-internal certificates in this context are those used within the repository itself, i.e., CA certificates and EE certificates for signed objects.

pub fn allow_router_cert(&self) -> bool

Returns whether the key is acceptable for BGPSec router certificates.

pub fn key_identifier(&self) -> KeyIdentifier

Returns a key identifier for this key.

The identifier will be the SHA1 hash of the key’s bits.

pub fn verify<Alg: SignatureAlgorithm>( &self, message: &[u8], signature: &Signature<Alg> ) -> Result<(), SignatureVerificationError>

Verifies a signature using this public key.

impl PublicKey

As SubjectPublicKeyInfo

Public keys are included in X.509 certificates as SubjectPublicKeyInfo structures. As these contain the same information as PublicKey, it can be decoded from and encoded to such sequences.

pub fn decode<S: IntoSource>( source: S ) -> Result<Self, DecodeError<<S::Source as Source>::Error>>

pub fn take_from<S: Source>( cons: &mut Constructed<'_, S> ) -> Result<Self, DecodeError<S::Error>>

pub fn encode(self) -> impl Values

pub fn encode_ref(&self) -> impl Values + '_

pub fn encode_subject_name(&self) -> impl Values + '_

pub fn to_subject_name(&self) -> Name

pub fn to_info_bytes(&self) -> Bytes

Returns a bytes values of the encoded the subjectPublicKeyInfo.

This returns a newly “allocated” bytes object.

Trait Implementations

impl Clone for PublicKey

fn clone(&self) -> PublicKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PublicKey

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for PublicKey

fn eq(&self, other: &PublicKey) -> 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 Serialize for PublicKey

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for PublicKey

impl StructuralEq for PublicKey

impl StructuralPartialEq for PublicKey