Struct rcgen::KeyPair

pub struct KeyPair { /* fields omitted */ }

A key pair used to sign certificates and CSRs

Methods

impl KeyPair

pub fn from_pem(pem_str: &str) -> Result<Self, RcgenError>

Parses the key pair from the ASCII PEM format

impl KeyPair

pub fn generate(alg: &'static SignatureAlgorithm) -> Result<Self, RcgenError>

Generate a new random key pair for the specified signature algorithm

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

Get the raw public key of this key pair

The key is in raw format, as how ring::signature::KeyPair::public_key would output, and how ring::signature::verify would accept.

pub fn is_compatible(&self, signature_algorithm: &SignatureAlgorithm) -> bool

Check if this key pair can be used with the given signature algorithm

pub fn compatible_algs(
    &self
) -> impl Iterator<Item = &'static SignatureAlgorithm>

Returns (possibly multiple) compatible SignatureAlgorithm's that the key can be used with

pub fn public_key_der(&self) -> Vec<u8>

Return the key pair's public key in DER format

The key is formatted according to the SubjectPublicKeyInfo struct of X.509 see https://tools.ietf.org/html/rfc5280#section-4.1

pub fn public_key_pem(&self) -> String

Return the key pair's public key in PEM format

The returned string can be interpreted with openssl pkey --inform PEM -pubout -pubin -text

pub fn serialize_der(&self) -> Vec<u8>

Serializes the key pair (including the private key) in PKCS#8 format in DER

pub fn serialize_pem(&self) -> String

Serializes the key pair (including the private key) in PKCS#8 format in PEM

Trait Implementations

impl Debug for KeyPair

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

Formats the value using the given formatter.

impl<'_> TryFrom<&'_ [u8]> for KeyPair

type Error = RcgenError

The type returned in the event of a conversion error.

fn try_from(pkcs8: &[u8]) -> Result<KeyPair, RcgenError>

Performs the conversion.