Skip to content
This repository has been archived by the owner on Apr 29, 2024. It is now read-only.

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

License

Notifications You must be signed in to change notification settings

sbihel/axum-sessions

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.5.0"

🤸 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.

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%