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) -> Self

Create a new security event.

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

Set the username.

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

Set the IP address.

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

Set the user agent.

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

Set the request path.

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

Set the HTTP method.

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

Set the session ID.

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

Set the severity (overrides default).

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

Add a detail.

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

Set the error message.

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

Create a login success event.

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

Create a login failure event.

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

Create an access denied event.

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

Create a rate limit exceeded event.

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

Create an account locked event.

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

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

Formats the value using the given formatter.

impl Serialize for SecurityEvent

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

where S: Serializer,

Serialize this value into the given Serde serializer.