Struct 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

fn get_type(&self) -> AttributeType

Retrieve the type of an Attribute.

fn length(&self) -> u16

Retrieve the length of an Attribute. This is not the padded length as stored in a Message and does not include the size of the attribute header.

impl AttributeFromRaw<'_> for MessageIntegrity

fn from_raw_ref(raw: &RawAttribute<'_>) -> Result<Self, StunParseError>

where Self: Sized,

Produce an Attribute from a RawAttribute

fn from_raw(raw: RawAttribute<'a>) -> Result<Self, StunParseError>

where Self: Sized,

Produce an Attribute from a RawAttribute

impl AttributeStaticType for MessageIntegrity

const TYPE: AttributeType

The AttributeType

impl AttributeWrite for MessageIntegrity

fn to_raw(&self) -> RawAttribute<'_>

Produce a RawAttribute from this Attribute

fn write_into_unchecked(&self, dest: &mut [u8])

Write attribute to the provided destination buffer.

impl Clone for MessageIntegrity

fn clone(&self) -> MessageIntegrity

Returns a duplicate 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 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 TryFrom<&RawAttribute<'_>> 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