Enum Algorithm 

pub enum Algorithm {
    Md5,
    Md5Sess,
    Sha256,
    Sha256Sess,
    Sha512_256,
    Sha512_256Sess,
}

Which digest algorithm a challenge asks for.

Variants

Md5

RFC 2617’s original, and still what most registrars offer.

Md5Sess

MD5 with the session variant of HA1.

Sha256

RFC 7616’s preferred algorithm.

Sha256Sess

SHA-256 with the session variant of HA1.

Sha512_256

RFC 8760’s addition: SHA-512/256, the truncated SHA-512 variant.

Not SHA-512 truncated by hand — SHA-512/256 is a distinct function with its own initial values (FIPS 180-4 §5.3.6). Hashing with SHA-512 and taking the first half would produce a different digest and fail against every peer.

Sha512_256Sess

SHA-512/256 with the session variant of HA1.

Implementations

impl Algorithm

pub fn parse(raw: &str) -> Option<Algorithm>

Parse an algorithm parameter. An absent one means MD5 (RFC 7616 §3.3).

pub fn as_str(self) -> &'static str

How the algorithm spells itself in a header.

pub fn is_session(self) -> bool

Whether HA1 is hashed again with the nonces.

pub fn strength(self) -> u8

How strong it is, for choosing among several offered challenges.

The session variants rank above their plain forms because they bind HA1 to this exchange’s nonces, so a captured HA1 cannot be replayed into a later one — a real property, not a longer digest.

Trait Implementations

impl Clone for Algorithm

fn clone(&self) -> Algorithm

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Algorithm

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

Formats the value using the given formatter.

impl Default for Algorithm

fn default() -> Algorithm

Returns the “default value” for a type.

impl PartialEq for Algorithm

fn eq(&self, other: &Algorithm) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Algorithm

impl Eq for Algorithm

impl StructuralPartialEq for Algorithm