Package org.opensaml.xmlsec.keyinfo.impl.provider

Class KeyInfoReferenceProvider

java.lang.Object

org.opensaml.xmlsec.keyinfo.impl.provider.AbstractKeyInfoProvider

org.opensaml.xmlsec.keyinfo.impl.provider.KeyInfoReferenceProvider

All Implemented Interfaces:

KeyInfoProvider

public class KeyInfoReferenceProvider
extends AbstractKeyInfoProvider

Implementation of KeyInfoProvider which supports KeyInfoReference.

To prevent cycles, only a single reference step is permitted. Only same-document references are supported.

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
KeyInfoReferenceProvider()

Method Summary

Modifier and Type	Method	Description
protected KeyInfoReference	getKeyInfoReference(XMLObject xmlObject)	Get the KeyInfoReference from the passed XML object.
boolean	handles(XMLObject keyInfoChild)	Evaluate whether the given provider should attempt to handle resolving a credential from the specified KeyInfo child.
Collection<Credential>	process(KeyInfoCredentialResolver resolver, XMLObject keyInfoChild, CriteriaSet criteriaSet, KeyInfoResolutionContext kiContext)	Process a specified KeyInfo child (XMLobject) and attempt to resolve a credential from it.

Methods inherited from class org.opensaml.xmlsec.keyinfo.impl.provider.AbstractKeyInfoProvider

buildCredentialContext, extractKeyValue

Methods inherited from class java.lang.Object

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

Field Detail

log

private final org.slf4j.Logger log

Class logger.

Constructor Detail

KeyInfoReferenceProvider

public KeyInfoReferenceProvider()

Method Detail

handles

public boolean handles(@Nonnull
                       XMLObject keyInfoChild)

Evaluate whether the given provider should attempt to handle resolving a credential from the specified KeyInfo child. An evaluation of true does not guarantee that a credential can or will be extracted form the particular KeyInfo child, only that processing should be attempted.

Parameters:

keyInfoChild - the KeyInfo child object to consider

Returns:

true if the provider should attempt to resolve credentials, false otherwise

process

@Nullable
public Collection<Credential> process(@Nonnull
                                      KeyInfoCredentialResolver resolver,
                                      @Nonnull
                                      XMLObject keyInfoChild,
                                      @Nullable
                                      CriteriaSet criteriaSet,
                                      @Nonnull
                                      KeyInfoResolutionContext kiContext)
                               throws SecurityException

Process a specified KeyInfo child (XMLobject) and attempt to resolve a credential from it.

Parameters:

resolver - reference to a resolver which is calling the provider

keyInfoChild - the KeyInfo child being processed

criteriaSet - the credential criteria the credential must satisfy

kiContext - the resolution context, used for sharing state amongst resolvers and providers

Returns:

a resolved Credential collection, or null

Throws:

SecurityException - if there is an error during credential resolution. Note: failure to resolve a credential is not an error.

getKeyInfoReference

@Nullable
protected KeyInfoReference getKeyInfoReference(@Nonnull
                                               XMLObject xmlObject)

Get the KeyInfoReference from the passed XML object.

Parameters:

xmlObject - an XML object, presumably a KeyInfoReference

Returns:

the KeyInfoReference which was found, or null if none or invalid