Package se.swedenconnect.opensaml.saml2.metadata.provider

Class MDQMetadataProvider

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

se.swedenconnect.opensaml.saml2.metadata.provider.AbstractMetadataProvider

se.swedenconnect.opensaml.saml2.metadata.provider.MDQMetadataProvider

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, MetadataProvider

public class MDQMetadataProvider
extends AbstractMetadataProvider

A MetadataProvider that supports the MDQ specification.

Note that getMetadata(), AbstractMetadataProvider.getServiceProviders() and AbstractMetadataProvider.getIdentityProviders() will only return those entities that have been fetched from the server using AbstractMetadataProvider.getEntityDescriptor(String).

Author:

Martin Lindström (martin@idsec.se)

Nested Class Summary

Nested classes/interfaces inherited from class se.swedenconnect.opensaml.saml2.metadata.provider.AbstractMetadataProvider

AbstractMetadataProvider.EntityDescriptorIterator

Constructor Summary

Constructors

Constructor	Description
MDQMetadataProvider(String metadataBaseUrl, org.apache.hc.client5.http.classic.HttpClient httpClient, String cacheBaseDir)	Constructor setting up a MetadataProvider that uses the MDQ protocol to download metadata for requested entities.

Method Summary

Modifier and Type	Method	Description
protected void	createMetadataResolver(boolean requireValidMetadata, boolean failFastInitialization, MetadataFilter filter)	Creates the specific MetadataResolver instance for the provider implementation.
protected void	destroyMetadataResolver()	Destroys the metadata resolver.
String	getID()	Returns the identifier for the provider.
XMLObject	getMetadata()	Gets all EntityDescriptor objects available in the cache and adds them to a EntitiesDescriptor object.
MetadataResolver	getMetadataResolver()	Returns the underlying OpenSAML metadata resolver.
protected void	initializeMetadataResolver()	Initializes the metadata resolver.
protected void	setMetadata(XMLObject metadata)	Assigns the metadata that was downloaded.

Methods inherited from class se.swedenconnect.opensaml.saml2.metadata.provider.AbstractMetadataProvider

createFilter, doDestroy, doInitialize, getEntityDescriptor, getEntityDescriptor, getIdentityProviders, getLastUpdate, getMetadataDOM, getServiceProviders, getSignatureVerificationCertificates, iterator, iterator, refresh, setExclusionPredicates, setFailFastInitialization, setInclusionPredicates, setKeepOnlySpAndIdps, setPerformSchemaValidation, setRequireValidMetadata, setSignatureVerificationCertificate, setSignatureVerificationCertificates

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

checkComponentActive, checkSetterPreconditions, destroy, ifDestroyedThrowDestroyedComponentException, ifInitializedThrowUnmodifiabledComponentException, ifNotInitializedThrowUninitializedComponentException, 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.DestructableComponent

destroy, isDestroyed

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

initialize, isInitialized

Constructor Details

MDQMetadataProvider

public MDQMetadataProvider(@Nonnull
 String metadataBaseUrl,
 @Nullable
 org.apache.hc.client5.http.classic.HttpClient httpClient,
 @Nullable
 String cacheBaseDir)
                    throws ResolverException

Constructor setting up a MetadataProvider that uses the MDQ protocol to download metadata for requested entities.

Parameters:

metadataBaseUrl - the base metadata URL (must not end with a /)

httpClient - the HTTP client instance to use, if null, HTTPMetadataProvider.createDefaultHttpClient() is used to create a default client

cacheBaseDir - the base directory where caches will be stored, if null, the caches are kept in memory

Throws:

ResolverException - for failures setting up the underlying MetadataResolver

Method Details

getID

public String getID()

Returns the identifier for the provider.

Returns:

the identifier

getMetadata

public XMLObject getMetadata()

Gets all EntityDescriptor objects available in the cache and adds them to a EntitiesDescriptor object.

Note: The MDQMetadataProvider version of this method does not return all metadata entries available at the source. It only returns those that have been downloaded by the provider and are present in the cache.

Specified by:

getMetadata in interface MetadataProvider

Overrides:

getMetadata in class AbstractMetadataProvider

Returns:

an XML element

setMetadata

protected void setMetadata(XMLObject metadata)

Assigns the metadata that was downloaded.

Overrides:

setMetadata in class AbstractMetadataProvider

Parameters:

metadata - metadata object

getMetadataResolver

public MetadataResolver getMetadataResolver()

Returns the underlying OpenSAML metadata resolver.

Returns:

OpenSAML metadata resolver

createMetadataResolver

protected void createMetadataResolver(boolean requireValidMetadata,
 boolean failFastInitialization,
 MetadataFilter filter)
                               throws ResolverException

Creates the specific MetadataResolver instance for the provider implementation.

The filter parameter is a MetadataFilter that must be installed for the resolver. Any other filters that should be installed by the specific instance should be placed last in a filter chain.

Specified by:

createMetadataResolver in class AbstractMetadataProvider

Parameters:

requireValidMetadata - should be passed into MetadataResolver.setRequireValidMetadata(boolean)

failFastInitialization - should be passed into AbstractMetadataResolver.setFailFastInitialization(boolean) (if applicable)

filter - filter that must be installed for the resolver

Throws:

ResolverException - for errors creating the resolver

initializeMetadataResolver

protected void initializeMetadataResolver()
                                   throws ComponentInitializationException

Initializes the metadata resolver.

Specified by:

initializeMetadataResolver in class AbstractMetadataProvider

Throws:

ComponentInitializationException - for initialization errors

destroyMetadataResolver

protected void destroyMetadataResolver()

Destroys the metadata resolver.

Specified by:

destroyMetadataResolver in class AbstractMetadataProvider