//! Request identity service for Actix applications. //! //! [**IdentityService**](struct.IdentityService.html) middleware can be //! used with different policies types to store identity information. //! //! By default, only cookie identity policy is implemented. Other backend //! implementations can be added separately. //! //! [**CookieIdentityPolicy**](struct.CookieIdentityPolicy.html) //! uses cookies as identity storage. //! //! To access current request identity //! [**RequestIdentity**](trait.RequestIdentity.html) should be used. //! *HttpRequest* implements *RequestIdentity* trait. //! //! ```rust //! use actix_web::middleware::identity::Identity; //! use actix_web::middleware::identity::{CookieIdentityPolicy, IdentityService}; //! use actix_web::*; //! //! fn index(id: Identity) -> String { //! // access request identity //! if let Some(id) = id.identity() { //! format!("Welcome! {}", id) //! } else { //! "Welcome Anonymous!".to_owned() //! } //! } //! //! fn login(id: Idenity) -> HttpResponse { //! id.remember("User1".to_owned()); // <- remember identity //! HttpResponse::Ok().finish() //! } //! //! fn logout(id: Identity) -> HttpResponse { //! id.forget(); // <- remove identity //! HttpResponse::Ok().finish() //! } //! //! fn main() { //! let app = App::new().middleware(IdentityService::new( //! // <- create identity middleware //! CookieIdentityPolicy::new(&[0; 32]) // <- create cookie session backend //! .name("auth-cookie") //! .secure(false)) //! .service(web::resource("/index.html").to(index) //! .service(web::resource("/login.html").to(login) //! .service(web::resource("/logout.html").to(logout) //! )); //! } //! ``` use std::cell::RefCell; use std::rc::Rc; use actix_service::{Service, Transform}; use cookie::{Cookie, CookieJar, Key, SameSite}; use futures::future::{ok, Either, FutureResult}; use futures::{Future, IntoFuture, Poll}; use time::Duration; use crate::error::{Error, Result}; use crate::http::header::{self, HeaderValue}; use crate::request::HttpRequest; use crate::service::{ServiceFromRequest, ServiceRequest, ServiceResponse}; use crate::FromRequest; use crate::HttpMessage; /// The extractor type to obtain your identity from a request. /// /// ```rust /// use actix_web::*; /// use actix_web::middleware::identity::Identity; /// /// fn index(id: Identity) -> Result { /// // access request identity /// if let Some(id) = id.identity() { /// Ok(format!("Welcome! {}", id)) /// } else { /// Ok("Welcome Anonymous!".to_owned()) /// } /// } /// /// fn login(id: Identity) -> HttpResponse { /// id.remember("User1".to_owned()); // <- remember identity /// HttpResponse::Ok().finish() /// } /// /// fn logout(id: Identity) -> HttpResponse { /// id.forget(); // <- remove identity /// HttpResponse::Ok().finish() /// } /// # fn main() {} /// ``` #[derive(Clone)] pub struct Identity(HttpRequest); impl Identity { /// Return the claimed identity of the user associated request or /// ``None`` if no identity can be found associated with the request. pub fn identity(&self) -> Option { if let Some(id) = self.0.extensions().get::() { id.id.clone() } else { None } } /// Remember identity. pub fn remember(&self, identity: String) { if let Some(id) = self.0.extensions_mut().get_mut::() { id.id = Some(identity); id.changed = true; } } /// This method is used to 'forget' the current identity on subsequent /// requests. pub fn forget(&self) { if let Some(id) = self.0.extensions_mut().get_mut::() { id.id = None; id.changed = true; } } } struct IdentityItem { id: Option, changed: bool, } /// Extractor implementation for Identity type. /// /// ```rust /// # use actix_web::*; /// use actix_web::middleware::identity::Identity; /// /// fn index(id: Identity) -> String { /// // access request identity /// if let Some(id) = id.identity() { /// format!("Welcome! {}", id) /// } else { /// "Welcome Anonymous!".to_owned() /// } /// } /// # fn main() {} /// ``` impl

FromRequest

for Identity { type Error = Error; type Future = Result; type Config = (); #[inline] fn from_request(req: &mut ServiceFromRequest

) -> Self::Future { Ok(Identity(req.clone())) } } /// Identity policy definition. pub trait IdentityPolicy: Sized + 'static { /// The return type of the middleware type Future: IntoFuture, Error = Error>; /// The return type of the middleware type ResponseFuture: IntoFuture; /// Parse the session from request and load data from a service identity. fn from_request

(&self, request: &mut ServiceRequest

) -> Self::Future; /// Write changes to response fn to_response( &self, identity: Option, changed: bool, response: &mut ServiceResponse, ) -> Self::ResponseFuture; } /// Request identity middleware /// /// ```rust /// use actix_web::App; /// use actix_web::middleware::identity::{CookieIdentityPolicy, IdentityService}; /// /// fn main() { /// let app = App::new().middleware(IdentityService::new( /// // <- create identity middleware /// CookieIdentityPolicy::new(&[0; 32]) // <- create cookie session backend /// .name("auth-cookie") /// .secure(false), /// )); /// } /// ``` pub struct IdentityService { backend: Rc, } impl IdentityService { /// Create new identity service with specified backend. pub fn new(backend: T) -> Self { IdentityService { backend: Rc::new(backend), } } } impl Transform for IdentityService where P: 'static, S: Service, Response = ServiceResponse> + 'static, S::Future: 'static, T: IdentityPolicy, B: 'static, { type Request = ServiceRequest

