Package org.apache.xml.security.algorithms

Class SignatureAlgorithm

java.lang.Object

org.apache.xml.security.utils.ElementProxy

org.apache.xml.security.utils.SignatureElementProxy

org.apache.xml.security.algorithms.Algorithm

org.apache.xml.security.algorithms.SignatureAlgorithm

public class SignatureAlgorithm
extends Algorithm

Allows selection of digital signature's algorithm, private keys, other security parameters, and algorithm's ID.

Field Summary

Fields

Modifier and Type	Field	Description
private static java.util.Map<java.lang.String,java.lang.Class<? extends SignatureAlgorithmSpi>>	algorithmHash	All available algorithm classes are registered here
private java.lang.String	algorithmURI
private static org.slf4j.Logger	LOG
private SignatureAlgorithmSpi	signatureAlgorithm	Field signatureAlgorithm

Fields inherited from class org.apache.xml.security.utils.ElementProxy

baseURI

Constructor Summary

Constructors

Constructor	Description
SignatureAlgorithm(org.w3c.dom.Document doc, java.lang.String algorithmURI)	Constructor SignatureAlgorithm
SignatureAlgorithm(org.w3c.dom.Document doc, java.lang.String algorithmURI, int hmacOutputLength)	Constructor SignatureAlgorithm
SignatureAlgorithm(org.w3c.dom.Element element, java.lang.String baseURI)	Constructor SignatureAlgorithm
SignatureAlgorithm(org.w3c.dom.Element element, java.lang.String baseURI, boolean secureValidation)	Constructor SignatureAlgorithm

Method Summary

Modifier and Type	Method	Description
java.lang.String	getBaseLocalName()	Method getBaseLocalName
java.lang.String	getBaseNamespace()	Method getBaseNamespace
java.lang.String	getJCEAlgorithmString()	Proxy method for Signature.getAlgorithm() which is executed on the internal Signature object.
java.lang.String	getJCEProviderName()	Method getJCEProviderName
private static SignatureAlgorithmSpi	getSignatureAlgorithmSpi(java.lang.String algorithmURI)	Get a SignatureAlgorithmSpi object corresponding to the algorithmURI argument
java.lang.String	getURI()	Returns the URI representation of Transformation algorithm
void	initSign(java.security.Key signingKey)	Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.
void	initSign(java.security.Key signingKey, java.security.SecureRandom secureRandom)	Proxy method for Signature.initSign(java.security.PrivateKey, java.security.SecureRandom) which is executed on the internal Signature object.
void	initSign(java.security.Key signingKey, java.security.spec.AlgorithmParameterSpec algorithmParameterSpec)	Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.
void	initVerify(java.security.Key verificationKey)	Proxy method for Signature.initVerify(java.security.PublicKey) which is executed on the internal Signature object.
static void	register(java.lang.String algorithmURI, java.lang.Class<? extends SignatureAlgorithmSpi> implementingClass)	Registers implementing class of the SignatureAlgorithm with algorithmURI
static void	register(java.lang.String algorithmURI, java.lang.String implementingClass)	Registers implementing class of the SignatureAlgorithm with algorithmURI
static void	registerDefaultAlgorithms()	This method registers the default algorithms.
void	setParameter(java.security.spec.AlgorithmParameterSpec params)	Proxy method for Signature.setParameter( java.security.spec.AlgorithmParameterSpec) which is executed on the internal Signature object.
byte[]	sign()	Proxy method for Signature.sign() which is executed on the internal Signature object.
void	update(byte input)	Proxy method for Signature.update(byte) which is executed on the internal Signature object.
void	update(byte[] input)	Proxy method for Signature.update(byte[]) which is executed on the internal Signature object.
void	update(byte[] buf, int offset, int len)	Proxy method for Signature.update(byte[], int, int) which is executed on the internal Signature object.
boolean	verify(byte[] signature)	Proxy method for Signature.verify(byte[]) which is executed on the internal Signature object.

Methods inherited from class org.apache.xml.security.algorithms.Algorithm

getAlgorithmURI, setAlgorithmURI

Methods inherited from class org.apache.xml.security.utils.ElementProxy

addBase64Element, addBase64Text, addBigIntegerElement, addReturnToSelf, addText, addTextElement, appendOther, appendSelf, appendSelf, createElementForFamily, createElementForFamilyLocal, createText, getBaseURI, getBigIntegerFromChildElement, getBytesFromTextChild, getDefaultPrefix, getDocument, getElement, getElementPlusReturns, getFirstChild, getLocalAttribute, getTextFromChildElement, getTextFromTextChild, length, registerDefaultPrefixes, setDefaultPrefix, setDocument, setElement, setElement, setLocalAttribute, setLocalIdAttribute, setXPathNamespaceContext

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.slf4j.Logger LOG

algorithmHash

private static java.util.Map<java.lang.String,java.lang.Class<? extends SignatureAlgorithmSpi>> algorithmHash

All available algorithm classes are registered here

signatureAlgorithm

private final SignatureAlgorithmSpi signatureAlgorithm

Field signatureAlgorithm

algorithmURI

private final java.lang.String algorithmURI

Constructor Detail

SignatureAlgorithm

public SignatureAlgorithm(org.w3c.dom.Document doc,
                          java.lang.String algorithmURI)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

doc -

algorithmURI -

Throws:

XMLSecurityException

SignatureAlgorithm

public SignatureAlgorithm(org.w3c.dom.Document doc,
                          java.lang.String algorithmURI,
                          int hmacOutputLength)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

doc -

