Struct tower_sessions::SessionManagerLayer

pub struct SessionManagerLayer<Store>
where
    Store: SessionStore,
{ /* private fields */ }

A layer for providing Session as a request extension.

Implementations

impl<Store> SessionManagerLayer<Store>

where Store: SessionStore,

pub fn with_name(self, name: &str) -> SessionManagerLayer<Store>

Configures the name of the cookie used for the session.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service = SessionManagerLayer::new(session_store).with_name("my.sid");

pub fn with_http_only(self, http_only: bool) -> SessionManagerLayer<Store>

Configures the "HttpOnly" attribute of the cookie used for the session.

⚠️ Warning: Cross-site scripting risk

Applications should generally not override the default value of true. If you do, you are exposing your application to increased risk of cookie theft via techniques like cross-site scripting.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service = SessionManagerLayer::new(session_store).with_http_only(true);

pub fn with_same_site(self, same_site: SameSite) -> SessionManagerLayer<Store>

Configures the "SameSite" attribute of the cookie used for the session.

Examples

use tower_sessions::{cookie::SameSite, MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service = SessionManagerLayer::new(session_store).with_same_site(SameSite::Lax);

pub fn with_expiry(self, expiry: Expiry) -> SessionManagerLayer<Store>

Configures the "Max-Age" attribute of the cookie used for the session.

Examples

use time::Duration;
use tower_sessions::{Expiry, MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_expiry = Expiry::OnInactivity(Duration::hours(1));
let session_service = SessionManagerLayer::new(session_store).with_expiry(session_expiry);

pub fn with_secure(self, secure: bool) -> SessionManagerLayer<Store>

Configures the "Secure" attribute of the cookie used for the session.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service = SessionManagerLayer::new(session_store).with_secure(true);

pub fn with_path(self, path: String) -> SessionManagerLayer<Store>

Configures the "Path" attribute of the cookie used for the session.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service =
    SessionManagerLayer::new(session_store).with_path("/some/path".to_string());

pub fn with_domain(self, domain: String) -> SessionManagerLayer<Store>

Configures the "Domain" attribute of the cookie used for the session.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service =
    SessionManagerLayer::new(session_store).with_domain("localhost".to_string());

impl<Store> SessionManagerLayer<Store>

where Store: SessionStore,

pub fn new(session_store: Store) -> SessionManagerLayer<Store>

Create a new SessionManagerLayer with the provided session store and default cookie configuration.

Examples

use tower_sessions::{MemoryStore, SessionManagerLayer};

let session_store = MemoryStore::default();
let session_service = SessionManagerLayer::new(session_store);

Trait Implementations

impl<Store> Clone for SessionManagerLayer<Store>

where Store: Clone + SessionStore,

fn clone(&self) -> SessionManagerLayer<Store>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Store> Debug for SessionManagerLayer<Store>

where Store: Debug + SessionStore,

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

Formats the value using the given formatter.

impl<S, Store> Layer<S> for SessionManagerLayer<Store>

where Store: SessionStore,

type Service = CookieManager<SessionManager<S, Store>>

The wrapped service

fn layer(&self, inner: S) -> <SessionManagerLayer<Store> as Layer<S>>::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.