; type Response = ServiceResponse; type Error = S::Error; type InitError = (); type Transform = IdentityServiceMiddleware; type Future = FutureResult; fn new_transform(&self, service: S) -> Self::Future { ok(IdentityServiceMiddleware { backend: self.backend.clone(), service: Rc::new(RefCell::new(service)), }) } } pub struct IdentityServiceMiddleware { backend: Rc, service: Rc>, } impl Service for IdentityServiceMiddleware where P: 'static, B: 'static, S: Service, Response = ServiceResponse> + 'static, S::Future: 'static, T: IdentityPolicy, { type Request = ServiceRequest

; type Response = ServiceResponse; type Error = S::Error; type Future = Box>; fn poll_ready(&mut self) -> Poll<(), Self::Error> { self.service.borrow_mut().poll_ready() } fn call(&mut self, mut req: ServiceRequest

) -> Self::Future { let srv = self.service.clone(); let backend = self.backend.clone(); Box::new( self.backend.from_request(&mut req).into_future().then( move |res| match res { Ok(id) => { req.extensions_mut() .insert(IdentityItem { id, changed: false }); Either::A(srv.borrow_mut().call(req).and_then(move |mut res| { let id = res.request().extensions_mut().remove::(); if let Some(id) = id { return Either::A( backend .to_response(id.id, id.changed, &mut res) .into_future() .then(move |t| match t { Ok(_) => Ok(res), Err(e) => Ok(res.error_response(e)), }), ); } else { Either::B(ok(res)) } })) } Err(err) => Either::B(ok(req.error_response(err))), }, ), ) } } struct CookieIdentityInner { key: Key, name: String, path: String, domain: Option, secure: bool, max_age: Option, same_site: Option, } impl CookieIdentityInner { fn new(key: &[u8]) -> CookieIdentityInner { CookieIdentityInner { key: Key::from_master(key), name: "actix-identity".to_owned(), path: "/".to_owned(), domain: None, secure: true, max_age: None, same_site: None, } } fn set_cookie( &self, resp: &mut ServiceResponse, id: Option, ) -> Result<()> { let some = id.is_some(); { let id = id.unwrap_or_else(String::new); let mut cookie = Cookie::new(self.name.clone(), id); cookie.set_path(self.path.clone()); cookie.set_secure(self.secure); cookie.set_http_only(true); if let Some(ref domain) = self.domain { cookie.set_domain(domain.clone()); } if let Some(max_age) = self.max_age { cookie.set_max_age(max_age); } if let Some(same_site) = self.same_site { cookie.set_same_site(same_site); } let mut jar = CookieJar::new(); if some { jar.private(&self.key).add(cookie); } else { jar.add_original(cookie.clone()); jar.private(&self.key).remove(cookie); } for cookie in jar.delta() { let val = HeaderValue::from_str(&cookie.to_string())?; resp.headers_mut().append(header::SET_COOKIE, val); } } Ok(()) } fn load(&self, req: &ServiceRequest) -> Option { if let Ok(cookies) = req.cookies() { for cookie in cookies.iter() { if cookie.name() == self.name { let mut jar = CookieJar::new(); jar.add_original(cookie.clone()); let cookie_opt = jar.private(&self.key).get(&self.name); if let Some(cookie) = cookie_opt { return Some(cookie.value().into()); } } } } None } } /// 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 /// /// ```rust /// # extern crate actix_web; /// use actix_web::middleware::identity::{CookieIdentityPolicy, IdentityService}; /// use actix_web::App; /// /// fn main() { /// let app = App::new().middleware(IdentityService::new( /// // <- create identity middleware /// CookieIdentityPolicy::new(&[0; 32]) // <- construct cookie policy /// .domain("www.rust-lang.org") /// .name("actix_auth") /// .path("/") /// .secure(true), /// )); /// } /// ``` pub struct CookieIdentityPolicy(Rc); impl CookieIdentityPolicy { /// Construct new `CookieIdentityPolicy` instance. /// /// Panics if key length is less than 32 bytes. pub fn new(key: &[u8]) -> CookieIdentityPolicy { CookieIdentityPolicy(Rc::new(CookieIdentityInner::new(key))) } /// Sets the `path` field in the session cookie being built. pub fn path>(mut self, value: S) -> CookieIdentityPolicy { Rc::get_mut(&mut self.0).unwrap().path = value.into(); self } /// Sets the `name` field in the session cookie being built. pub fn name>(mut self, value: S) -> CookieIdentityPolicy { Rc::get_mut(&mut self.0).unwrap().name = value.into(); self } /// Sets the `domain` field in the session cookie being built. pub fn domain>(mut self, value: S) -> CookieIdentityPolicy { Rc::get_mut(&mut self.0).unwrap().domain = Some(value.into()); self } /// 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 secure(mut self, value: bool) -> CookieIdentityPolicy { Rc::get_mut(&mut self.0).unwrap().secure = value; self } /// Sets the `max-age` field in the session cookie being built. pub fn max_age(mut self, value: Duration) -> CookieIdentityPolicy { Rc::get_mut(&mut self.0).unwrap().max_age = Some(value); self } /// Sets the `same_site` field in the session cookie being built. pub fn same_site(mut self, same_site: SameSite) -> Self { Rc::get_mut(&mut self.0).unwrap().same_site = Some(same_site); self } } impl IdentityPolicy for CookieIdentityPolicy { type Future = Result, Error>; type ResponseFuture = Result<(), Error>; fn from_request

(&self, req: &mut ServiceRequest

) -> Self::Future { Ok(self.0.load(req)) } fn to_response( &self, id: Option, changed: bool, res: &mut ServiceResponse, ) -> Self::ResponseFuture { if changed { let _ = self.0.set_cookie(res, id); } Ok(()) } }