Enum MessageIntegrity

pub enum MessageIntegrity {
    Encodable(EncodableMessageIntegrity),
    Decodable(DecodableMessageIntegrity),
}

The MessageIntegrity attribute contains an HMAC-SHA1 RFC2104 of the STUN message. This attribute can be present in any STUN message type.

Examples

 // use short-term-credentials to generate the key
 let key = HMACKey::new_short_term("foo bar")?;
 let attr = MessageIntegrity::new(key);
 assert_eq!(attr.attribute_type(), AttributeType::from(0x0008));

Variants

Encodable(EncodableMessageIntegrity)

Encodable version of this attribute. This is used when the attribute is added to a STUN message that is going to be sent to the network.

Decodable(DecodableMessageIntegrity)

Decodable version of this attribute. This is the decoded attribute received from the network.

Implementations

impl MessageIntegrity

pub fn new(key: HMACKey) -> Self

Creates a new attribute.

Arguments:

• key - The key used for the HMAC depends on which credential mechanism is in use.

pub fn validate(&self, input: &[u8], key: &HMACKey) -> bool

Validates the message using the HMAC value generated from the key

Arguments:

• input- the STUN message up to (but excluding) the MessageIntegrity attribute itself.
• key- the HMACKey key

Returns:

true if the message integrity attribute matches the computed value.

Trait Implementations

impl Clone for MessageIntegrity

fn clone(&self) -> MessageIntegrity

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MessageIntegrity

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

Formats the value using the given formatter.

impl From<&[u8; 20]> for MessageIntegrity

fn from(val: &[u8; 20]) -> Self

Converts to this type from the input type.

impl From<[u8; 20]> for MessageIntegrity

fn from(val: [u8; 20]) -> Self

Converts to this type from the input type.

impl From<MessageIntegrity> for StunAttribute

fn from(value: MessageIntegrity) -> Self

Converts to this type from the input type.

impl PartialEq for MessageIntegrity

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

fn get_type() -> AttributeType

where Self: Sized,

Returns the STUN attribute type.

fn attribute_type(&self) -> AttributeType

Returns the STUN attribute type of this instance.

impl Eq for MessageIntegrity

impl StructuralPartialEq for MessageIntegrity