volga-oauth-client 0.9.7

OAuth 2.1/OIDC client for Volga Web Framework
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

//! OAuth 2.1 / OpenID Connect client for Volga
//!
//! Built on the shared protocol types from [`volga-oauth-core`](volga_oauth_core)
//! (re-exported here) and independent of the `volga` server crate - usable
//! from any Tokio application.
//!
//! Provides:
//! * [`DiscoveryClient`] - Authorization Server Metadata (RFC 8414),
//!   Protected Resource Metadata (RFC 9728) and OpenID Connect provider
//!   configuration, with the validation the specs require.
//! * [`OAuthClient`] - the OAuth 2.1 Authorization Code flow with
//!   mandatory PKCE ([`Pkce`], S256 only), refresh tokens and resource
//!   indicators (RFC 8707), plus token persistence through the
//!   [`TokenStore`] abstraction.
//! * [`RegistrationClient`] - Dynamic Client Registration (RFC 7591).
//!
//! All of them share the transport policy of [`ClientConfig`] and the
//! error model of [`ClientError`].

#[cfg(not(any(feature = "http1", feature = "http2")))]
compile_error!(
    "volga-oauth-client requires at least one of the `http1` or `http2` features to be enabled"
);

pub use cache::MetadataCache;
pub use client::{
    AuthorizationRequest, AuthorizationRequestBuilder, ClientAuthMethod, OAuthClient,
};
pub use config::{ClientConfig, DEFAULT_MAX_REDIRECTS, DEFAULT_TIMEOUT};
pub use discovery::DiscoveryClient;
pub use error::ClientError;
pub use pkce::{PKCE_METHOD, Pkce};
pub use registration::RegistrationClient;
pub use store::{InMemoryTokenStore, TokenStore};
pub use token::{TokenResponse, TokenSet};

// Shared protocol types (`volga::auth::oauth` re-exports the same set)
pub use volga_oauth_core::{
    AuthorizationServerMetadata, BearerChallenge, ClientMetadata, ClientRegistrationResponse,
    OAuthError, OAuthErrorCode, ProtectedResourceMetadata, WELL_KNOWN_AUTHORIZATION_SERVER,
    WELL_KNOWN_OPENID_CONFIGURATION, WELL_KNOWN_PROTECTED_RESOURCE,
    authorization_server_metadata_url, canonicalize_resource_uri, openid_configuration_url,
    protected_resource_metadata_url,
};

mod cache;
mod client;
mod config;
mod discovery;
mod error;
mod pkce;
mod registration;
mod store;
mod token;
mod transport;