Struct Session 

pub struct Session {
    pub id: String,
    pub user_id: String,
    pub ip_address: String,
    pub user_agent: String,
    pub device_name: String,
    pub device_type: String,
    pub fingerprint: String,
    pub data: Value,
    pub created_at: DateTime<Utc>,
    pub last_active_at: DateTime<Utc>,
    pub expires_at: DateTime<Utc>,
}

Transport-agnostic snapshot of one authenticated session.

Populated into request extensions by CookieSessionLayer (cookie transport) or JwtLayer (JWT transport). Handlers extract it the same way regardless of which transport authenticated the request:

use modo::auth::session::Session;

async fn me(session: Session) -> String {
    session.user_id
}

The extractor returns 401 auth:session_not_found when no row is loaded. Use Option<Session> for routes that serve both authenticated and unauthenticated callers.

Session is read-only — to mutate session data use CookieSession (cookie transport) or JwtSession (JWT transport).

Fields

id: String

Session ULID — unique stable identifier for this row.

user_id: String

Authenticated user identifier.

ip_address: String

Client IP address recorded at login.

user_agent: String

Raw User-Agent header recorded at login.

device_name: String

Human-readable device name derived from the user agent (e.g. "Chrome on macOS").

device_type: String

Device category — "desktop", "mobile", or "tablet".

fingerprint: String

SHA-256 fingerprint of the browser environment, used to detect session hijacking.

data: Value

Arbitrary JSON data attached to the session by the application.

created_at: DateTime<Utc>

Timestamp of session creation.

last_active_at: DateTime<Utc>

Timestamp of the most recent activity (updated on touch).

expires_at: DateTime<Utc>

Timestamp at which the session expires.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Session

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S: Send + Sync> FromRequestParts<S> for Session

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.

impl<S: Send + Sync> OptionalFromRequestParts<S> for Session

type Rejection = Error

If the extractor fails, it will use this “rejection” type.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Option<Self>, Self::Rejection>

Perform the extraction.

impl Serialize for Session

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

where __S: Serializer,

Serialize this value into the given Serde serializer.