Struct stun_types::attribute::MessageIntegrity

pub struct MessageIntegrity { /* private fields */ }

The MessageIntegrity Attribute

Implementations

impl MessageIntegrity

pub fn new(hmac: [u8; 20]) -> Self

Create a new MessageIntegrity Attribute

Examples

let hmac = [0;20];
let integrity = MessageIntegrity::new(hmac);
assert_eq!(integrity.hmac(), &hmac);

pub fn hmac(&self) -> &[u8; 20]

Retrieve the value of the hmac

Examples

let hmac = [0; 20];
let integrity = MessageIntegrity::new(hmac);
assert_eq!(integrity.hmac(), &hmac);

pub fn compute(data: &[u8], key: &[u8]) -> Result<[u8; 20], StunWriteError>

Compute the Message Integrity value of a chunk of data using a key

Note: use MessageIntegrity::verify for the actual verification to ensure constant time checks of the values to defeat certain types of timing attacks.

Examples

let key = [40; 10];
let data = [10; 30];
let expected = [209, 217, 210, 15, 124, 78, 87, 181, 211, 233, 165, 180, 44, 142, 81, 233, 138, 186, 184, 97];
let integrity = MessageIntegrity::compute(&data, &key).unwrap();
assert_eq!(integrity, expected);

pub fn verify( data: &[u8], key: &[u8], expected: &[u8; 20], ) -> Result<(), StunParseError>

Compute the Message Integrity value of a chunk of data using a key

Examples

let key = [40; 10];
let data = [10; 30];
let expected = [209, 217, 210, 15, 124, 78, 87, 181, 211, 233, 165, 180, 44, 142, 81, 233, 138, 186, 184, 97];
assert_eq!(MessageIntegrity::verify(&data, &key, &expected).unwrap(), ());

Trait Implementations

impl Attribute for MessageIntegrity

const TYPE: AttributeType = _

fn length(&self) -> u16

Retrieve the length of an Attribute. This is not the padded length as stored in a Message

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 Display for MessageIntegrity

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

Formats the value using the given formatter.

impl<'a> From<&'a MessageIntegrity> for RawAttribute<'a>

fn from(value: &'a MessageIntegrity) -> RawAttribute<'a>

Converts to this type from the input type.

impl PartialEq for MessageIntegrity

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<'a> TryFrom<&RawAttribute<'a>> for MessageIntegrity

type Error = StunParseError

The type returned in the event of a conversion error.

fn try_from(raw: &RawAttribute<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for MessageIntegrity

impl StructuralPartialEq for MessageIntegrity