Package net.shibboleth.oidc.metadata.impl

Class HTTPProviderConfigurationFetchingStrategy

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

net.shibboleth.oidc.metadata.impl.AbstractDynamicHTTPFetchingStrategy<OIDCProviderMetadata>

net.shibboleth.oidc.metadata.impl.HTTPProviderConfigurationFetchingStrategy

All Implemented Interfaces:

Function<CriteriaSet,OIDCProviderMetadata>, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent

@ThreadSafe
public class HTTPProviderConfigurationFetchingStrategy
extends AbstractDynamicHTTPFetchingStrategy<OIDCProviderMetadata>

A dynamic strategy for fetching OpenID Connect Provider Configuration Metadata from its well-known location (OpenID Connect Discovery 1.0, section 4).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	HTTPProviderConfigurationFetchingStrategy.DefaultWellKnownPathCompositionStrategy	Default strategy for composing a well-known URL to fetch a provider's configuration document from.
static final class	HTTPProviderConfigurationFetchingStrategy.OIDCProviderMetadataResponseHandler	The response handler for parsing the providers's configuration information into OIDCProviderMetadata.

Field Summary

Fields

Modifier and Type	Field	Description
private static final MediaType	CONTENT_TYPE	The returned content_type, must be application/json see openid-connect-discovery section 4.
private static final String	DEFAULT_OPENID_PROVIDER_WELL_KNOWN_PATH	The default well-known path for OpenID Provider metadata.
private final org.slf4j.Logger	log	Class logger.
private BiFunction<Issuer,String,String>	wellKnownLocationCompositionStrategy	Strategy for composing an issuer with the well-known configuration path.
private String	wellKnownPath	The well-known path for OpenID Provider metadata.

Fields inherited from class net.shibboleth.oidc.metadata.impl.AbstractDynamicHTTPFetchingStrategy

MDC_ATTRIB_CURRENT_REQUEST_URI

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HTTPProviderConfigurationFetchingStrategy(org.apache.hc.client5.http.classic.HttpClient client, org.apache.hc.core5.http.io.HttpClientResponseHandler<OIDCProviderMetadata> handler)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected String	buildRequestURL(CriteriaSet criteria)	Build the request URL based on the input criteria set.
void	setWellKnownLocationCompositionStrategy(BiFunction<Issuer,String,String> strategy)	Set the well-known location composition strategy.
void	setWellKnownPath(String path)	Set the well-known URL path component.

Methods inherited from class net.shibboleth.oidc.metadata.impl.AbstractDynamicHTTPFetchingStrategy

apply, doInitialize, getSupportedContentTypes, setHttpClientSecurityParameters, setSupportedContentTypes

Methods inherited from class net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

ensureId, getId, ifDestroyedThrowDestroyedComponentException, ifInitializedThrowUnmodifiabledComponentException, ifNotInitializedThrowUninitializedComponentException

Methods inherited from class net.shibboleth.shared.component.AbstractInitializableComponent

checkComponentActive, checkSetterPreconditions, destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.function.Function

andThen, compose

Methods inherited from interface net.shibboleth.shared.component.IdentifiedComponent

getId

Field Details

CONTENT_TYPE

@Nonnull
private static final MediaType CONTENT_TYPE

The returned content_type, must be application/json see openid-connect-discovery section 4.

DEFAULT_OPENID_PROVIDER_WELL_KNOWN_PATH

@Nonnull
@NotEmpty
private static final String DEFAULT_OPENID_PROVIDER_WELL_KNOWN_PATH

The default well-known path for OpenID Provider metadata.

See Also:

• Constant Field Values

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

wellKnownPath

@Nonnull
@NotEmpty
private String wellKnownPath

The well-known path for OpenID Provider metadata.

wellKnownLocationCompositionStrategy

@Nonnull
private BiFunction<Issuer,String,String> wellKnownLocationCompositionStrategy

Strategy for composing an issuer with the well-known configuration path.

Constructor Details

HTTPProviderConfigurationFetchingStrategy

protected HTTPProviderConfigurationFetchingStrategy(@Nonnull
 org.apache.hc.client5.http.classic.HttpClient client,
 @Nonnull
 org.apache.hc.core5.http.io.HttpClientResponseHandler<OIDCProviderMetadata> handler)

Constructor.

Parameters:

client - the HTTP client

handler - response handler

Method Details

setWellKnownPath

public void setWellKnownPath(@Nonnull @NotEmpty
 String path)

Set the well-known URL path component.

Defaults to "/.well-known/openid-configuration".

Parameters:

path - the path.

setWellKnownLocationCompositionStrategy

public void setWellKnownLocationCompositionStrategy(@Nullable
 BiFunction<Issuer,String,String> strategy)

Set the well-known location composition strategy.

Parameters:

strategy - the strategy to set.

buildRequestURL

protected String buildRequestURL(@Nullable
 CriteriaSet criteria)

Build the request URL based on the input criteria set.

Specified by:

buildRequestURL in class AbstractDynamicHTTPFetchingStrategy<OIDCProviderMetadata>

Parameters:

criteria - the input criteria set

Returns:

the request URL, or null if it can not be built based on the supplied criteria