Struct AuditEvent 

pub struct AuditEvent {
    pub id: String,
    pub timestamp: DateTime<Utc>,
    pub action: AuditAction,
    pub box_id: Option<String>,
    pub actor: String,
    pub outcome: AuditOutcome,
    pub message: Option<String>,
    pub metadata: HashMap<String, Value>,
}

A structured audit event capturing a security-relevant action.

Follows the W7 model: Who, What, When, Where, Why, hoW, outcome.

Fields

id: String

Unique event ID.

timestamp: DateTime<Utc>

ISO 8601 timestamp.

action: AuditAction

Action category.

box_id: Option<String>

Target box ID (if applicable).

actor: String

Actor who initiated the action (e.g., “cli”, “sdk”, “cri”, “system”).

outcome: AuditOutcome

Outcome of the action.

message: Option<String>

Human-readable description.

metadata: HashMap<String, Value>

Additional structured metadata.

Implementations

impl AuditEvent

pub fn new(action: AuditAction, outcome: AuditOutcome) -> Self

Create a new audit event.

pub fn with_box_id(self, box_id: impl Into<String>) -> Self

Set the box ID.

pub fn with_actor(self, actor: impl Into<String>) -> Self

Set the actor.

pub fn with_message(self, message: impl Into<String>) -> Self

Set a human-readable message.

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<Value>, ) -> Self

Add a metadata key-value pair.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.