Skip to main content

PqBindingEventSink

Trait PqBindingEventSink 

Source
pub trait PqBindingEventSink: Send + Sync {
    // Required methods
    fn on_rebind_refused(&self, event: &RebindEvent);
    fn on_rebind_applied(&self, approval: &RebindApproval);

    // Provided methods
    fn on_first_contact(&self, _identity: &[u8; 32], _fingerprint: &[u8; 32]) { ... }
    fn on_promoted(
        &self,
        _identity: &[u8; 32],
        _fingerprint: &[u8; 32],
        _channel: &str,
    ) { ... }
    fn on_revoked(
        &self,
        _identity: &[u8; 32],
        _from: PqProvenance,
        _to: Option<PqProvenance>,
    ) { ... }
    fn on_evicted(&self, _identity: &[u8; 32]) { ... }
}
Expand description

Sink for binding lifecycle events.

Every method has a default no-op body except the two that report a change of trust state; implementors are expected to route those to the audit journal.

Required Methods§

Source

fn on_rebind_refused(&self, event: &RebindEvent)

An identity presented a PQ key different from its established binding. The binding was left alone.

Source

fn on_rebind_applied(&self, approval: &RebindApproval)

An established binding was replaced under an explicit approval.

Provided Methods§

Source

fn on_first_contact(&self, _identity: &[u8; 32], _fingerprint: &[u8; 32])

A first-contact binding was recorded.

Source

fn on_promoted( &self, _identity: &[u8; 32], _fingerprint: &[u8; 32], _channel: &str, )

A binding was promoted to OobVerified.

Source

fn on_revoked( &self, _identity: &[u8; 32], _from: PqProvenance, _to: Option<PqProvenance>, )

A promotion or a whole binding was withdrawn.

Source

fn on_evicted(&self, _identity: &[u8; 32])

A first-contact binding was evicted to make room. The identity loses change detection until it is seen again.

Implementors§