Package eu.europa.esig.dss.xades
Class XAdESSignatureParameters
java.lang.Object
eu.europa.esig.dss.model.AbstractSerializableSignatureParameters<TP>
eu.europa.esig.dss.AbstractSignatureParameters<XAdESTimestampParameters>
eu.europa.esig.dss.xades.XAdESSignatureParameters
- All Implemented Interfaces:
SerializableSignatureParameters
,Serializable
- Direct Known Subclasses:
ASiCWithXAdESSignatureParameters
,XAdESCounterSignatureParameters
public class XAdESSignatureParameters extends AbstractSignatureParameters<XAdESTimestampParameters>
Defines SignatureParameters to deal with XAdES signature creation/extension
- See Also:
- Serialized Form
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
XAdESSignatureParameters.XPathElementPlacement
Enumeration defining ways to embed a signature -
Field Summary
Fields inherited from class eu.europa.esig.dss.AbstractSignatureParameters
deterministicId
Fields inherited from class eu.europa.esig.dss.model.AbstractSerializableSignatureParameters
archiveTimestampParameters, contentTimestampParameters, signatureTimestampParameters
-
Constructor Summary
Constructors Constructor Description XAdESSignatureParameters()
-
Method Summary
Modifier and Type Method Description XAdESTimestampParameters
getArchiveTimestampParameters()
Get the parameters for achive timestamp (Baseline-LTA)XAdESTimestampParameters
getContentTimestampParameters()
Get the parameters for content timestamp (Baseline-B)ProfileParameters
getContext()
Gets the signature creation context (internal variable)String
getKeyInfoCanonicalizationMethod()
Returns the canonicalization algorithm used for dealing with KeyInfoList<DSSReference>
getReferences()
Returns a list of references to be incorporated to the signatureDocument
getRootDocument()
Returns the root document for INTERNALLY_DETACHED signature creationXAdESTimestampParameters
getSignatureTimestampParameters()
Get the parameters for signature timestamp (Baseline-T)byte[]
getSignedAdESObject()
Gets a custom XAdES Object contentString
getSignedInfoCanonicalizationMethod()
Gets the SignedInfo canonicalization algorithmString
getSignedPropertiesCanonicalizationMethod()
Gets the SignedProperties canonicalization algorithmDigestAlgorithm
getSigningCertificateDigestMethod()
DSSNamespace
getXades141Namespace()
This method returns the current used XAdES 1.4.1 namespace Never returns nullDSSNamespace
getXadesNamespace()
This method returns the current used XAdES namespace Never returns nullDSSNamespace
getXmldsigNamespace()
This method returns the current used XMLDSig namespace Never returns nullXAdESSignatureParameters.XPathElementPlacement
getXPathElementPlacement()
String
getXPathLocationString()
Gets the xPath signature location string (ENVELOPED only)boolean
isAddX509SubjectName()
Gets if the<ds:X509Data>
element shall be addedboolean
isEmbedXML()
Gets if the signed content shall be incorporated as XML (used for ENVELOPING)boolean
isEn319132()
Gets if the signature shall be created according to ETSI EN 319 132boolean
isManifestSignature()
Gets if the signature signs a manifestboolean
isPrettyPrint()
Gets if the signature shall be pretty-printedboolean
isSignKeyInfo()
Returns value value specifying if "KeyInfo" element should be signed.void
setAddX509SubjectName(boolean addX509SubjectName)
Sets if the<ds:X509Data>
element shall be added Default: falsevoid
setEmbedXML(boolean embedXML)
Sets if the signed content shall be incorporated as XML (used for ENVELOPING) If false, incorporates the document content in its base64 encoded representation Default: false (base64 encoded binaries)void
setEn319132(boolean en319132)
Sets if the signature shall be created according to ETSI EN 319 132 Default: truevoid
setKeyInfoCanonicalizationMethod(String keyInfoCanonicalizationMethod)
Set the canonicalization algorithm used for dealing with KeyInfo.void
setManifestSignature(boolean manifestSignature)
Sets if the signature signs a manifestvoid
setPrettyPrint(boolean prettyPrint)
Sets if the signature shall be pretty-printed Default: falsevoid
setReferences(List<DSSReference> references)
Sets a list of references to be incorporated into the signaturevoid
setRootDocument(Document rootDocument)
Sets the root document for INTERNALLY_DETACHED signature creationvoid
setSignatureLevel(SignatureLevel signatureLevel)
Set signature level.void
setSignedAdESObject(byte[] signedAdESObject)
Sets a custom XAdES Object contentvoid
setSignedInfoCanonicalizationMethod(String signedInfoCanonicalizationMethod)
Set the canonicalization algorithm to be used when dealing with SignedInfo.void
setSignedPropertiesCanonicalizationMethod(String signedPropertiesCanonicalizationMethod)
Set the canonicalization algorithm to be used when dealing with SignedProperties.void
setSigningCertificateDigestMethod(DigestAlgorithm signingCertificateDigestMethod)
This property is a part of the standard:
7.2.2 The SigningCertificate element (101 903 V1.4.2 (2010-12) XAdES)
The digest method indicates the digest algorithm to be used to calculate the CertDigest element that contains the digest for each certificate referenced in the sequence.void
setSignKeyInfo(boolean signKeyInfo)
Set the parameter SignKeyInfo defining if the "KeyInfo" element must be signed and its reference must be included to "SignedInfo" element.void
setXades141Namespace(DSSNamespace xades141Namespace)
Sets the XAdES 1.4.1 namespace Default: xades141:http://uri.etsi.org/01903/v1.4.1#void
setXadesNamespace(DSSNamespace xadesNamespace)
Sets the XAdES namespace Default: xades:http://uri.etsi.org/01903/v1.3.2#void
setXmldsigNamespace(DSSNamespace xmldsigNamespace)
Sets the XMLDSIG namespace Default: ds:http://www.w3.org/2000/09/xmldsig#void
setXPathElementPlacement(XAdESSignatureParameters.XPathElementPlacement xPathElementPlacement)
Defines the relation to the element referenced by the XPath where the signature will be added (XAdES Enveloped)void
setXPathLocationString(String xPathLocationString)
Defines the position where the signature will be added (XAdES Enveloped)Methods inherited from class eu.europa.esig.dss.AbstractSignatureParameters
getCertificateChain, getContentTimestamps, getDetachedContents, getDeterministicId, getSignedData, getSigningCertificate, reinitDeterministicId, setCertificateChain, setCertificateChain, setContentTimestamps, setDetachedContents, setSignedData, setSigningCertificate
Methods inherited from class eu.europa.esig.dss.model.AbstractSerializableSignatureParameters
bLevel, equals, getDigestAlgorithm, getEncryptionAlgorithm, getMaskGenerationFunction, getReferenceDigestAlgorithm, getSignatureAlgorithm, getSignatureLevel, getSignaturePackaging, hashCode, isGenerateTBSWithoutCertificate, isSignWithExpiredCertificate, setArchiveTimestampParameters, setBLevelParams, setContentTimestampParameters, setDigestAlgorithm, setEncryptionAlgorithm, setGenerateTBSWithoutCertificate, setMaskGenerationFunction, setReferenceDigestAlgorithm, setSignaturePackaging, setSignatureTimestampParameters, setSignWithExpiredCertificate, toString
-
Constructor Details
-
XAdESSignatureParameters
public XAdESSignatureParameters()
-
-
Method Details
-
setSignatureLevel
Description copied from class:AbstractSerializableSignatureParameters
Set signature level. This field cannot be null.- Overrides:
setSignatureLevel
in classAbstractSerializableSignatureParameters<XAdESTimestampParameters>
- Parameters:
signatureLevel
- the expected signature level
-
setSigningCertificateDigestMethod
This property is a part of the standard:
7.2.2 The SigningCertificate element (101 903 V1.4.2 (2010-12) XAdES)
The digest method indicates the digest algorithm to be used to calculate the CertDigest element that contains the digest for each certificate referenced in the sequence.- Parameters:
signingCertificateDigestMethod
-DigestAlgorithm
-
getSigningCertificateDigestMethod
- Returns:
DigestAlgorithm
-
getSignedInfoCanonicalizationMethod
Gets the SignedInfo canonicalization algorithm- Returns:
- the canonicalization algorithm to be used when dealing with SignedInfo.
-
setSignedInfoCanonicalizationMethod
Set the canonicalization algorithm to be used when dealing with SignedInfo.- Parameters:
signedInfoCanonicalizationMethod
- the canonicalization algorithm to be used when dealing with SignedInfo.
-
getSignedPropertiesCanonicalizationMethod
Gets the SignedProperties canonicalization algorithm- Returns:
- the canonicalization algorithm to be used when dealing with SignedProperties.
-
setSignedPropertiesCanonicalizationMethod
public void setSignedPropertiesCanonicalizationMethod(String signedPropertiesCanonicalizationMethod)Set the canonicalization algorithm to be used when dealing with SignedProperties.- Parameters:
signedPropertiesCanonicalizationMethod
- the canonicalization algorithm to be used when dealing with SignedInfo.
-
getKeyInfoCanonicalizationMethod
Returns the canonicalization algorithm used for dealing with KeyInfo- Returns:
- - name of the canonicalization algorithm
-
setKeyInfoCanonicalizationMethod
Set the canonicalization algorithm used for dealing with KeyInfo.- Parameters:
keyInfoCanonicalizationMethod
- - name of the canonicalization algorithm for dealing with KeyInfo.
-
isSignKeyInfo
public boolean isSignKeyInfo()Returns value value specifying if "KeyInfo" element should be signed.- Returns:
- TRUE if "KeyInfo" element must be signed, FALSE otherwise.
-
setSignKeyInfo
public void setSignKeyInfo(boolean signKeyInfo)Set the parameter SignKeyInfo defining if the "KeyInfo" element must be signed and its reference must be included to "SignedInfo" element. The value is FALSE by default.- Parameters:
signKeyInfo
- - if KeyInfo element should be signed
-
getReferences
Returns a list of references to be incorporated to the signature- Returns:
- a list of
DSSReference
s
-
setReferences
Sets a list of references to be incorporated into the signature- Parameters:
references
- a list ofDSSReference
s
-
getXPathLocationString
Gets the xPath signature location string (ENVELOPED only)- Returns:
String
xPath
-
setXPathLocationString
Defines the position where the signature will be added (XAdES Enveloped)- Parameters:
xPathLocationString
- the xpath position of the signature
-
getXPathElementPlacement
-
setXPathElementPlacement
public void setXPathElementPlacement(XAdESSignatureParameters.XPathElementPlacement xPathElementPlacement)Defines the relation to the element referenced by the XPath where the signature will be added (XAdES Enveloped)- Parameters:
xPathElementPlacement
- the placement of the signature
-
getRootDocument
Returns the root document for INTERNALLY_DETACHED signature creation- Returns:
Document
-
setRootDocument
Sets the root document for INTERNALLY_DETACHED signature creation- Parameters:
rootDocument
-Document
-
getContext
Gets the signature creation context (internal variable)- Returns:
ProfileParameters
-
isEn319132
public boolean isEn319132()Gets if the signature shall be created according to ETSI EN 319 132- Returns:
- TRUE if the signature shall be created according to ETSI EN 319 132, otherwise according to the old standard
-
setEn319132
public void setEn319132(boolean en319132)Sets if the signature shall be created according to ETSI EN 319 132 Default: true- Parameters:
en319132
- if the signature shall be created according to ETSI EN 319 132
-
isEmbedXML
public boolean isEmbedXML()Gets if the signed content shall be incorporated as XML (used for ENVELOPING)- Returns:
- TRUE if the signed content shall be incorporated as XML, FALSE otherwise (base64 encoded binaries)
-
setEmbedXML
public void setEmbedXML(boolean embedXML)Sets if the signed content shall be incorporated as XML (used for ENVELOPING) If false, incorporates the document content in its base64 encoded representation Default: false (base64 encoded binaries)- Parameters:
embedXML
- if the signed content shall be incorporated as XML
-
isManifestSignature
public boolean isManifestSignature()Gets if the signature signs a manifest- Returns:
- TRUE if teh signature signs a manifest, FALSE otherwise
-
setManifestSignature
public void setManifestSignature(boolean manifestSignature)Sets if the signature signs a manifest- Parameters:
manifestSignature
- if the signature signs a manifest
-
isAddX509SubjectName
public boolean isAddX509SubjectName()Gets if the<ds:X509Data>
element shall be added- Returns:
- TRUE if the X509Data element shall be added, FALSE otherwise
-
setAddX509SubjectName
public void setAddX509SubjectName(boolean addX509SubjectName)Sets if the<ds:X509Data>
element shall be added Default: false- Parameters:
addX509SubjectName
- if the X509Data element shall be added
-
getSignedAdESObject
public byte[] getSignedAdESObject()Gets a custom XAdES Object content- Returns:
- XAdES Object binaries
-
setSignedAdESObject
public void setSignedAdESObject(byte[] signedAdESObject)Sets a custom XAdES Object content- Parameters:
signedAdESObject
- XAdES Object content to incorporate into the signature
-
isPrettyPrint
public boolean isPrettyPrint()Gets if the signature shall be pretty-printed- Returns:
- TRUE if pretty-print the signature, FALSE otherwise
-
setPrettyPrint
public void setPrettyPrint(boolean prettyPrint)Sets if the signature shall be pretty-printed Default: false- Parameters:
prettyPrint
- TRUE if to pretty-print the signature, FALSE otherwise
-
getXmldsigNamespace
This method returns the current used XMLDSig namespace Never returns null- Returns:
DSSNamespace
-
setXmldsigNamespace
Sets the XMLDSIG namespace Default: ds:http://www.w3.org/2000/09/xmldsig#- Parameters:
xmldsigNamespace
-DSSNamespace
-
getXadesNamespace
This method returns the current used XAdES namespace Never returns null- Returns:
DSSNamespace
-
setXadesNamespace
Sets the XAdES namespace Default: xades:http://uri.etsi.org/01903/v1.3.2#- Parameters:
xadesNamespace
-DSSNamespace
-
getXades141Namespace
This method returns the current used XAdES 1.4.1 namespace Never returns null- Returns:
DSSNamespace
-
setXades141Namespace
Sets the XAdES 1.4.1 namespace Default: xades141:http://uri.etsi.org/01903/v1.4.1#- Parameters:
xades141Namespace
-DSSNamespace
-
getContentTimestampParameters
Description copied from class:AbstractSerializableSignatureParameters
Get the parameters for content timestamp (Baseline-B)- Overrides:
getContentTimestampParameters
in classAbstractSerializableSignatureParameters<XAdESTimestampParameters>
- Returns:
- the parameters to produce a content timestamp
-
getSignatureTimestampParameters
Description copied from class:AbstractSerializableSignatureParameters
Get the parameters for signature timestamp (Baseline-T)- Overrides:
getSignatureTimestampParameters
in classAbstractSerializableSignatureParameters<XAdESTimestampParameters>
- Returns:
- the parameters to produce a signature timestamp
-
getArchiveTimestampParameters
Description copied from class:AbstractSerializableSignatureParameters
Get the parameters for achive timestamp (Baseline-LTA)- Overrides:
getArchiveTimestampParameters
in classAbstractSerializableSignatureParameters<XAdESTimestampParameters>
- Returns:
- the parameters to produce an archive timestamp
-