usso 0.4.0

The usso provides a universal single sign-on (SSO) integration for microservices, making it easy to add secure, scalable authentication across different frameworks. This client simplifies the process of connecting any microservice to the USSO service.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

//! Error types for the USSO client.
//!
//! - [`USSOError`] — authentication and authorization errors
//! - [`JwksError`] — JWKS fetching and caching errors
//! - [`JwtError`] — JWT parsing errors

use thiserror::Error;

/// Authentication and authorization errors returned by the library.
///
/// Each variant maps to an HTTP status code via [`status_code`](Self::status_code)
/// and a machine-readable error code via [`error_code`](Self::error_code).
#[derive(Error, Debug)]
pub enum USSOError {
    #[error("Invalid signature")]
    InvalidSignature,
    #[error("Invalid token")]
    InvalidToken,
    #[error("Expired token")]
    ExpiredToken,
    #[error("Unauthorized")]
    Unauthorized,
    #[error("Invalid token type")]
    InvalidTokenType,
    #[error("Permission denied")]
    PermissionDenied,
    #[error("{0}")]
    Other(String),
}

impl USSOError {
    /// Returns the HTTP status code for this error (401 for most, 403 for permission denied).
    pub fn status_code(&self) -> u16 {
        match self {
            USSOError::PermissionDenied => 403,
            _ => 401,
        }
    }

    /// Returns a machine-readable error code string for this error.
    pub fn error_code(&self) -> &str {
        match self {
            USSOError::InvalidSignature => "invalid_signature",
            USSOError::InvalidToken => "invalid_token",
            USSOError::ExpiredToken => "expired_signature",
            USSOError::Unauthorized => "unauthorized",
            USSOError::InvalidTokenType => "invalid_token_type",
            USSOError::PermissionDenied => "permission_denied",
            USSOError::Other(_) => "error",
        }
    }
}

/// Errors that can occur when fetching or caching JWKS keys.
#[derive(Error, Debug)]
pub enum JwksError {
    #[error("HTTP error: {0}")]
    ReqwestError(#[from] reqwest::Error),
    #[error("Invalid JWKS data: {0}")]
    InvalidJwksData(String),
    #[error("JWKS not initialized")]
    NotInitialized,
}

/// Errors that can occur when parsing JWT headers or payloads.
#[derive(Debug)]
pub enum JwtError {
    InvalidFormat,
    DecodingError(String),
    MissingField(String),
    InvalidToken(String),
}