algorithmURI -

hmacOutputLength -

Throws:

XMLSecurityException

SignatureAlgorithm

public SignatureAlgorithm(org.w3c.dom.Element element,
                          java.lang.String baseURI)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

element -

baseURI -

Throws:

XMLSecurityException

SignatureAlgorithm

public SignatureAlgorithm(org.w3c.dom.Element element,
                          java.lang.String baseURI,
                          boolean secureValidation)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

element -

baseURI -

secureValidation -

Throws:

XMLSecurityException

Method Detail

getSignatureAlgorithmSpi

private static SignatureAlgorithmSpi getSignatureAlgorithmSpi(java.lang.String algorithmURI)
                                                       throws XMLSignatureException

Get a SignatureAlgorithmSpi object corresponding to the algorithmURI argument

Throws:

XMLSignatureException

sign

public byte[] sign()
            throws XMLSignatureException

Proxy method for Signature.sign() which is executed on the internal Signature object.

Returns:

the result of the Signature.sign() method

Throws:

XMLSignatureException

getJCEAlgorithmString

public java.lang.String getJCEAlgorithmString()

Proxy method for Signature.getAlgorithm() which is executed on the internal Signature object.

Returns:

the result of the Signature.getAlgorithm() method

getJCEProviderName

public java.lang.String getJCEProviderName()

Method getJCEProviderName

Returns:

The Provider of this Signature Algorithm

update

public void update(byte[] input)
            throws XMLSignatureException

Proxy method for Signature.update(byte[]) which is executed on the internal Signature object.

Parameters:

input -

Throws:

XMLSignatureException

update

public void update(byte input)
            throws XMLSignatureException

Proxy method for Signature.update(byte) which is executed on the internal Signature object.

Parameters:

input -

Throws:

XMLSignatureException

update

public void update(byte[] buf,
                   int offset,
                   int len)
            throws XMLSignatureException

Proxy method for Signature.update(byte[], int, int) which is executed on the internal Signature object.

Parameters:

buf -

offset -

len -

Throws:

XMLSignatureException

initSign

public void initSign(java.security.Key signingKey)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.

Parameters:

signingKey -

Throws:

XMLSignatureException

initSign

public void initSign(java.security.Key signingKey,
                     java.security.SecureRandom secureRandom)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey, java.security.SecureRandom) which is executed on the internal Signature object.

Parameters:

signingKey -

secureRandom -

Throws:

XMLSignatureException

initSign

public void initSign(java.security.Key signingKey,
                     java.security.spec.AlgorithmParameterSpec algorithmParameterSpec)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.

Parameters:

signingKey -

algorithmParameterSpec -

Throws:

XMLSignatureException

setParameter

public void setParameter(java.security.spec.AlgorithmParameterSpec params)
                  throws XMLSignatureException

Proxy method for Signature.setParameter( java.security.spec.AlgorithmParameterSpec) which is executed on the internal Signature object.

Parameters:

params -

Throws:

XMLSignatureException

initVerify

public void initVerify(java.security.Key verificationKey)
                throws XMLSignatureException

Proxy method for Signature.initVerify(java.security.PublicKey) which is executed on the internal Signature object.

Parameters:

verificationKey -

Throws:

XMLSignatureException

verify

public boolean verify(byte[] signature)
               throws XMLSignatureException

Proxy method for Signature.verify(byte[]) which is executed on the internal Signature object.

Parameters:

signature -

Returns:

true if the signature is valid.

Throws:

XMLSignatureException

getURI

public final java.lang.String getURI()

Returns the URI representation of Transformation algorithm

Returns:

the URI representation of Transformation algorithm

register

public static void register(java.lang.String algorithmURI,
                            java.lang.String implementingClass)
                     throws AlgorithmAlreadyRegisteredException,
                            java.lang.ClassNotFoundException,
                            XMLSignatureException

Registers implementing class of the SignatureAlgorithm with algorithmURI

Parameters:

algorithmURI - algorithmURI URI representation of SignatureAlgorithm.

implementingClass - implementingClass the implementing class of SignatureAlgorithmSpi

Throws:

AlgorithmAlreadyRegisteredException - if specified algorithmURI is already registered

XMLSignatureException

java.lang.SecurityException - if a security manager is installed and the caller does not have permission to register the signature algorithm

java.lang.ClassNotFoundException

register

public static void register(java.lang.String algorithmURI,
                            java.lang.Class<? extends SignatureAlgorithmSpi> implementingClass)
                     throws AlgorithmAlreadyRegisteredException,
                            java.lang.ClassNotFoundException,
                            XMLSignatureException

Registers implementing class of the SignatureAlgorithm with algorithmURI

Parameters:

algorithmURI - algorithmURI URI representation of SignatureAlgorithm.

implementingClass - implementingClass the implementing class of SignatureAlgorithmSpi

Throws:

AlgorithmAlreadyRegisteredException - if specified algorithmURI is already registered

XMLSignatureException

java.lang.SecurityException - if a security manager is installed and the caller does not have permission to register the signature algorithm

java.lang.ClassNotFoundException

registerDefaultAlgorithms

public static void registerDefaultAlgorithms()

This method registers the default algorithms.

getBaseNamespace

public java.lang.String getBaseNamespace()

Method getBaseNamespace

Overrides:

getBaseNamespace in class SignatureElementProxy

Returns:

URI of this element

getBaseLocalName

public java.lang.String getBaseLocalName()

Method getBaseLocalName

Specified by:

getBaseLocalName in class ElementProxy

Returns:

Local name