Struct requiem_identity::CookieIdentityPolicy

pub struct CookieIdentityPolicy(_);

Use cookies for request identity storage.

The constructors take a key as an argument. This is the private key for cookie - when this value is changed, all identities are lost. The constructors will panic if the key is less than 32 bytes in length.

Example

use requiem_web::App;
use requiem_identity::{CookieIdentityPolicy, IdentityService};

fn main() {
    let app = App::new().wrap(IdentityService::new(
        // <- create identity middleware
        CookieIdentityPolicy::new(&[0; 32])  // <- construct cookie policy
               .domain("www.rust-lang.org")
               .name("requiem_auth")
               .path("/")
               .secure(true),
    ));
}

Methods

impl CookieIdentityPolicy

pub fn new(key: &[u8]) -> CookieIdentityPolicy

Construct new CookieIdentityPolicy instance.

Panics if key length is less than 32 bytes.

pub fn path<S: Into<String>>(self, value: S) -> CookieIdentityPolicy

Sets the path field in the session cookie being built.

pub fn name<S: Into<String>>(self, value: S) -> CookieIdentityPolicy

Sets the name field in the session cookie being built.

pub fn domain<S: Into<String>>(self, value: S) -> CookieIdentityPolicy

Sets the domain field in the session cookie being built.

pub fn secure(self, value: bool) -> CookieIdentityPolicy

Sets the secure field in the session cookie being built.

If the secure field is set, a cookie will only be transmitted when the connection is secure - i.e. https

pub fn max_age(self, seconds: i64) -> CookieIdentityPolicy

Sets the max-age field in the session cookie being built with given number of seconds.

pub fn max_age_time(self, value: Duration) -> CookieIdentityPolicy

Sets the max-age field in the session cookie being built with chrono::Duration.

pub fn same_site(self, same_site: SameSite) -> Self

Sets the same_site field in the session cookie being built.

pub fn visit_deadline(self, value: Duration) -> CookieIdentityPolicy

Accepts only users whose cookie has been seen before the given deadline

By default visit deadline is disabled.

pub fn login_deadline(self, value: Duration) -> CookieIdentityPolicy

Accepts only users which has been authenticated before the given deadline

By default login deadline is disabled.

Trait Implementations

impl IdentityPolicy for CookieIdentityPolicy

type Future = Ready<Result<Option<String>, Error>>

The return type of the middleware

type ResponseFuture = Ready<Result<(), Error>>

The return type of the middleware

fn from_request(&self, req: &mut ServiceRequest) -> Self::Future

Parse the session from request and load data from a service identity.

fn to_response<B>(
    &self,
    id: Option<String>,
    changed: bool,
    res: &mut ServiceResponse<B>
) -> Self::ResponseFuture

Write changes to response