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 classXAdESSignatureParameters.XPathElementPlacementEnumeration defining ways to embed a signature -
Field Summary
Fields inherited from class eu.europa.esig.dss.AbstractSignatureParameters
deterministicIdFields 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 XAdESTimestampParametersgetArchiveTimestampParameters()Get the parameters for achive timestamp (Baseline-LTA)XAdESTimestampParametersgetContentTimestampParameters()Get the parameters for content timestamp (Baseline-B)ProfileParametersgetContext()Gets the signature creation context (internal variable)StringgetKeyInfoCanonicalizationMethod()Returns the canonicalization algorithm used for dealing with KeyInfoList<DSSReference>getReferences()Returns a list of references to be incorporated to the signatureDocumentgetRootDocument()Returns the root document for INTERNALLY_DETACHED signature creationXAdESTimestampParametersgetSignatureTimestampParameters()Get the parameters for signature timestamp (Baseline-T)byte[]getSignedAdESObject()Gets a custom XAdES Object contentStringgetSignedInfoCanonicalizationMethod()Gets the SignedInfo canonicalization algorithmStringgetSignedPropertiesCanonicalizationMethod()Gets the SignedProperties canonicalization algorithmDigestAlgorithmgetSigningCertificateDigestMethod()DSSNamespacegetXades141Namespace()This method returns the current used XAdES 1.4.1 namespace Never returns nullDSSNamespacegetXadesNamespace()This method returns the current used XAdES namespace Never returns nullDSSNamespacegetXmldsigNamespace()This method returns the current used XMLDSig namespace Never returns nullXAdESSignatureParameters.XPathElementPlacementgetXPathElementPlacement()StringgetXPathLocationString()Gets the xPath signature location string (ENVELOPED only)booleanisAddX509SubjectName()Gets if the<ds:X509Data>element shall be addedbooleanisEmbedXML()Gets if the signed content shall be incorporated as XML (used for ENVELOPING)booleanisEn319132()Gets if the signature shall be created according to ETSI EN 319 132booleanisManifestSignature()Gets if the signature signs a manifestbooleanisPrettyPrint()Gets if the signature shall be pretty-printedbooleanisSignKeyInfo()Returns value value specifying if "KeyInfo" element should be signed.voidsetAddX509SubjectName(boolean addX509SubjectName)Sets if the<ds:X509Data>element shall be added Default: falsevoidsetEmbedXML(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)voidsetEn319132(boolean en319132)Sets if the signature shall be created according to ETSI EN 319 132 Default: truevoidsetKeyInfoCanonicalizationMethod(String keyInfoCanonicalizationMethod)Set the canonicalization algorithm used for dealing with KeyInfo.voidsetManifestSignature(boolean manifestSignature)Sets if the signature signs a manifestvoidsetPrettyPrint(boolean prettyPrint)Sets if the signature shall be pretty-printed Default: falsevoidsetReferences(List<DSSReference> references)Sets a list of references to be incorporated into the signaturevoidsetRootDocument(Document rootDocument)Sets the root document for INTERNALLY_DETACHED signature creationvoidsetSignatureLevel(SignatureLevel signatureLevel)Set signature level.voidsetSignedAdESObject(byte[] signedAdESObject)Sets a custom XAdES Object contentvoidsetSignedInfoCanonicalizationMethod(String signedInfoCanonicalizationMethod)Set the canonicalization algorithm to be used when dealing with SignedInfo.voidsetSignedPropertiesCanonicalizationMethod(String signedPropertiesCanonicalizationMethod)Set the canonicalization algorithm to be used when dealing with SignedProperties.voidsetSigningCertificateDigestMethod(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.voidsetSignKeyInfo(boolean signKeyInfo)Set the parameter SignKeyInfo defining if the "KeyInfo" element must be signed and its reference must be included to "SignedInfo" element.voidsetXades141Namespace(DSSNamespace xades141Namespace)Sets the XAdES 1.4.1 namespace Default: xades141:http://uri.etsi.org/01903/v1.4.1#voidsetXadesNamespace(DSSNamespace xadesNamespace)Sets the XAdES namespace Default: xades:http://uri.etsi.org/01903/v1.3.2#voidsetXmldsigNamespace(DSSNamespace xmldsigNamespace)Sets the XMLDSIG namespace Default: ds:http://www.w3.org/2000/09/xmldsig#voidsetXPathElementPlacement(XAdESSignatureParameters.XPathElementPlacement xPathElementPlacement)Defines the relation to the element referenced by the XPath where the signature will be added (XAdES Enveloped)voidsetXPathLocationString(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, setSigningCertificateMethods 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:AbstractSerializableSignatureParametersSet signature level. This field cannot be null.- Overrides:
setSignatureLevelin 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
DSSReferences
-
setReferences
Sets a list of references to be incorporated into the signature- Parameters:
references- a list ofDSSReferences
-
getXPathLocationString
Gets the xPath signature location string (ENVELOPED only)- Returns:
StringxPath
-
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:AbstractSerializableSignatureParametersGet the parameters for content timestamp (Baseline-B)- Overrides:
getContentTimestampParametersin classAbstractSerializableSignatureParameters<XAdESTimestampParameters>- Returns:
- the parameters to produce a content timestamp
-
getSignatureTimestampParameters
Description copied from class:AbstractSerializableSignatureParametersGet the parameters for signature timestamp (Baseline-T)- Overrides:
getSignatureTimestampParametersin classAbstractSerializableSignatureParameters<XAdESTimestampParameters>- Returns:
- the parameters to produce a signature timestamp
-
getArchiveTimestampParameters
Description copied from class:AbstractSerializableSignatureParametersGet the parameters for achive timestamp (Baseline-LTA)- Overrides:
getArchiveTimestampParametersin classAbstractSerializableSignatureParameters<XAdESTimestampParameters>- Returns:
- the parameters to produce an archive timestamp
-