Struct DtlsSession 

pub struct DtlsSession { /* private fields */ }

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

RFC 9148 §5: EST-coaps uses DTLS to secure the CoAP transport. The OpenSSL transport supports DTLS 1.2 (RFC 6347).

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.

Parses the DER-encoded client certificate using synta_certificate to extract the subject DN (RFC 4514 string form) and serial number.

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.