pdftools_sdk.crypto.providers.built_in.signature_configuration

Classes

SignatureConfiguration(handle)

The signature configuration

class pdftools_sdk.crypto.providers.built_in.signature_configuration.SignatureConfiguration(handle)[source]

Bases: SignatureConfiguration

The signature configuration

property hash_algorithm: HashAlgorithm

The message digest algorithm

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

Default: pdftools_sdk.crypto.hash_algorithm.HashAlgorithm.SHA256

Returns:: HashAlgorithm

property signature_padding_type: SignaturePaddingType

The padding type of the cryptographic signature

Default: pdftools_sdk.crypto.signature_padding_type.SignaturePaddingType.RSASSAPSS for RSA and for pdftools_sdk.crypto.signature_padding_type.SignaturePaddingType.DEFAULT ECDSA certificates.

Returns:: SignaturePaddingType

property signature_format: SignatureFormat

The format (encoding) of the cryptographic signature

Default: pdftools_sdk.crypto.signature_format.SignatureFormat.ETSICADESDETACHED

Returns:: SignatureFormat

property add_timestamp: bool

Whether to add a trusted time-stamp to the signature

If True the pdftools_sdk.crypto.providers.built_in.provider.Provider.timestamp_url must be set.

Default: False

Returns:: bool

property validation_information: ValidationInformation

Whether to add validation information (LTV)

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

If downloading validation information fails, an error pdftools_sdk.not_found_error.NotFoundError or pdftools_sdk.http_error.HttpError is generated. See pdftools_sdk.sign.warning_category.WarningCategory.ADDVALIDATIONINFORMATIONFAILED for a description of possible error causes and solutions.

Default: pdftools_sdk.crypto.validation_information.ValidationInformation.EMBEDINDOCUMENT if the signing certificate offers validation information and pdftools_sdk.crypto.validation_information.ValidationInformation.NONE otherwise

Returns:: ValidationInformation