axum-sessions

🥠 Cookie-based sessions for Axum via async-session.

🎨 Overview

axum-sessions is a middleware providing cookie-based sessions for axum applications.

• Cryptographically-signed cookies, ensuring integrity and authenticity
• Wraps async-session, enabling flexible cookie storage (e.g. async-sqlx-session)
• Convenient extractor-based API (i.e. ReadableSession and WritableSession)
• Can be used as a generic Tower middleware

📦 Install

To use the crate in your project, add the following to your Cargo.toml file:

toml [dependencies] axum-sessions = "0.4.0"

🤸 Usage

axum applications can use the middleware via the session layer.

axum Example

```rust use axum::{response::IntoResponse, routing::get, Router}; use axumsessions::{ asyncsession::MemoryStore, extractors::{ReadableSession, WritableSession}, SessionLayer, }; use rand::Rng;

[tokio::main]

async fn main() { let store = MemoryStore::new(); let secret = rand::threadrng().gen::<[u8; 128]>(); let sessionlayer = SessionLayer::new(store, &secret).with_secure(false);

async fn display_handler(session: ReadableSession) -> impl IntoResponse {
    let mut count = 0;
    count = session.get("count").unwrap_or(count);
    format!(
        "Count is: {}; visit /inc to increment and /reset to reset",
        count
    )
}

async fn increment_handler(mut session: WritableSession) -> impl IntoResponse {
    let mut count = 1;
    count = session.get("count").map(|n: i32| n + 1).unwrap_or(count);
    session.insert("count", count).unwrap();
    format!("Count is: {}", count)
}

async fn reset_handler(mut session: WritableSession) -> impl IntoResponse {
    session.destroy();
    "Count reset"
}

let app = Router::new()
    .route("/", get(display_handler))
    .route("/inc", get(increment_handler))
    .route("/reset", get(reset_handler))
    .layer(session_layer);

axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
    .serve(app.into_make_service())
    .await
    .unwrap();

} ```

You can find this example as well as other example projects in the example directory.

Session authentication via axum-login

For user session management and authentication and authorization specifically please see axum-login.

See the crate documentation for more usage information.