Struct Providers 

pub struct Providers {
    services: Arc<OnceServices>,
    providers: RwLock<BTreeMap<ProviderId, Provider>>,
}

Discovered providers

Fields

services: Arc<OnceServices>

providers: RwLock<BTreeMap<ProviderId, Provider>>

Implementations

impl Providers

pub(super) fn build(args: &Args<'_>) -> Self

impl Providers

pub async fn get(&self, id: &str) -> Result<Provider>

Get the Provider configuration after any discovery and adjustments made on top of the admin’s configuration. This incurs network-based discovery on the first call but responds from cache on subsequent calls.

impl Providers

pub fn get_config(&self, id: &str) -> Result<Provider>

Get the admin-configured Provider which exists prior to any reconciliation with the well-known discovery (the server’s config is immutable); though it is important to note the server config can be reloaded. This will Err NotFound for a non-existent idp.

When no provider is found with a matching client_id, providers are then searched by brand. Brand matching will be invalidated when more than one provider matches the brand.

impl Providers

pub fn get_default_id(&self) -> Option<String>

Get the ID of the provider considered “default” as selected by the admin or by fallback.

impl Providers

async fn get_cached(&self, id: &str) -> Option<Provider>

Get the discovered provider from the runtime cache. ID may be client_id or brand if brand is unique among provider configurations.

impl Providers

async fn configure(&self, provider: Provider) -> Result<Provider>

Configure an identity provider; takes the admin-configured instance from the server’s config, queries the provider for discovery, and then returns an updated config based on the proper reconciliation. This final config is then cached in memory to avoid repeating this process.

impl Providers

pub async fn discover(&self, provider: &Provider) -> Result<JsonValue>

Send a network request to a provider at the computed location of the .well-known/openid-configuration, returning the configuration.

Trait Implementations

impl Default for Providers

fn default() -> Providers

Returns the “default value” for a type.