Enum x509_certificate::algorithm::DigestAlgorithm

pub enum DigestAlgorithm {
    Sha1,
    Sha256,
    Sha384,
    Sha512,
}

A hashing algorithm used for digesting data.

Instances can be converted to and from Oid via From/Into implementations.

They can also be converted to and from The ASN.1 AlgorithmIdentifier, which is commonly used to represent them in X.509 certificates.

Instances can be converted into a digest::Context capable of computing digests via From/Into.

Variants

Sha1

SHA-1.

Corresponds to OID 1.3.14.3.2.26.

Sha256

SHA-256.

Corresponds to OID 2.16.840.1.101.3.4.2.1.

Sha384

SHA-384.

Corresponds to OID 2.16.840.1.101.3.4.2.2.

Sha512

SHA-512.

Corresponds to OID 2.16.840.1.101.3.4.2.3.

Implementations

impl DigestAlgorithm

pub fn digester(&self) -> Context

Obtain an object that can be used to digest content using this algorithm.

pub fn digest_data(&self, data: &[u8]) -> Vec<u8>

Digest a slice of data.

pub fn digest_reader<R: Read>(&self, fh: &mut R) -> Result<Vec<u8>, Error>

Digest content from a reader.

pub fn digest_path(&self, path: &Path) -> Result<Vec<u8>, Error>

Digest the content of a path.

pub fn rsa_pkcs1_encode(
    &self,
    message: &[u8],
    target_length_in_bytes: usize
) -> Result<Vec<u8>, Error>

EMSA-PKCS1-v1_5 padding procedure.

As defined by https://tools.ietf.org/html/rfc3447#section-9.2.

message is the message to digest and encode.

target_length_in_bytes is the target length of the padding. This should match the RSA key length. e.g. 2048 bit keys are length 256.

Trait Implementations

impl Clone for DigestAlgorithm

fn clone(&self) -> DigestAlgorithm

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DigestAlgorithm

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

Formats the value using the given formatter.

impl Display for DigestAlgorithm

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

Formats the value using the given formatter.

impl From<DigestAlgorithm> for AlgorithmIdentifier

fn from(alg: DigestAlgorithm) -> Self

Converts to this type from the input type.

impl From<DigestAlgorithm> for Context

fn from(alg: DigestAlgorithm) -> Self

Converts to this type from the input type.

impl From<DigestAlgorithm> for Oid

fn from(alg: DigestAlgorithm) -> Self

Converts to this type from the input type.

impl Hash for DigestAlgorithm

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<DigestAlgorithm> for DigestAlgorithm

fn eq(&self, other: &DigestAlgorithm) -> 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 TryFrom<&AlgorithmIdentifier> for DigestAlgorithm

type Error = X509CertificateError

The type returned in the event of a conversion error.

fn try_from(v: &AlgorithmIdentifier) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Oid<Bytes>> for DigestAlgorithm

type Error = X509CertificateError

The type returned in the event of a conversion error.

fn try_from(v: &Oid) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for DigestAlgorithm

impl Eq for DigestAlgorithm

impl StructuralEq for DigestAlgorithm

impl StructuralPartialEq for DigestAlgorithm