Struct OidcClient 

pub struct OidcClient<H = ReqwestOidcHttpClient> { /* private fields */ }

Stateful OIDC client with discovery and JWKS caching.

Implementations

impl OidcClient<ReqwestOidcHttpClient>

pub fn new(config: OidcConfig) -> Result<Self, OidcError>

Create an OIDC client using the default HTTP client.

Errors

Returns an error when the configuration is invalid or the default HTTP client cannot be constructed.

impl<H> OidcClient<H>

where H: OidcHttpClient,

pub fn with_http_client( config: OidcConfig, http_client: H, ) -> Result<Self, OidcError>

Create an OIDC client with a caller-supplied HTTP implementation.

Errors

Returns an error when the configuration is invalid.

pub async fn discover(&self) -> Result<OidcProviderMetadata, OidcError>

Fetch and cache the provider discovery document.

Errors

Returns an error when discovery fails or the document is invalid.

pub async fn build_authorization_request( &self, scopes: &[&str], ) -> Result<OidcAuthorizationRequest, OidcError>

Build a secure authorization request using exact-match redirect URI, state, nonce, and PKCE.

Errors

Returns an error when discovery fails.

pub async fn build_token_exchange_request( &self, pending: &OidcAuthorizationRequest, code: &str, returned_state: &str, code_verifier: Option<&str>, ) -> Result<OidcTokenExchangeRequest, OidcError>

Build token-exchange parameters while enforcing state and PKCE rules.

Errors

Returns an error when the callback state or PKCE data is invalid.

pub async fn validate_id_token( &self, id_token: &str, expected_nonce: Option<&str>, ) -> Result<OidcClaims, OidcError>

Validate an ID token using discovery metadata, cached JWKS, and the configured nonce.

Errors

Returns an error when the token is invalid or the provider cannot be reached.

pub async fn fetch_userinfo( &self, access_token: &str, ) -> Result<OidcUserInfo, OidcError>

Fetch the provider’s userinfo document using the bearer access token.

Errors

Returns an error when the provider does not expose userinfo or the request fails.

Trait Implementations

impl<H: Debug> Debug for OidcClient<H>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.