cf_access/error.rs
1/*
2 * MIT License
3 *
4 * Copyright (c) 2025 Jasmine Tai
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy of
7 * this software and associated documentation files (the "Software"), to deal in
8 * the Software without restriction, including without limitation the rights to
9 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
10 * of the Software, and to permit persons to whom the Software is furnished to do
11 * so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in all
14 * copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 */
24
25use thiserror::Error;
26
27/// An error that can occur when validating a JWT or constructing a
28/// [`Validator`](super::Validator).
29#[derive(Debug, Error)]
30#[non_exhaustive]
31pub enum Error {
32 /// Error originated from [`jwtk`].
33 #[error("{0}")]
34 Jwtk(#[from] jwtk::Error),
35 /// Invalid audience.
36 #[error("token has invalid audience")]
37 InvalidAud,
38 /// Missing `sub` claim in an identity token.
39 #[error("token is missing 'sub' claim")]
40 MissingSub,
41 /// Error from [`uuid`] crate.
42 #[error("UUID parse error: {0}")]
43 Uuid(#[from] uuid::Error),
44 /// Missing environment variable.
45 #[cfg(feature = "env")]
46 #[error("missing environment variable '{0}'")]
47 MissingEnv(&'static str),
48}