Struct EchConfigList

#[repr(transparent)]
pub struct EchConfigList(pub Vec<u8>);

draft-ietf-tls-svcb-ech-01 Bootstrapping TLS Encrypted ClientHello with DNS Service Bindings, Sep 2024

2.  "SvcParam for ECH configuration"

  The "ech" SvcParamKey is defined for conveying the ECH configuration
  of an alternative endpoint. It is applicable to all TLS-based protocols
  (including DTLS [RFC9147] and QUIC version 1 [RFC9001]) unless
  otherwise specified.

  In wire format, the value of the parameter is an ECHConfigList (Section 4 of draft-ietf-tls-esni-18),
  including the redundant length prefix. In presentation format, the value is the ECHConfigList
  in Base 64 Encoding (Section 4 of [RFC4648]). Base 64 is used here to simplify integration
  with TLS server software. To enable simpler parsing, this SvcParam MUST NOT contain escape
  sequences.

Tuple Fields

0: Vec<u8>

Trait Implementations

impl<'r> BinDecodable<'r> for EchConfigList

fn read(decoder: &mut BinDecoder<'r>) -> Result<EchConfigList, ProtoError>

In wire format, the value of the parameter is an ECHConfigList (Section 4 of draft-ietf-tls-esni-18), including the redundant length prefix. In presentation format, the value is the ECHConfigList in Base 64 Encoding (Section 4 of RFC4648). Base 64 is used here to simplify integration with TLS server software. To enable simpler parsing, this SvcParam MUST NOT contain escape sequences.

fn from_bytes(bytes: &'r [u8]) -> Result<Self, ProtoError>

Returns the object in binary form

impl BinEncodable for EchConfigList

fn emit(&self, encoder: &mut BinEncoder<'_>) -> Result<(), ProtoError>

In wire format, the value of the parameter is an ECHConfigList (Section 4 of draft-ietf-tls-esni-18), including the redundant length prefix. In presentation format, the value is the ECHConfigList in Base 64 Encoding (Section 4 of RFC4648). Base 64 is used here to simplify integration with TLS server software. To enable simpler parsing, this SvcParam MUST NOT contain escape sequences.

fn to_bytes(&self) -> Result<Vec<u8>, ProtoError>

Returns the object in binary form

impl Clone for EchConfigList

fn clone(&self) -> EchConfigList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EchConfigList

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

The debug format for EchConfig will output the value in BASE64 like Display, but will the addition of the type-name.

impl Display for EchConfigList

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

As the documentation states, the presentation format (what this function outputs) must be a BASE64 encoded string. hickory-dns will encode to BASE64 during formatting of the internal data, and output the BASE64 value.

draft-ietf-tls-svcb-ech-01 Bootstrapping TLS Encrypted ClientHello with DNS Service Bindings, Sep 2024

 In presentation format, the value is the ECHConfigList in Base 64 Encoding
 (Section 4 of [RFC4648]). Base 64 is used here to simplify integration with
 TLS server software. To enable simpler parsing, this SvcParam MUST NOT
 contain escape sequences.

impl Hash for EchConfigList

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 EchConfigList

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

impl StructuralPartialEq for EchConfigList