zitadel 4.0.2

An implementation of ZITADEL API access and authentication in Rust.
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

//! Module that enables and supports caching of introspection results.
//! Caching the returned introspection results can be useful to reduce the load on the
//! ZITADEL server. Depending on the enabled features, the cache can be persisted
//! or only be kept in memory.

pub mod in_memory;

type Response = super::ZitadelIntrospectionResponse;

/// Implementation of an introspection cache.
/// Enables caching the introspection results done by
/// [introspect](crate::oidc::introspection::introspect).
///
/// The cache MUST respect the `expires_in` field of the introspection result.
/// If, by any means, the `exp` field is not set, the cache MUST NOT cache the result.
///
/// ZITADEL will always set the `exp` field, if the token is "active".
///
/// Non-active tokens SHOULD not be cached.
#[async_trait::async_trait]
pub trait IntrospectionCache: Send + Sync + std::fmt::Debug {
    /// Retrieves the cached introspection result for the given token, if it exists.
    async fn get(&self, token: &str) -> Option<Response>;

    /// Caches the given introspection result for the given token.
    /// If the token is not active, the result is not cached.
    async fn set(&self, token: &str, response: Response);

    /// Clears the cache.
    async fn clear(&self);
}