Struct AesGcmCryptoPlugin 

pub struct AesGcmCryptoPlugin { /* private fields */ }

AES-GCM Crypto-Plugin. Keys werden in einem internen Slab gehalten; Lookup per CryptoHandle. Welche Suite lokal erzeugte Keys haben, bestimmt local_suite — Remote-Keys kommen mit ihrer eigenen Suite-ID via Token.

Implementations

impl AesGcmCryptoPlugin

pub fn new() -> Self

Konstruktor mit Default-Suite AES-GCM-128.

pub fn with_suite(suite: Suite) -> Self

Konstruktor mit expliziter Suite (Aes128Gcm oder Aes256Gcm).

pub fn with_secret_provider( suite: Suite, provider: Arc<dyn SharedSecretProvider>, ) -> Self

Baut einen Plugin-Slot mit echtem DH-abgeleiteten Per-Peer-Key . Der SharedSecretProvider liefert die rohen Bytes aus einem abgeschlossenen Authentication-Handshake; wir leiten via HKDF-SHA256 einen deterministischen Master-Key ab, den beide Seiten ohne Token-Exchange berechnen koennen.

Mit Provider: register_matched_remote_participant nutzt den uebergebenen SharedSecretHandle, um den Per-Peer-Key aus dem PKI-Handshake zu ziehen. Ohne Provider bleibt das v1.4-Verhalten (Random-Key + Token-Exchange).

pub fn local_suite(&self) -> Suite

Lokale Suite (fuer Tests / Metrics).

pub fn encrypts_remaining(&self, handle: CryptoHandle) -> SecurityResult<u64>

Zaehl der verbleibenden sicheren Encrypts auf einem Slot. Wrapping-Point: Suite::max_encrypts() (2^48 per Default). Caller sollte bei 0 einen Key-Refresh anstossen .

Errors

BadArgument wenn der Handle nicht existiert.

pub fn rotate_key(&mut self, handle: CryptoHandle) -> SecurityResult<()>

Erzwingt einen neuen Master-Key im Slot. Nach rotate_key ist der alte Key futsch — Gegenseite muss per CryptographicPlugin::create_local_participant_crypto_tokens einen neuen Token ziehen und via CryptographicPlugin::set_remote_participant_crypto_tokens synchronisieren.

Errors

BadArgument wenn der Handle nicht existiert; CryptoFailed wenn die RNG versagt.

Trait Implementations

impl CryptographicPlugin for AesGcmCryptoPlugin

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 AesGcmCryptoPlugin

fn default() -> Self

Returns the “default value” for a type.