Package net.shibboleth.oidc.metadata.impl

Class FilesystemClientInformationResolver

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

net.shibboleth.oidc.metadata.impl.AbstractOIDCEntityResolver<Key,Value>

net.shibboleth.oidc.metadata.impl.AbstractReloadingOIDCEntityResolver<Key,Value>

net.shibboleth.oidc.metadata.impl.AbstractFileOIDCEntityResolver<ClientID,OIDCClientInformation>

net.shibboleth.oidc.metadata.impl.FilesystemClientInformationResolver

All Implemented Interfaces:

ClientInformationResolver, RefreshableClientInformationResolver, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, Resolver<OIDCClientInformation,CriteriaSet>

public class FilesystemClientInformationResolver
extends AbstractFileOIDCEntityResolver<ClientID,OIDCClientInformation>
implements RefreshableClientInformationResolver

An OIDC metadata provider that pulls client metadata from a file on the local filesystem. Based on FilesystemMetadataResolver.

Nested Class Summary

Nested classes/interfaces inherited from class net.shibboleth.oidc.metadata.impl.AbstractOIDCEntityResolver

AbstractOIDCEntityResolver.JsonBackingStore

Field Summary

Fields

Modifier and Type	Field	Description
private final org.slf4j.Logger	log	Class logger.

Constructor Summary

Constructors

Constructor	Description
FilesystemClientInformationResolver(Timer backgroundTaskTimer, Resource metadata)	Constructor.
FilesystemClientInformationResolver(Resource metadata)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected void	doInitialize()
protected ClientID	getKey(OIDCClientInformation value)	Gets the identifier for the given entity.
protected List<OIDCClientInformation>	parse(byte[] bytes)	Parses an entity from the byte array.
Iterable<OIDCClientInformation>	resolve(CriteriaSet criteria)
OIDCClientInformation	resolveSingle(CriteriaSet criteria)
protected List<OIDCClientInformation>	updateKeys(List<OIDCClientInformation> clientInformations)	Updates the key set in the given list of OIDC client informations.

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

fetchMetadata, getMetadataIdentifier, getMetadataUpdateTime, setMetadataFile

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

getLastRefresh, getLastUpdate, initOIDCResolver, refresh, scheduleNextRefresh, setMaxRefreshDelay, setMinRefreshDelay

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

createNewBackingStore, getBackingStore, getLogPrefix, indexEntityDescriptor, isFailFastInitialization, lookupIdentifier, lookupIndexedIdentifier, preProcessEntityDescriptor, removeByIdentifier, setBackingStore, setFailFastInitialization

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 net.shibboleth.shared.component.IdentifiedComponent

getId

Methods inherited from interface net.shibboleth.oidc.metadata.RefreshableClientInformationResolver

getLastRefresh, getLastUpdate, refresh

Field Details

log

private final org.slf4j.Logger log

Class logger.

Constructor Details

FilesystemClientInformationResolver

public FilesystemClientInformationResolver(@Nonnull
 Resource metadata)
                                    throws IOException

Constructor.

Parameters:

metadata - the metadata file

Throws:

IOException - If the metedata cannot be loaded.

FilesystemClientInformationResolver

public FilesystemClientInformationResolver(@Nullable
 Timer backgroundTaskTimer,
 @Nonnull
 Resource metadata)
                                    throws IOException

Constructor.

Parameters:

metadata - the metadata file

backgroundTaskTimer - timer used to refresh metadata in the background

Throws:

IOException - If the metedata cannot be loaded.

Method Details

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractOIDCEntityResolver<ClientID,OIDCClientInformation>

Throws:

ComponentInitializationException

resolve

@Nonnull
public Iterable<OIDCClientInformation> resolve(@Nullable
 CriteriaSet criteria)
                                        throws ResolverException

Specified by:

resolve in interface Resolver<OIDCClientInformation,CriteriaSet>

Throws:

ResolverException

updateKeys

@Nonnull
protected List<OIDCClientInformation> updateKeys(@Nonnull
 List<OIDCClientInformation> clientInformations)

Updates the key set in the given list of OIDC client informations. The configured remote JWK set cache is exploited.

Parameters:

clientInformations - The OIDC client informations whose keys are going to be updated.

Returns:

The OIDC client informations, containing contents of getJWKSetURI() in getJWKSet().

resolveSingle

@Nullable
public OIDCClientInformation resolveSingle(@Nullable
 CriteriaSet criteria)
                                    throws ResolverException

Specified by:

resolveSingle in interface Resolver<OIDCClientInformation,CriteriaSet>

Throws:

ResolverException

parse

@Nonnull
protected List<OIDCClientInformation> parse(@Nonnull
 byte[] bytes)
                                     throws ParseException

Parses an entity from the byte array.

Specified by:

parse in class AbstractReloadingOIDCEntityResolver<ClientID,OIDCClientInformation>

Parameters:

bytes - The encoded entity

Returns:

The parsed entity

Throws:

ParseException - if parse fails

getKey

@Nonnull
protected ClientID getKey(@Nonnull
 OIDCClientInformation value)

Gets the identifier for the given entity.

Specified by:

getKey in class AbstractReloadingOIDCEntityResolver<ClientID,OIDCClientInformation>

Parameters:

value - The entity whose identifier will be returned.

Returns:

The identifier for the given entity.