Struct stun_types::attribute::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

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 MessageIntegritySha256

fn clone(&self) -> MessageIntegritySha256

Returns a copy 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<'a> From<&'a MessageIntegritySha256> for RawAttribute<'a>

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

Converts to this type from the input type.

impl PartialEq for MessageIntegritySha256

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