Struct SecurityConfig 

pub struct SecurityConfig { /* private fields */ }

Builder for DDS Security configuration.

Security is enabled by setting specific QoS properties that tell CycloneDDS which plugins to load and where to find certificates, keys, and policy files.

Implementations

impl SecurityConfig

pub fn new() -> Self

Create a new security config with default plugin names.

pub fn identity_ca(self, path: impl Into<String>) -> Self

Path to the Identity CA certificate (PEM).

pub fn identity_certificate(self, path: impl Into<String>) -> Self

Path to the participant identity certificate (PEM).

pub fn identity_private_key(self, path: impl Into<String>) -> Self

Path to the participant identity private key (PEM).

pub fn governance(self, path: impl Into<String>) -> Self

Path to the Governance XML document.

pub fn permissions(self, path: impl Into<String>) -> Self

Path to the Permissions XML document.

pub fn permissions_ca(self, path: impl Into<String>) -> Self

Path to the Permissions CA certificate (PEM).

pub fn crl(self, path: impl Into<String>) -> Self

Path to the Certificate Revocation List (CRL) in PEM format.

pub fn auth_plugin(self, name: impl Into<String>) -> Self

Override the authentication plugin name (default: dds.sec.auth.builtin.PKI-DH).

pub fn access_plugin(self, name: impl Into<String>) -> Self

Override the access-control plugin name (default: dds.sec.access.builtin.Access-Permissions).

pub fn crypto_plugin(self, name: impl Into<String>) -> Self

Override the cryptography plugin name (default: dds.sec.crypto.builtin.AES-GCM-GMAC).

pub fn validate(&self) -> DdsResult<()>

Validate that all configured certificate and policy files exist and appear to be valid PEM documents.

Returns Ok(()) if all configured files are present and readable, or Err with a description of the first problem found.

pub fn reload(&self) -> Self

Create a new SecurityConfig with the same settings.

This is a semantic wrapper for certificate hot-reload workflows: after updating certificate files on disk, call reload() and then validate() before recreating the DomainParticipant.

pub fn apply_to(self, builder: QosBuilder) -> QosBuilder

Apply this security configuration to a QosBuilder.

Trait Implementations

impl Clone for SecurityConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecurityConfig

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

Formats the value using the given formatter.

impl Default for SecurityConfig

fn default() -> Self

Returns the “default value” for a type.