bbjwt 0.4.2

A simple to use, well documented JWT validation library, mainly for validating OpenID Connect ID Tokens.
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//!
//! Error definitions for bbjwt.
//!
//! Copyright (c) 2022 basebox GmbH

/* --- uses ------------------------------------------------------------------------------------- */

use thiserror::Error;

/* --- public types ----------------------------------------------------------------------------- */

pub type BBResult<T> = Result<T, BBError>;

///
/// Errors used in bbjwt
#[allow(dead_code)]
#[derive(Debug, Error, PartialEq, Eq)]
pub enum BBError {
  #[error("Network/load error: {0}")]
  /// Some network communication failed.
  NetworkError(String),

  #[error("Token could not be parsed: {0}")]
  /// Token has invalid format.
  TokenInvalid(String),

  #[error("Invalid URL: {0}")]
  /// URL is invalid.
  URLInvalid(String),

  #[error("Fatal error: {0}")]
  /// A fatal error, we cannot continue.
  Fatal(String),

  #[error("JSON error: {0}")]
  /// JSON related error.
  JSONError(String),

  #[error("JWK data is invalid: {0}")]
  /// JWK contains invalid data
  JWKInvalid(String),

  #[error("Decoding error: {0}")]
  /// Decoding (base64) failed.
  DecodeError(String),

  #[error("Invalid claim value: {0}")]
  /// A claim did not validate/contained the wrong value.
  ClaimInvalid(String),

  #[error("Invalid signature")]
  /// The signature could not be verified.
  SignatureInvalid,

  #[error("Error: {0}")]
  /// Some other error.
  Other(String),

  #[error("Unknown/unspecified error")]
  /// Something went wrong for an unknown reason; should never be used :-)
  Unknown,
}

impl BBError {
  ///
  /// Return name for each error variant.
  pub fn name(&self) -> String {
    match self {
      Self::NetworkError(_) => "NetworkError".to_string(),
      Self::TokenInvalid(_) => "TokenInvalid".to_string(),
      Self::URLInvalid(_) => "URLInvalid".to_string(),
      Self::JWKInvalid(_) => "JWKInvalid".to_string(),
      Self::Fatal(_) => "Fatal".to_string(),
      Self::DecodeError(_) => "DecodeError".to_string(),
      Self::JSONError(_) => "JSONError".to_string(),
      Self::ClaimInvalid(_) => "ClaimInvalid".to_string(),
      Self::SignatureInvalid => "SignatureInvalid".to_string(),
      Self::Other(_) => "Other".to_string(),
      Self::Unknown => "Unknown".to_string(),
    }
  }
}

impl From<base64::DecodeError> for BBError {
  fn from(err: base64::DecodeError) -> Self {
    BBError::DecodeError(err.to_string())
  }
}

impl From<serde_json::Error> for BBError {
  fn from(err: serde_json::Error) -> Self {
    BBError::JSONError(err.to_string())
  }
}