Struct MessageIntegritySha256 

pub struct MessageIntegritySha256;

The MESSAGE-INTEGRITY-SHA256 attribute contains an HMAC-SHA256 [RFC2104] of the STUN message. The MESSAGE-INTEGRITY-SHA256 attribute can be present in any STUN message type. The MESSAGE- INTEGRITY-SHA256 attribute contains an initial portion of the HMAC- SHA-256 [RFC2104] of the STUN message. The value will be at most 32 bytes, but it MUST be at least 16 bytes and MUST be a multiple of 4 bytes. The value must be the full 32 bytes unless the STUN Usage explicitly specifies that truncation is allowed. STUN Usages may specify a minimum length longer than 16 bytes.

The key for the HMAC depends on which credential mechanism is in use. Section 9.1.1 defines the key for the short-term credential mechanism, and Section 9.2.2 defines the key for the long-term credential mechanism. Other credential mechanism MUST define the key that is used for the HMAC.

The text used as input to HMAC is the STUN message, up to and including the attribute preceding the MESSAGE-INTEGRITY-SHA256 attribute. The Length field of the STUN message header is adjusted to point to the end of the MESSAGE-INTEGRITY-SHA256 attribute. The value of the MESSAGE-INTEGRITY-SHA256 attribute is set to a dummy value.

Once the computation is performed, the value of the MESSAGE- INTEGRITY-SHA256 attribute is filled in, and the value of the length in the STUN header is set to its correct value – the length of the entire message. Similarly, when validating the MESSAGE-INTEGRITY- SHA256, the Length field in the STUN header must be adjusted to point to the end of the MESSAGE-INTEGRITY-SHA256 attribute prior to calculating the HMAC over the STUN message, up to and including the attribute preceding the MESSAGE-INTEGRITY-SHA256 attribute. Such adjustment is necessary when attributes, such as FINGERPRINT, appear after MESSAGE-INTEGRITY-SHA256. See also Appendix B.1 for examples of such calculations.

Trait Implementations

impl<'a> Attribute<'a> for MessageIntegritySha256

const TYPE: AttributeType = AttributeType::MessageIntegritySha256

current attribute type.

type Error = Error

type Item = &'a [u8]

current attribute inner type.

fn serialize<B: BufMut>(value: Self::Item, bytes: &mut B, _: &'a [u8])

write the current attribute to the bytesfer.

fn deserialize(bytes: &'a [u8], _: &'a [u8]) -> Result<Self::Item, Self::Error>

convert bytesfer to current attribute.

impl Clone for MessageIntegritySha256

fn clone(&self) -> MessageIntegritySha256

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageIntegritySha256

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

Formats the value using the given formatter.

impl Copy for MessageIntegritySha256