oidc_verify 0.2.0

A simple-usage OIDC-RS256 token verifier. It works without `authorization_endpoint` field, such as Firebase Auth.
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

use url::Url;

/// An error that occurred while verifying a token.
#[derive(Debug, thiserror::Error, Clone)]
pub enum VerifyError {
    /// The token is invalid. Equivalent to an authentication error (401 error).
    #[error(transparent)]
    ValidationFailed(#[from] ValidationError),

    /// Could not check the token because the verifier is not connected to the issuer.
    /// Equivalent to a internal server error (500 error).
    #[error(transparent)]
    NotConnected(#[from] ConnectionError),
}

/// An error that occurred while validating a token.
#[derive(Debug, thiserror::Error, Clone)]
pub enum ValidationError {
    /// The token is broken.
    #[error("the token is broken")]
    Broken,

    /// The pubkey is not found.
    #[error("the pubkey not found")]
    PubkeyNotFound,

    /// The token is invalid.
    #[error("the token is invalid")]
    Invalid,
}

/// An error that occurred while connecting to the issuer.
#[derive(Debug, thiserror::Error, Clone)]
pub enum ConnectionError {
    /// An error occurred while fetching data.
    #[error(transparent)]
    FetchError(#[from] FetchError),

    /// The issuer configuration is unsupported.
    #[error("the issuer does not support the required features")]
    UnmatchConfiguration,

    /// The issuer configuration is broken.
    #[error("the openid-configuration is broken.")]
    BrokenConfiguration,
}

/// An error that occurred while fetching data.
#[derive(Debug, thiserror::Error, Clone)]
pub enum FetchError {
    /// Could not fetch the URL.
    #[error("could not fetch the URL: {0}")]
    NetworkError(Url),

    /// Could not parse the data as JSON or specific-structured JSON.
    #[error("could not parse the data")]
    ParseError,
}