Struct PskCryptoPlugin 

pub struct PskCryptoPlugin { /* private fields */ }

PSK-Crypto-Plugin. Class-Id "DDS:Crypto:PSK:AES-GCM-GMAC:1.2", Wire-Layout = AES-GCM-Plugin.

Implementations

impl PskCryptoPlugin

pub fn new() -> Self

Konstruktor mit Default-Suite AES-GCM-128.

pub fn with_suite(suite: Suite) -> Self

Konstruktor mit expliziter Suite.

pub fn suite(&self) -> Suite

Aktive Suite (fuer Tests / Metrics).

pub fn register_psk(&mut self, psk_id: u64, key: Vec<u8>) -> SecurityResult<()>

Registriert einen Pre-Shared-Key. Der Caller adressiert ihn spaeter via register_psk_remote ueber den gleichen psk_id-Namespace. Im PSK-Pfad gibt es keinen Random-Phase, d.h. Encrypt-Tokens werden via register_psk_remote direkt ohne RNG generiert.

Errors

BadArgument wenn der Key leer ist.

pub fn register_psk_remote( &mut self, local: CryptoHandle, remote_identity: IdentityHandle, psk_id: u64, session_id: [u8; 4], ) -> SecurityResult<CryptoHandle>

Registriert einen Remote-Slot fuer einen bekannten PSK. Der Plugin leitet via HKDF einen Per-Peer-Master-Key ab und schreibt ihn als Wire-Token in den AES-GCM-Slot. Beide Seiten muessen denselben PSK + dieselbe session_id verwenden, damit die Decrypt-Seite passt.

Errors

BadArgument wenn psk_id unbekannt; sonstige Crypto-Fehler.

pub fn register_psk_local( &mut self, psk_id: u64, session_id: [u8; 4], ) -> SecurityResult<CryptoHandle>

Registriert auch den lokalen Slot deterministisch aus PSK + session_id — ueblicherweise aufgerufen statt register_local_participant wenn man pure-PSK-Sym-Keys haben will (beide Seiten rechnen den Key offline aus).

Errors

Wie Self::register_psk_remote.

Trait Implementations

impl CryptographicPlugin for PskCryptoPlugin

fn register_local_participant( &mut self, identity: IdentityHandle, properties: &[(&str, &str)], ) -> SecurityResult<CryptoHandle>

Erzeugt Participant-Crypto-Material aus dem Handshake- SharedSecret.

fn register_matched_remote_participant( &mut self, local: CryptoHandle, remote_identity: IdentityHandle, shared_secret: SharedSecretHandle, ) -> SecurityResult<CryptoHandle>

Erzeugt Crypto-Material fuer einen Remote-Participant.

fn register_local_endpoint( &mut self, participant: CryptoHandle, is_writer: bool, properties: &[(&str, &str)], ) -> SecurityResult<CryptoHandle>

Erzeugt Crypto-Material fuer einen lokalen DataWriter/Reader.

fn create_local_participant_crypto_tokens( &mut self, local: CryptoHandle, remote: CryptoHandle, ) -> SecurityResult<Vec<u8>>

Erzeugt das ParticipantCryptoTokens-Blob, das an den Remote- Participant gesendet wird (enthaelt verschluesseltes Key-Material).

fn set_remote_participant_crypto_tokens( &mut self, local: CryptoHandle, remote: CryptoHandle, tokens: &[u8], ) -> SecurityResult<()>

Verarbeitet die Tokens vom Remote-Participant. Danach sind die Keys fuer encrypted Submessages wechselseitig bekannt.

fn encrypt_submessage( &self, local: CryptoHandle, remote_list: &[CryptoHandle], plaintext: &[u8], aad_extension: &[u8], ) -> SecurityResult<Vec<u8>>

Encrypt + Sign einer RTPS-Submessage. Input: plain submessage bytes. Output: SecureSubmessage-Payload (ciphertext + tag).

fn decrypt_submessage( &self, local: CryptoHandle, remote: CryptoHandle, ciphertext: &[u8], aad_extension: &[u8], ) -> SecurityResult<Vec<u8>>

Decrypt + Verify. Output: plain submessage bytes. aad_extension muss byte-identisch zur Sender-AAD sein (sonst Tag-Mismatch).

fn encrypt_submessage_multi( &self, local: CryptoHandle, receivers: &[(CryptoHandle, u32)], plaintext: &[u8], aad_extension: &[u8], ) -> SecurityResult<(Vec<u8>, Vec<ReceiverMac>)>

Encrypt+Sign mit Receiver-Specific-MACs (Spec §7.3.6.3). Produziert einen Ciphertext (Sender-Key) plus pro Remote einen 16-byte Truncated-HMAC.

fn decrypt_submessage_with_receiver_mac( &self, local: CryptoHandle, remote: CryptoHandle, own_key_id: u32, own_mac_key_handle: CryptoHandle, ciphertext: &[u8], macs: &[ReceiverMac], aad_extension: &[u8], ) -> SecurityResult<Vec<u8>>

Verify Receiver-Specific-MAC + Decrypt.

fn plugin_class_id(&self) -> &str

Plugin-Class-Id (z.B. “DDS:Crypto:AES-GCM-GMAC:1.2”).

impl Default for PskCryptoPlugin

fn default() -> Self

Returns the “default value” for a type.