Struct pkcs8::SecretDocument

pub struct SecretDocument(_);

Secret Document type.

Useful for formats which represent potentially secret data, such as cryptographic keys.

This type provides additional hardening such as ensuring that the contents are zeroized-on-drop, and also using more restrictive file permissions when writing files to disk.

Implementations

impl SecretDocument

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

Borrow the inner serialized bytes of this document.

pub fn to_bytes(&self) -> Zeroizing<Vec<u8, Global>>

Return an allocated ASN.1 DER serialization as a byte vector.

pub fn len(&self) -> Length

Get the length of the encoded ASN.1 DER in bytes.

pub fn decode_msg<'a, T>(&'a self) -> Result<T, Error>where
    T: Decode<'a>,

Try to decode the inner ASN.1 DER message as the given type.

pub fn encode_msg<T>(msg: &T) -> Result<SecretDocument, Error>where
    T: Encode,

Encode the provided type as ASN.1 DER.

pub fn read_der_file(path: impl AsRef<Path>) -> Result<SecretDocument, Error>

Read ASN.1 DER document from a file.

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

Write ASN.1 DER document to a file.

Trait Implementations

impl Clone for SecretDocument

fn clone(&self) -> SecretDocument

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SecretDocument

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

Formats the value using the given formatter.

impl Drop for SecretDocument

fn drop(&mut self)

Executes the destructor for this type.

impl From<Document> for SecretDocument

fn from(doc: Document) -> SecretDocument

Converts to this type from the input type.

impl TryFrom<&[u8]> for SecretDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(der_bytes: &[u8]) -> Result<SecretDocument, Error>

Performs the conversion.

impl TryFrom<&PrivateKeyInfo<'_>> for SecretDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(private_key: &PrivateKeyInfo<'_>) -> Result<SecretDocument>

Performs the conversion.

impl TryFrom<PrivateKeyInfo<'_>> for SecretDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(private_key: PrivateKeyInfo<'_>) -> Result<SecretDocument>

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for SecretDocument

type Error = Error

The type returned in the event of a conversion error.

fn try_from(der_bytes: Vec<u8, Global>) -> Result<SecretDocument, Error>

Performs the conversion.

impl ZeroizeOnDrop for SecretDocument