Struct ssh_key::private::PrivateKey

pub struct PrivateKey { /* private fields */ }

SSH private key.

Implementations

impl PrivateKey

pub fn new(key_data: KeypairData, comment: impl Into<String>) -> Self

This is supported on crate feature alloc only.

Create a new unencrypted private key with the given keypair data and comment.

On no_std platforms, use PrivateKey::from(key_data) instead.

pub fn from_openssh(input: impl AsRef<[u8]>) -> Result<Self>

Parse an OpenSSH-formatted PEM private key.

OpenSSH-formatted private keys begin with the following:

-----BEGIN OPENSSH PRIVATE KEY-----

pub fn encode_openssh<'o>(
    &self,
    line_ending: LineEnding,
    out: &'o mut [u8]
) -> Result<&'o str>

Encode OpenSSH-formatted (PEM) private key.

pub fn to_openssh(&self, line_ending: LineEnding) -> Result<Zeroizing<String>>

This is supported on crate feature alloc only.

Encode an OpenSSH-formatted PEM private key, allocating a self-zeroizing String for the result.

pub fn read_openssh_file(path: &Path) -> Result<Self>

This is supported on crate feature std only.

Read private key from an OpenSSH-formatted PEM file.

pub fn write_openssh_file(
    &self,
    path: &Path,
    line_ending: LineEnding
) -> Result<()>

This is supported on crate feature std only.

Write private key as an OpenSSH-formatted PEM file.

pub fn algorithm(&self) -> Algorithm

Get the digital signature Algorithm used by this key.

pub fn comment(&self) -> &str

Comment on the key (e.g. email address).

pub fn cipher_alg(&self) -> CipherAlg

Cipher algorithm (a.k.a. ciphername).

pub fn kdf_alg(&self) -> KdfAlg

KDF algorithm.

pub fn kdf_opts(&self) -> &KdfOpts

KDF options.

pub fn key_data(&self) -> &KeypairData

Keypair data.

pub fn public_key(&self) -> PublicKey

Get the PublicKey which corresponds to this private key.

Trait Implementations

impl Clone for PrivateKey

fn clone(&self) -> PrivateKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ConstantTimeEq for PrivateKey

This is supported on crate feature subtle only.

fn ct_eq(&self, other: &Self) -> Choice

Determine if two items are equal.

impl Debug for PrivateKey

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

Formats the value using the given formatter.

impl From<&'_ PrivateKey> for PublicKey

fn from(private_key: &PrivateKey) -> PublicKey

Performs the conversion.

impl From<KeypairData> for PrivateKey

fn from(key_data: KeypairData) -> PrivateKey

Performs the conversion.

impl From<PrivateKey> for PublicKey

fn from(private_key: PrivateKey) -> PublicKey

Performs the conversion.

impl FromStr for PrivateKey

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq<PrivateKey> for PrivateKey

This is supported on crate feature subtle only.

fn eq(&self, other: &Self) -> 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 !=.

impl PemLabel for PrivateKey

const TYPE_LABEL: &'static str

Expected PEM type label for a given document, e.g. "PRIVATE KEY"

fn validate_pem_label(actual: &str) -> Result<(), Error>

Validate that a given label matches the expected label.

impl Eq for PrivateKey

This is supported on crate feature subtle only.