Struct SrtpKeys 

pub struct SrtpKeys {
    pub local: (Vec<u8>, Vec<u8>),
    pub remote: (Vec<u8>, Vec<u8>),
}

The master keys for one SRTP session, one direction each.

Separate directions because RFC 3711 keys them separately: each side offers its own key in SDP and uses the other’s to decrypt. Sharing one key between directions would give both ends the same keystream for the same packet index, which is the classic way to lose a stream cipher.

Fields

local: (Vec<u8>, Vec<u8>)

Master key and salt this side encrypts with — the one offered in our SDP.

remote: (Vec<u8>, Vec<u8>)

Master key and salt the far end encrypts with — the one from its SDP.

Implementations

impl SrtpKeys

pub fn from_answer( offered: &[Crypto], answered: Option<&Crypto>, ) -> Result<Self, SdpError>

The keys an SDES answer settled on, after checking it against what was offered (RFC 4568 §5.1.3; docs/specs/srtp.md §5.4).

This is the seam between the signalling and the media path, and the reason it is fallible rather than an Option: an answer that echoed a tag this side never sent has agreed to nothing, and the two outcomes that are not an error are both worse than one. Returning None would place the call unencrypted, so a user who asked for a secure call gets an insecure one and nothing says so; dropping the stream would end the call with no reason anyone can act on. The error carries which tag came back and why it was refused.

answered is None when the answer carried no a=crypto this side can perform — the shape in which “a suite that was never offered” arrives, since sipx_sdp::crypto::Crypto::parse refuses one sipx cannot key.

Errors

sipx_sdp::SdpError::Invalid when the answer accepted a tag and suite pair that was never offered, or carried no key. It never names key material.

Trait Implementations

impl Clone for SrtpKeys

fn clone(&self) -> SrtpKeys

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SrtpKeys

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

Formats the value using the given formatter.

impl PartialEq for SrtpKeys

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

impl StructuralPartialEq for SrtpKeys