alibi-plugins 0.8.0

Built-in authentication plugins and API metadata for Alibi
Documentation
//! Scoped user claims resolved from the real issued access-token authority.
use super::OAuthProviderPlugin;
use alibi_core::endpoint::{EndpointResponse, ServerEndpoint};
use alibi_core::session::SessionRequest;
use alibi_core::store::{OAuthToken, OAuthTokenKind};
use alibi_core::utils::json::JsValue;
use alibi_core::{AuthContext, AuthResult, AuthSchema, AuthSession, HttpMethod};
use base64::{Engine as _, engine::general_purpose::URL_SAFE_NO_PAD};
use serde_json::{Value, json};
use sha2::{Digest as _, Sha256};
/// The shared access-token liveness gate used by public protocol consumers.
pub(super) async fn live_access<S: AuthSchema>(
    token: &str,
    ctx: &AuthContext<S>,
) -> AuthResult<Option<OAuthToken>> {
    let hash = URL_SAFE_NO_PAD.encode(Sha256::digest(token));
    let Some(row) = ctx
        .database
        .get_oauth_token(OAuthTokenKind::Access, &hash)
        .await?
    else {
        return Ok(None);
    };
    if row.expires_at < chrono::Utc::now()
        || row.metadata.get("revoked").is_some_and(|v| !v.is_null())
    {
        return Ok(None);
    }
    let Some(client) = ctx.database.get_oauth_client(&row.client_id).await? else {
        return Ok(None);
    };
    if client.metadata.get("disabled") == Some(&Value::Bool(true)) {
        return Ok(None);
    }
    if let Some(session) = row.session_id.as_deref() {
        let sessions = if let Some(user) = row.user_id.as_deref() {
            ctx.database.get_user_sessions(user).await?
        } else {
            Vec::new()
        };
        if !sessions
            .iter()
            .any(|value| value.id().as_ref() == session && value.expires_at() >= chrono::Utc::now())
        {
            return Ok(None);
        }
    }
    Ok(Some(row))
}
impl OAuthProviderPlugin {
    /// Read the current user claims authorized by an OAuth access token.
    #[must_use]
    pub fn oauth2_user_info_endpoint() -> ServerEndpoint<Value> {
        ServerEndpoint::new("oauth-provider", "oauth2UserInfo")
    }
    pub(super) async fn user_info<S: AuthSchema>(
        &self,
        input: Option<&JsValue>,
        req: &impl SessionRequest,
        ctx: &AuthContext<S>,
    ) -> AuthResult<EndpointResponse> {
        let headers = req.session_headers();
        let header = headers
            .iter()
            .find(|(name, _)| name.eq_ignore_ascii_case("authorization"))
            .map(|(_, value)| value.trim())
            .filter(|value| !value.is_empty());
        let authorization = header.map(|value| {
            let index = value.find(char::is_whitespace);
            if let Some(index) = index {
                let (scheme, rest) = value.split_at(index);
                let rest = rest.trim();
                if scheme.eq_ignore_ascii_case("Bearer") {
                    return (rest, "Bearer");
                }
                if scheme.eq_ignore_ascii_case("DPoP") {
                    return (rest, "DPoP");
                }
            }
            (value, "Unknown")
        });
        let body_token = if req
            .physical_request()
            .is_some_and(|request| *request.method() == HttpMethod::Post)
        {
            input
                .and_then(|value| value.get("access_token"))
                .and_then(JsValue::as_str)
                .filter(|value| !value.is_empty())
        } else {
            None
        };
        if authorization.is_some() && body_token.is_some() {
            return error(
                400,
                "invalid_request",
                "Multiple access token transport methods are not allowed",
            );
        }
        let Some((token, scheme)) =
            authorization.or_else(|| body_token.map(|token| (token, "Bearer")))
        else {
            return error(401, "invalid_request", "access token not found");
        };
        let Some(row) = live_access(token, ctx).await? else {
            return invalid_token();
        };
        if scheme == "DPoP" {
            return error(
                401,
                "invalid_token",
                "DPoP authorization requires a DPoP-bound access token",
            );
        }
        let scopes = row
            .metadata
            .get("scopes")
            .and_then(Value::as_array)
            .map(|values| values.iter().filter_map(Value::as_str).collect::<Vec<_>>())
            .unwrap_or_default();
        if !scopes.contains(&"openid") {
            return error(400, "invalid_scope", "Missing required scope");
        }
        let Some(id) = row.user_id.as_deref() else {
            return error(400, "invalid_request", "user not found");
        };
        let Some(user) = ctx.database.get_user_by_id(id).await? else {
            return error(400, "invalid_request", "user not found");
        };
        let user = ctx.user_view(&user);
        let mut claims = serde_json::Map::from_iter([("sub".into(), json!(user.id))]);
        if scopes.contains(&"profile") {
            if let Some(name) = user.name {
                _ = claims.insert("name".into(), json!(name));
                let parts = name
                    .split(' ')
                    .filter(|value| !value.is_empty())
                    .collect::<Vec<_>>();
                if let Some((family, given)) = parts.split_last()
                    && !given.is_empty()
                {
                    _ = claims.insert("given_name".into(), json!(given.join(" ")));
                    _ = claims.insert("family_name".into(), json!(family));
                }
            }
            if let Some(image) = user.image {
                _ = claims.insert("picture".into(), json!(image));
            }
        }
        if scopes.contains(&"email") {
            if let Some(email) = user.email {
                _ = claims.insert("email".into(), json!(email));
            }
            _ = claims.insert("email_verified".into(), json!(user.email_verified));
        }
        Ok(no_store(EndpointResponse::json(&claims)?))
    }
}
fn no_store(response: EndpointResponse) -> EndpointResponse {
    response
        .with_header("Cache-Control", "no-store")
        .with_header("Pragma", "no-cache")
}
fn error(status: u16, code: &str, description: &str) -> AuthResult<EndpointResponse> {
    super::clients::status_protocol_error(status, code, description).map(no_store)
}
fn invalid_token() -> AuthResult<EndpointResponse> {
    error(401, "invalid_token", "Invalid access token").map(|response| {
        response.with_header(
            "WWW-Authenticate",
            "Bearer error=\"invalid_token\", error_description=\"Invalid access token\"",
        )
    })
}