Enum TlsCipherSuite 

#[non_exhaustive]
pub enum TlsCipherSuite {
    Aes128GcmSha256,
    Aes256GcmSha384,
    Chacha20Poly1305Sha256,
    Aes128CcmSha256,
    Aes128Ccm8Sha256,
    Sha256Prf,
    Sha384Prf,
    Sha512Prf,
}

TLS cipher suite identifier for MAC negotiation.

Covers all TLS 1.3 cipher suites (RFC 8446 §B.4) and common TLS 1.2 HMAC-based cipher suites.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Aes128GcmSha256

TLS_AES_128_GCM_SHA256 (0x1301) — HMAC-SHA-256 for handshake MACs.

Aes256GcmSha384

TLS_AES_256_GCM_SHA384 (0x1302) — HMAC-SHA-384 for handshake MACs.

Chacha20Poly1305Sha256

TLS_CHACHA20_POLY1305_SHA256 (0x1303) — HMAC-SHA-256 for handshake MACs.

Aes128CcmSha256

TLS_AES_128_CCM_SHA256 (0x1304) — HMAC-SHA-256 for handshake MACs.

Aes128Ccm8Sha256

TLS_AES_128_CCM_8_SHA256 (0x1305) — HMAC-SHA-256 for handshake MACs.

Sha256Prf

Any TLS 1.2 suite with SHA-256 PRF (e.g. TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256).

Sha384Prf

Any TLS 1.2 suite with SHA-384 PRF (e.g. TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384).

Sha512Prf

Any TLS 1.2 suite with SHA-512 PRF.

Implementations

impl TlsCipherSuite

pub fn from_iana_name(name: &str) -> Option<Self>

Parse a TLS cipher suite IANA name into a TlsCipherSuite.

Returns None if the string is not a recognized cipher suite name.

Examples

use oxicrypto_mac::TlsCipherSuite;

assert_eq!(
    TlsCipherSuite::from_iana_name("TLS_AES_256_GCM_SHA384"),
    Some(TlsCipherSuite::Aes256GcmSha384),
);

Trait Implementations

impl Clone for TlsCipherSuite

fn clone(&self) -> TlsCipherSuite

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TlsCipherSuite

impl Debug for TlsCipherSuite

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

Formats the value using the given formatter.

impl Eq for TlsCipherSuite

impl Hash for TlsCipherSuite

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

fn eq(&self, other: &TlsCipherSuite) -> 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 StructuralPartialEq for TlsCipherSuite