Class RetrievalMethodResolver

java.lang.Object

org.apache.xml.security.keys.keyresolver.KeyResolverSpi

org.apache.xml.security.keys.keyresolver.implementations.RetrievalMethodResolver

public class RetrievalMethodResolver
extends KeyResolverSpi

The RetrievalMethodResolver can retrieve public keys and certificates from other locations. The location is specified using the ds:RetrievalMethod element which points to the location. This includes the handling of raw (binary) X.509 certificate which are not encapsulated in an XML structure. If the retrieval process encounters an element which the RetrievalMethodResolver cannot handle itself, resolving of the extracted element is delegated back to the KeyResolver mechanism.

Field Summary

Fields

Modifier and Type	Field	Description
private static final org.slf4j.Logger	LOG

Fields inherited from class KeyResolverSpi

globalResolver, properties, secureValidation

Constructor Summary

Constructors

Constructor	Description
RetrievalMethodResolver()

Method Summary

Modifier and Type	Method	Description
PublicKey	engineLookupAndResolvePublicKey(Element element, String baseURI, StorageResolver storage)	Method engineResolvePublicKey Method engineLookupAndResolvePublicKey
SecretKey	engineLookupAndResolveSecretKey(Element element, String baseURI, StorageResolver storage)	Method engineResolveSecretKey Method engineLookupAndResolveSecretKey
X509Certificate	engineLookupResolveX509Certificate(Element element, String baseURI, StorageResolver storage)	Method engineResolveX509Certificate Method engineLookupResolveX509Certificate
private static Element	getDocumentElement(Set<Node> set)
private static X509Certificate	getRawCertificate(XMLSignatureInput resource)
private static Element	obtainReferenceElement(XMLSignatureInput resource, boolean secureValidation)
private static X509Certificate	resolveCertificate(Element e, String baseURI, StorageResolver storage)	Retrieves a x509Certificate from the given information
private static XMLSignatureInput	resolveInput(RetrievalMethod rm, String baseURI, boolean secureValidation)	Resolves the input from the given retrieval method
private static PublicKey	resolveKey(Element e, String baseURI, StorageResolver storage)	Retrieves a PublicKey from the given information

Methods inherited from class KeyResolverSpi

engineCanResolve, engineGetProperty, engineLookupAndResolvePrivateKey, engineResolvePublicKey, engineResolveSecretKey, engineResolveX509Certificate, engineSetProperty, getDocFromBytes, setGlobalResolver, setSecureValidation, understandsProperty

Methods inherited from class Object

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

Field Details

LOG

private static final org.slf4j.Logger LOG

Constructor Details

RetrievalMethodResolver

public RetrievalMethodResolver()

Method Details

engineLookupAndResolvePublicKey

public PublicKey engineLookupAndResolvePublicKey(Element element,
 String baseURI,
 StorageResolver storage)

Method engineResolvePublicKey Method engineLookupAndResolvePublicKey

Overrides:

engineLookupAndResolvePublicKey in class KeyResolverSpi

Parameters:

element -

baseURI -

storage -

Returns:

resolved public key from the registered from the element.

engineLookupResolveX509Certificate

public X509Certificate engineLookupResolveX509Certificate(Element element,
 String baseURI,
 StorageResolver storage)

Method engineResolveX509Certificate Method engineLookupResolveX509Certificate

Overrides:

engineLookupResolveX509Certificate in class KeyResolverSpi

Parameters:

element -

baseURI -

storage -

Returns:

resolved X509Certificate key from the registered from the elements

resolveCertificate

private static X509Certificate resolveCertificate(Element e,
 String baseURI,
 StorageResolver storage)
                                           throws KeyResolverException

Retrieves a x509Certificate from the given information

Parameters:

e -

baseURI -

storage -

Returns:

a x509Certificate from the given information

Throws:

KeyResolverException

resolveKey

private static PublicKey resolveKey(Element e,
 String baseURI,
 StorageResolver storage)
                             throws KeyResolverException

Retrieves a PublicKey from the given information

Parameters:

e -

baseURI -

storage -

Returns:

a PublicKey from the given information

Throws:

KeyResolverException

obtainReferenceElement

private static Element obtainReferenceElement(XMLSignatureInput resource,
 boolean secureValidation)
                                       throws CanonicalizationException,
ParserConfigurationException,
IOException,
SAXException,
KeyResolverException

Throws:

CanonicalizationException

ParserConfigurationException

IOException

SAXException

KeyResolverException

getRawCertificate

private static X509Certificate getRawCertificate(XMLSignatureInput resource)
                                          throws CanonicalizationException,
IOException,
CertificateException

Throws:

CanonicalizationException

IOException

CertificateException

resolveInput

private static XMLSignatureInput resolveInput(RetrievalMethod rm,
 String baseURI,
 boolean secureValidation)
                                       throws XMLSecurityException

Resolves the input from the given retrieval method

Returns:

the input from the given retrieval method

Throws:

XMLSecurityException

engineLookupAndResolveSecretKey

public SecretKey engineLookupAndResolveSecretKey(Element element,
 String baseURI,
 StorageResolver storage)

Method engineResolveSecretKey Method engineLookupAndResolveSecretKey

Overrides:

engineLookupAndResolveSecretKey in class KeyResolverSpi

Parameters:

element -

baseURI -

storage -

Returns:

resolved SecretKey key from the registered from the elements

getDocumentElement

private static Element getDocumentElement(Set<Node> set)