Struct SecurityEvent 

pub struct SecurityEvent {
    pub id: String,
    pub timestamp: u64,
    pub event_type: SecurityEventType,
    pub severity: SecurityEventSeverity,
    pub username: Option<String>,
    pub ip_address: Option<String>,
    pub user_agent: Option<String>,
    pub path: Option<String>,
    pub method: Option<String>,
    pub session_id: Option<String>,
    pub details: HashMap<String, String>,
    pub error: Option<String>,
}

A security audit event.

Fields

id: String

Unique event ID

timestamp: u64

Event timestamp (Unix epoch milliseconds)

event_type: SecurityEventType

Event type

severity: SecurityEventSeverity

Event severity

username: Option<String>

Username (if applicable)

ip_address: Option<String>

Source IP address

user_agent: Option<String>

User agent

path: Option<String>

Request path

method: Option<String>

HTTP method

session_id: Option<String>

Session ID (if applicable)

details: HashMap<String, String>

Additional details

error: Option<String>

Error message (for failure events)

Implementations

impl SecurityEvent

pub fn new(event_type: SecurityEventType) -> SecurityEvent

Create a new security event.

pub fn username(self, username: impl Into<String>) -> SecurityEvent

Set the username.

pub fn ip_address(self, ip: impl Into<String>) -> SecurityEvent

Set the IP address.

pub fn user_agent(self, ua: impl Into<String>) -> SecurityEvent

Set the user agent.

pub fn path(self, path: impl Into<String>) -> SecurityEvent

Set the request path.

pub fn method(self, method: impl Into<String>) -> SecurityEvent

Set the HTTP method.

pub fn session_id(self, id: impl Into<String>) -> SecurityEvent

Set the session ID.

pub fn severity(self, severity: SecurityEventSeverity) -> SecurityEvent

Set the severity (overrides default).

pub fn detail( self, key: impl Into<String>, value: impl Into<String>, ) -> SecurityEvent

Add a detail.

pub fn error(self, error: impl Into<String>) -> SecurityEvent

Set the error message.

pub fn login_success(username: &str, ip: &str) -> SecurityEvent

Create a login success event.

pub fn login_failure(username: &str, ip: &str, reason: &str) -> SecurityEvent

Create a login failure event.

pub fn access_denied(username: &str, path: &str, ip: &str) -> SecurityEvent

Create an access denied event.

pub fn rate_limit_exceeded(ip: &str, path: &str) -> SecurityEvent

Create a rate limit exceeded event.

pub fn account_locked(username: &str, ip: &str, reason: &str) -> SecurityEvent

Create an account locked event.

pub fn brute_force_detected(ip: &str, attempts: u32) -> SecurityEvent

Create a brute force detected event.

pub fn to_log_line(&self) -> String

Format the event as a log line.

pub fn to_json(&self) -> String

Format the event as JSON.

Trait Implementations

impl Clone for SecurityEvent

fn clone(&self) -> SecurityEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecurityEvent

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

Formats the value using the given formatter.

impl Serialize for SecurityEvent

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.