Skip to main content

Module caps_wire

Module caps_wire 

Source
Expand description

SPDP-Mapping fuer PeerCapabilities.

Bruecke zwischen der Policy-Schicht (PeerCapabilities) und dem SPDP-Wire-Format (WirePropertyList). Beim Senden werden die eigenen Caps in die SPDP-Properties geschrieben; beim Empfang werden die Properties zurueck zu PeerCapabilities geparst.

§Property-Keys

KeySemantik
dds.sec.auth.plugin_classOMG-Standard, Authentication-Plugin-Class
dds.sec.access.plugin_classOMG-Standard, Access-Control-Plugin-Class
dds.sec.crypto.plugin_classOMG-Standard, Crypto-Plugin-Class
zerodds.sec.supported_suitesCSV: AES_128_GCM,AES_256_GCM,HMAC_SHA256
zerodds.sec.offered_protectionNONE / SIGN / ENCRYPT
zerodds.sec.vendor_hintFrei-String, z.B. "zerodds"

Der zerodds.sec.*-Namespace ist bewusst ZeroDDS-spezifisch. Andere Vendors (Cyclone, Fast-DDS) ignorieren unbekannte Properties still — dadurch bleibt SPDP-Interop erhalten (siehe Architektur- Doc §8.1).

has_valid_cert und validity_window werden nicht via SPDP uebertragen; das sind post-Handshake-Werte, die das Authentication- Plugin setzt.

Constants§

KEY_ACCESS_PLUGIN
OMG-Standard: Access-Control-Plugin-Class.
KEY_AUTH_PLUGIN
OMG-Standard: Authentication-Plugin-Class.
KEY_CRYPTO_PLUGIN
OMG-Standard: Crypto-Plugin-Class.
KEY_DELEGATION_CHAIN
ZeroDDS-Extension: Delegation-Chain (Base64-encoded Wire-Bytes, RC1). Format: Base64 ueber das DelegationChain::encode()- Output. Reicht durch SPDP via PID_PROPERTY_LIST.
KEY_OFFERED_PROTECTION
ZeroDDS-Extension: angebotenes Protection-Level.
KEY_SUPPORTED_SUITES
ZeroDDS-Extension: CSV der akzeptierten Suites.
KEY_VENDOR_HINT
ZeroDDS-Extension: Vendor-Identifikation fuer Quirks.
MAX_DELEGATION_CHAIN_BYTES
DoS-Cap fuer den Wire-Blob (vor Base64-Decode). Architektur §11.

Functions§

advertise_security_caps
Schreibt die Security-Caps in die gegebene PropertyList.
parse_peer_caps
Liest Security-Caps aus einer PropertyList. Unbekannte oder malformed Werte werden stillschweigend als “leer” behandelt — ein Peer darf uns nicht per zerlegter Property aus dem SPDP-Prozess werfen.