Struct PkiAuthenticationPlugin 

pub struct PkiAuthenticationPlugin { /* private fields */ }

PKI/X.509-basierter AuthenticationPlugin. Verifiziert Identity- Certs gegen einen vorgegebenen Trust-Anchor und fuehrt einen 3-Round PKI-DH-Handshake (Spec §10.3.2.6-8 Tab.56/57/58) zum Peer.

Wire (C3.1): drei DataHolder-Tokens DDS:Auth:PKI-DH:1.2+AuthReq / +AuthReply / +AuthFinal. Beide Seiten echo’n cert_der + dh* + challenge* + Hash-Bindings. Replier signiert (kagree || ch1 || dh1 || ch2 || dh2) mit Identity-Private-Key; Initiator signiert (kagree || ch2 || dh2 || ch1 || dh1).

Implementations

impl PkiAuthenticationPlugin

pub fn new() -> Self

Konstruktor.

pub fn validate_with_config( &mut self, cfg: IdentityConfig, _participant_guid: [u8; 16], ) -> SecurityResult<IdentityHandle>

Programmatische Variante: direkt IdentityConfig statt PropertyList uebergeben. Nuetzlich fuer Tests + native Rust-Caller.

Errors

Siehe PkiError.

pub fn secret_bytes(&self, handle: SharedSecretHandle) -> Option<&[u8]>

Liest die rohen 32-byte SharedSecret-Bytes. Primär fuer Tests; im Produktions-Pfad wird der SharedSecretHandle an den CryptoPlugin durchgereicht, ohne dass der Caller die Bytes sieht.

Trait Implementations

impl AuthenticationPlugin for PkiAuthenticationPlugin

fn validate_local_identity( &mut self, props: &PropertyList, participant_guid: [u8; 16], ) -> SecurityResult<IdentityHandle>

Wird einmal beim Participant-Start aufgerufen: lokale Identity validieren (Zertifikat, Key, Trust-Anchor) und einen Handle zurueckgeben.

fn validate_remote_identity( &mut self, local: IdentityHandle, _remote_participant_guid: [u8; 16], remote_auth_token: &[u8], ) -> SecurityResult<IdentityHandle>

Wird aufgerufen, sobald via SPDP ein Remote-Participant entdeckt wurde. Plugin validiert das Remote-Cert (aus remote_auth_token) gegen seinen Trust-Store.

fn begin_handshake_request( &mut self, initiator: IdentityHandle, _replier: IdentityHandle, ) -> SecurityResult<(HandshakeHandle, HandshakeStepOutcome)>

Startet den Handshake. Liefert das erste Token, das an den Peer gesendet werden muss.

fn begin_handshake_reply( &mut self, replier: IdentityHandle, _initiator: IdentityHandle, request_token: &[u8], ) -> SecurityResult<(HandshakeHandle, HandshakeStepOutcome)>

Peer-Seite des Handshake-Starts. request_token ist was der Initiator per begin_handshake_request geschickt hat.

fn process_handshake( &mut self, handshake: HandshakeHandle, token: &[u8], ) -> SecurityResult<HandshakeStepOutcome>

Folge-Nachrichten des Handshakes durchreichen.

fn shared_secret( &self, handshake: HandshakeHandle, ) -> SecurityResult<SharedSecretHandle>

Beendet den Handshake und liefert den finalen SharedSecret. Fehlschlag bricht ab. Wird nach Complete-Outcome durch den Caller aufgerufen, um den Secret aus dem Plugin zu ziehen.

fn plugin_class_id(&self) -> &str

Identity-Plugin-Name (z.B. “DDS:Auth:PKI-DH:1.2”). Wird in SPDP als dds.sec.auth.plugin_class annonciert.

fn get_identity_token( &self, _local: IdentityHandle, ) -> Result<Vec<u8>, SecurityError>

Liefert das IdentityToken fuer eine Local-Identity (Spec §9.3.2.4). Wird im SPDP-Announce als PID_IDENTITY_TOKEN (0x1001) publiziert. Default: leerer Token (= Plugin unterstuetzt das Feature nicht).

fn get_identity_status_token( &self, _local: IdentityHandle, ) -> Result<Vec<u8>, SecurityError>

Liefert das IdentityStatusToken fuer eine Local-Identity (Spec §9.3.2.5.1.2). Default: leer.

fn set_permissions_credential_and_token( &mut self, _local: IdentityHandle, _permissions_credential: &[u8], _permissions_token: &[u8], ) -> Result<(), SecurityError>

Setzt das Permissions-Credential und das Permissions-Token an einer Local-Identity (Spec §9.3.2.4 + §9.3.2.5.4). Wird vom Caller-Layer mit dem Output des AccessControlPlugin gespeist.

fn get_authenticated_peer_credential_token( &self, _handshake: HandshakeHandle, ) -> Result<Vec<u8>, SecurityError>

Liefert das AuthenticatedPeerCredentialToken (Spec §9.3.2.5.6). Wird nach erfolgreichem Handshake vom AccessControl-Layer abgeholt, um den Caller-Subject-Match durchzufuehren. Default: leer.

impl Default for PkiAuthenticationPlugin

fn default() -> Self

Returns the “default value” for a type.

impl SharedSecretProvider for PkiAuthenticationPlugin

fn get_shared_secret(&self, handle: SharedSecretHandle) -> Option<Vec<u8>>

Liefert die rohen Bytes des geteilten Schluessels. None wenn der Handle unbekannt ist (Handshake noch nicht abgeschlossen oder bereits verworfen).