rustauth-plugins 0.2.0

Official RustAuth plugin modules.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Bearer token plugin.

mod request;
mod response;

use rustauth_core::plugin::AuthPlugin;
use serde_json::json;

pub const UPSTREAM_PLUGIN_ID: &str = "bearer";

/// Options for bearer token authentication.
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub struct BearerOptions {
    /// Require bearer tokens to already be signed session-cookie values.
    pub require_signature: bool,
}

impl BearerOptions {
    #[must_use]
    pub fn builder() -> BearerOptionsBuilder {
        BearerOptionsBuilder::default()
    }
}

#[derive(Debug, Clone, Copy, Default)]
pub struct BearerOptionsBuilder {
    require_signature: Option<bool>,
}

impl BearerOptionsBuilder {
    #[must_use]
    pub fn require_signature(mut self, require_signature: bool) -> Self {
        self.require_signature = Some(require_signature);
        self
    }

    #[must_use]
    pub fn build(self) -> BearerOptions {
        let defaults = BearerOptions::default();
        BearerOptions {
            require_signature: self.require_signature.unwrap_or(defaults.require_signature),
        }
    }
}

/// Create the bearer plugin.
#[must_use]
pub fn bearer(options: BearerOptions) -> AuthPlugin {
    AuthPlugin::new(UPSTREAM_PLUGIN_ID)
        .with_version(crate::VERSION)
        .with_options(json!({
            "requireSignature": options.require_signature,
        }))
        .with_on_request(move |context, request| request::handle(context, request, options))
        .with_on_response(response::handle)
}