Struct MessageIntegritySha256

pub struct MessageIntegritySha256 { /* private fields */ }

The MessageIntegritySha256 Attribute

Implementations

impl MessageIntegritySha256

pub fn new(hmac: &[u8]) -> Result<Self, StunWriteError>

Create a new MessageIntegritySha256 Attribute

Examples

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

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

Retrieve the value of the hmac

Examples

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

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

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

Note: use MessageIntegritySha256::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 = [141, 112, 214, 41, 247, 110, 61, 95, 46, 245, 132, 79, 99, 16, 167, 95, 239, 168, 3, 63, 101, 78, 150, 24, 241, 139, 34, 229, 189, 37, 14, 113];
let integrity = MessageIntegritySha256::compute(&data, &key).unwrap();
assert_eq!(integrity, expected);

pub fn verify( data: &[u8], key: &[u8], expected: &[u8], ) -> 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 = [141, 112, 214, 41, 247, 110, 61, 95, 46, 245, 132, 79, 99, 16, 167, 95, 239, 168, 3, 63, 101, 78, 150, 24, 241, 139, 34, 229, 189, 37, 14, 113];
assert_eq!(MessageIntegritySha256::verify(&data, &key, &expected).unwrap(), ());

Trait Implementations

impl Attribute for MessageIntegritySha256

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 MessageIntegritySha256

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 MessageIntegritySha256

const TYPE: AttributeType

The AttributeType

impl AttributeWrite for MessageIntegritySha256

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

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

Formats the value using the given formatter.

impl PartialEq for MessageIntegritySha256

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

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 MessageIntegritySha256

impl StructuralPartialEq for MessageIntegritySha256