Struct DtlsSession 

pub struct DtlsSession { /* private fields */ }

An established DTLS session for a CoAP/EST-coaps connection.

RFC 9483 §5: EST-coaps uses DTLS to secure the CoAP transport. DTLS 1.2 (RFC 6347) and DTLS 1.3 (RFC 9147) are supported.

This struct tracks the session state needed for EST operations: the peer identity (from the client certificate or PSK), the session identifier for resumption, and protocol version.

Implementations

impl DtlsSession

pub fn new( session_id: Vec<u8>, peer_addr: SocketAddr, protocol_version: DtlsVersion, ) -> Self

Creates a new DTLS session record.

pub fn with_client_cert( session_id: Vec<u8>, peer_addr: SocketAddr, protocol_version: DtlsVersion, client_cert_der: Vec<u8>, ) -> Self

Creates a new DTLS session with a client certificate.

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

Returns the opaque session identifier.

pub fn peer_addr(&self) -> SocketAddr

Returns the peer network address.

pub fn client_cert(&self) -> Option<&[u8]>

Returns the DER-encoded client certificate, if presented.

pub fn created_at(&self) -> Instant

Returns when the session was established.

pub fn protocol_version(&self) -> DtlsVersion

Returns the negotiated DTLS version.

pub fn is_expired(&self, ttl: Duration) -> bool

Checks whether the session has exceeded the given TTL.

pub fn client_cert_info(&self) -> Option<ClientCertInfo>

Extracts client certificate information from this session.

Returns None if no client certificate was presented or if the certificate cannot be parsed.

Trait Implementations

impl Clone for DtlsSession

fn clone(&self) -> DtlsSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DtlsSession

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

Formats the value using the given formatter.