Package com.pdftools.crypto.providers.builtin

Class SignatureConfiguration

java.lang.Object

com.pdftools.internal.NativeBase

com.pdftools.internal.NativeObject

com.pdftools.sign.SignatureConfiguration

com.pdftools.crypto.providers.builtin.SignatureConfiguration

public class SignatureConfiguration
extends SignatureConfiguration

The signature configuration

Method Summary

Modifier and Type	Method	Description
boolean	getAddTimestamp()	Whether to add a trusted time-stamp to the signature (Getter)
HashAlgorithm	getHashAlgorithm()	The message digest algorithm (Getter)
SignatureFormat	getSignatureFormat()	The format (encoding) of the cryptographic signature (Getter)
SignaturePaddingType	getSignaturePaddingType()	The padding type of the cryptographic signature (Getter)
ValidationInformation	getValidationInformation()	Whether to add validation information (LTV) (Getter)
void	setAddTimestamp(boolean value)	Whether to add a trusted time-stamp to the signature (Setter)
void	setHashAlgorithm(HashAlgorithm value)	The message digest algorithm (Setter)
void	setSignatureFormat(SignatureFormat value)	The format (encoding) of the cryptographic signature (Setter)
void	setSignaturePaddingType(SignaturePaddingType value)	The padding type of the cryptographic signature (Setter)
void	setValidationInformation(ValidationInformation value)	Whether to add validation information (LTV) (Setter)

Methods inherited from class com.pdftools.sign.SignatureConfiguration

getAppearance, getContactInfo, getFieldName, getLocation, getName, getReason, setAppearance, setContactInfo, setFieldName, setLocation, setReason

Methods inherited from class com.pdftools.internal.NativeObject

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

getHashAlgorithm

public HashAlgorithm getHashAlgorithm()

The message digest algorithm (Getter)

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: pdftools.crypto.HashAlgorithm.SHA256

setHashAlgorithm

public void setHashAlgorithm(HashAlgorithm value)

The message digest algorithm (Setter)

The algorithm used to hash the document and from which the cryptographic signature is created.

Default: pdftools.crypto.HashAlgorithm.SHA256

Throws:

IllegalArgumentException - If the value is invalid or not supported.

IllegalArgumentException - if value is null

getSignaturePaddingType

public SignaturePaddingType getSignaturePaddingType()

The padding type of the cryptographic signature (Getter)

Default: pdftools.crypto.SignaturePaddingType.RSA_SSA_PSS for RSA and for pdftools.crypto.SignaturePaddingType.DEFAULT ECDSA certificates.

setSignaturePaddingType

public void setSignaturePaddingType(SignaturePaddingType value)

The padding type of the cryptographic signature (Setter)

Default: pdftools.crypto.SignaturePaddingType.RSA_SSA_PSS for RSA and for pdftools.crypto.SignaturePaddingType.DEFAULT ECDSA certificates.

Throws:

IllegalArgumentException - If the value is invalid or not supported.

IllegalArgumentException - if value is null

getSignatureFormat

public SignatureFormat getSignatureFormat()

The format (encoding) of the cryptographic signature (Getter)

Default: pdftools.crypto.SignatureFormat.ETSI_CADES_DETACHED

setSignatureFormat

public void setSignatureFormat(SignatureFormat value)

The format (encoding) of the cryptographic signature (Setter)

Default: pdftools.crypto.SignatureFormat.ETSI_CADES_DETACHED

Throws:

IllegalArgumentException - if value is null

getAddTimestamp

public boolean getAddTimestamp()

Whether to add a trusted time-stamp to the signature (Getter)

If true the Provider.getTimestampUrl() must be set.

Default: false

setAddTimestamp

public void setAddTimestamp(boolean value)

Whether to add a trusted time-stamp to the signature (Setter)

If true the Provider.getTimestampUrl() must be set.

Default: false

getValidationInformation

public ValidationInformation getValidationInformation()

Whether to add validation information (LTV) (Getter)

For signing certificates that do not offer validation (revocation) information (OCSP or CRL), this property is ignored.

If downloading validation information fails, an error NotFoundException or HttpException is generated. See pdftools.sign.WarningCategory.ADD_VALIDATION_INFORMATION_FAILED for a description of possible error causes and solutions.

Default: pdftools.crypto.ValidationInformation.EMBED_IN_DOCUMENT if the signing certificate offers validation information and pdftools.crypto.ValidationInformation.NONE otherwise

setValidationInformation

public void setValidationInformation(ValidationInformation value)

Whether to add validation information (LTV) (Setter)

For signing certificates that do not offer validation (revocation) information (OCSP or CRL), this property is ignored.

If downloading validation information fails, an error NotFoundException or HttpException is generated. See pdftools.sign.WarningCategory.ADD_VALIDATION_INFORMATION_FAILED for a description of possible error causes and solutions.

Default: pdftools.crypto.ValidationInformation.EMBED_IN_DOCUMENT if the signing certificate offers validation information and pdftools.crypto.ValidationInformation.NONE otherwise

Throws:

IllegalArgumentException - if value is null