Struct SecretAuditEvent 

pub struct SecretAuditEvent {
    pub timestamp: DateTime<Utc>,
    pub agent_id: String,
    pub operation: String,
    pub secret_key: Option<String>,
    pub outcome: AuditOutcome,
    pub error_message: Option<String>,
    pub metadata: Option<Value>,
}

A structured audit event for secret operations

Fields

timestamp: DateTime<Utc>

Timestamp when the event occurred

agent_id: String

ID of the agent performing the action

operation: String

The type of operation performed

secret_key: Option<String>

The key of the secret being accessed (if applicable)

outcome: AuditOutcome

The result of the operation

error_message: Option<String>

Error details if the operation failed

metadata: Option<Value>

Additional context or metadata

Implementations

impl SecretAuditEvent

pub fn attempt( agent_id: String, operation: String, secret_key: Option<String>, ) -> Self

Create an intent-to-access audit event, logged before the backend call.

This ensures that even if the process crashes during the Vault/file read, there is a paper trail showing the access was attempted.

pub fn success( agent_id: String, operation: String, secret_key: Option<String>, ) -> Self

Create a new audit event for a successful operation

pub fn failure( agent_id: String, operation: String, secret_key: Option<String>, error_message: String, ) -> Self

Create a new audit event for a failed operation

pub fn with_metadata(self, metadata: Value) -> Self

Add metadata to the audit event

Trait Implementations

impl Clone for SecretAuditEvent

fn clone(&self) -> SecretAuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecretAuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SecretAuditEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SecretAuditEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.