#axum #session #sessions #cookie #async-session

axum-sessions

🥠 Cookie-based sessions for Axum via async-session

8 unstable releases (3 breaking)

0.4.1 Nov 30, 2022
0.4.0 Nov 25, 2022
0.3.2 Nov 14, 2022
0.3.1 Aug 8, 2022
0.1.1 Jun 23, 2022

#109 in Asynchronous

Download history 576/week @ 2022-10-19 238/week @ 2022-10-26 608/week @ 2022-11-02 847/week @ 2022-11-09 695/week @ 2022-11-16 1140/week @ 2022-11-23 1213/week @ 2022-11-30 689/week @ 2022-12-07 887/week @ 2022-12-14 902/week @ 2022-12-21 1317/week @ 2022-12-28 1897/week @ 2023-01-04 1468/week @ 2023-01-11 1133/week @ 2023-01-18 1581/week @ 2023-01-25 1292/week @ 2023-02-01

5,711 downloads per month
Used in 2 crates

MIT license

39KB
605 lines

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:

[dependencies]
axum-sessions = "0.4.1"

🤸 Usage

axum applications can use the middleware via the session layer.

axum Example

use axum::{response::IntoResponse, routing::get, Router};
use axum_sessions::{
    async_session::MemoryStore,
    extractors::{ReadableSession, WritableSession},
    SessionLayer,
};
use rand::Rng;

#[tokio::main]
async fn main() {
    let store = MemoryStore::new();
    let secret = rand::thread_rng().gen::<[u8; 128]>();
    let session_layer = 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.

Dependencies

~11–18MB
~315K SLoC