de.softpro.doc.SignDocSignatureParameters Class Reference

Parameters for signing a document. More...

List of all members.

Public Member Functions
synchronized int	getState (String aName) throws SignDocException
	Get the status of a parameter.
synchronized int	setString (String aName, String aValue) throws SignDocException
	Set a string parameter.
synchronized int	setInteger (String aName, int aValue) throws SignDocException
	Set an integer parameter.
synchronized int	setBlob (String aName, byte[] aData) throws SignDocException
	Set a blob parameter.
synchronized int	setLength (String aName, int aType, double aValue) throws SignDocException
	Set a length parameter.
synchronized int	setColor (String aName, SignDocColor aValue) throws SignDocException
	Set a color parameter.
synchronized int	addTextItem (int aItem, int aGroup) throws SignDocException
	Add another string to be displayed, top down.
synchronized int	addTextItem2 (int aItem, int aGroup, int aHAlignment, int aDirection) throws SignDocException
	Add another string to be displayed, top down, with paragraph direction.
synchronized int	clearTextItems () throws SignDocException
	Remove all strings that were to be displayed.
synchronized int	setTextItemDirection (int aItem, int aHAlignment, int aDirection) throws SignDocException
	Set the paragraph direction of text items.
synchronized int	setPKCS7 (SignPKCS7 aPKCS7) throws SignDocException
	Set an object which will create a PKCS #7 or CAdES signature.
synchronized int	setRSA (SignRSA aRSA) throws SignDocException
	Set an object which will compute an RSA signature.
synchronized int	setECDSA (SignECDSA aECDSA) throws SignDocException
	Set an object which will compute an ECDSA signature.
synchronized int	getAvailableMethods () throws SignDocException
	Get a bitset indicating which signing methods are available for this signature field.
synchronized byte[]	getTemplate () throws SignDocException
	Get an XML document specifying the current layout.
synchronized String	getErrorMessage () throws SignDocException
	Get an error message for the last function call.
synchronized void	destroy () throws SignDocException
	Destroy this object, overwriting sensitive data.
Static Public Attributes
static final int	m_default = 0
	Signing method (for integer parameter "Method"): default method.
static final int	m_digsig_pkcs1 = 1
	Signing method (for integer parameter "Method"): PKCS #1 (RSA keys only).
static final int	m_digsig_pkcs7_detached = 2
	Signing method (for integer parameter "Method"): detached PKCS #7.
static final int	m_digsig_pkcs7_sha1 = 3
	Signing method (for integer parameter "Method"): PKCS #7 with SHA-1 (deprecated).
static final int	m_hash = 4
	Signing method (for integer parameter "Method"): The signature is just a hash (TIFF only).
static final int	m_digsig_cades_detached = 5
	Signing method (for integer parameter "Method"): Detached ETSI CAdES (PAdES-BES).
static final int	m_digsig_cades_rfc3161 = 6
	Signing method (for integer parameter "Method"): ETSI CAdES RFC 3161 time stamp.
static final int	dha_default = 0
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): default hash algorithm.
static final int	dha_sha1 = 1
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-1.
static final int	dha_sha256 = 2
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-256.
static final int	dha_sha384 = 3
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-384.
static final int	dha_sha512 = 4
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-512.
static final int	dha_ripemd160 = 5
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): RIPEMD-160.
static final int	dha_sha224 = 6
	Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-224.
static final int	tsha_default = 0
	Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): default value.
static final int	tsha_sha1 = 1
	Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-1.
static final int	tsha_sha256 = 2
	Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-256.
static final int	tsha_sha384 = 3
	Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-384.
static final int	tsha_sha512 = 4
	Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-512.
static final int	o_optimize = 0
	Optimize document before signing (for integer parameter "Optimize").
static final int	o_dont_optimize = 1
	Don't optimize document before signing (for integer parameter "Optimize").
static final int	pb_freeze = 0
	Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Freeze (fix) appearances.
static final int	pb_dont_freeze = 1
	Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Don't freeze (fix) appearances.
static final int	pb_auto = 2
	Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Freeze (fix) appearances if appropriate.
static final int	csa_sha1_rsa = 0
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-1 with RSA.
static final int	csa_md5_rsa = 1
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): MD5 with RSA.
static final int	csa_sha256_rsa = 2
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-256 with RSA.
static final int	csa_sha384_rsa = 3
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-384 with RSA.
static final int	csa_sha512_rsa = 4
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-512 with RSA.
static final int	csa_ripemd160_rsa = 5
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-512 with RSA.
static final int	csa_ecdsa_sha1 = 6
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-1.
static final int	csa_ecdsa_sha224 = 7
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-224.
static final int	csa_ecdsa_sha256 = 8
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-256.
static final int	csa_ecdsa_sha384 = 9
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-384.
static final int	csa_ecdsa_sha512 = 10
	Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-512.
static final int	rss_pkcs1 = 0
	Signing scheme for RSA signatures: PKCS #1 (RSA v1.5).
static final int	rss_pss = 1
	Signing scheme for RSA signatures: Probabilistic Signature Scheme (PSS) (RSA v2.0 and v2.1).
static final int	be_rsa = 0
	Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Random session key encrypted with public RSA key.
static final int	be_fixed = 1
	Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Fixed key (no security).
static final int	be_binary = 2
	Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Binary 256-bit key.
static final int	be_passphrase = 3
	Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Passphrase that will be hashed to a 256-bit key.
static final int	be_dont_store = 4
	Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): The biometric data won't be stored in the document.
static final int	bhl_attr = 0
	Select where to store the message digest computed over the document hash and the unencrypted biometric data: If possible, store the biometric hash as unauthenticated attribute in the PKCS #7 (or CMS) message.
static final int	bhl_contents = 1
	Select where to store the message digest computed over the document hash and the unencrypted biometric data: Store the message digest in the Contents entry of the signature dictionary.
static final int	ha_left = 0
	Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Align left.
static final int	ha_center = 1
	Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Center.
static final int	ha_right = 2
	Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Align right.
static final int	ha_justify = 3
	Horizontal alignment (for integer parameter "TextHAlignment" and for addTextItem2()): Justify (align both and right, expanding white space).
static final int	ha_auto = 4
	Horizontal alignment (for integer parameter "TextHAlignment" and for addTextItem2()): Align left if the text begins with an LTR run, align right if the text begins with an RTL run.
static final int	ha_default = -1
	Horizontal alignment (for addTextItem2()): Use integer parameter "TextHAlignment".
static final int	va_top = 0
	Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Align top.
static final int	va_center = 1
	Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Center.
static final int	va_bottom = 2
	Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Align bottom.
static final int	tp_overlay = 0
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text and image are independent and overlap (text is painted on image).
static final int	tp_below = 1
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put below the image.
static final int	tp_underlay = 2
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text and image are independent and overlap (image is painted on text).
static final int	tp_right_of = 3
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put on the right of the image.
static final int	tp_above = 4
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put above the image.
static final int	tp_left_of = 5
	Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put on the left of the image.
static final int	vt_abs = 0
	Indicate how measurements are specified: aValue is the value to be used (units of document coordinates).
static final int	vt_field_height = 1
	Indicate how measurements are specified: Multiply aValue by the field height.
static final int	vt_field_width = 2
	Indicate how measurements are specified: Multiply aValue by the field width.
static final int	ti_signer = 0
	Select a string for the appearance stream of PDF documents: String parameter "Signer".
static final int	ti_sign_time = 1
	Select a string for the appearance stream of PDF documents: String parameter "SignTime".
static final int	ti_comment = 2
	Select a string for the appearance stream of PDF documents: String parameter "Comment".
static final int	ti_adviser = 3
	Select a string for the appearance stream of PDF documents: String parameter "Adviser".
static final int	ti_contact_info = 4
	Select a string for the appearance stream of PDF documents: String parameter "ContactInfo".
static final int	ti_location = 5
	Select a string for the appearance stream of PDF documents: String parameter "Location".
static final int	ti_reason = 6
	Select a string for the appearance stream of PDF documents: String parameter "Reason".
static final int	ti_text1 = 7
	Select a string for the appearance stream of PDF documents: String parameter "Text1".
static final int	ti_text2 = 8
	Select a string for the appearance stream of PDF documents: String parameter "Text2".
static final int	ti_text3 = 9
	Select a string for the appearance stream of PDF documents: String parameter "Text3".
static final int	ti_text4 = 10
	Select a string for the appearance stream of PDF documents: String parameter "Text4".
static final int	ti_text5 = 11
	Select a string for the appearance stream of PDF documents: String parameter "Text5".
static final int	ti_text6 = 12
	Select a string for the appearance stream of PDF documents: String parameter "Text6".
static final int	ti_text7 = 13
	Select a string for the appearance stream of PDF documents: String parameter "Text7".
static final int	ti_text8 = 14
	Select a string for the appearance stream of PDF documents: String parameter "Text8".
static final int	ti_text9 = 15
	Select a string for the appearance stream of PDF documents: String parameter "Text9".
static final int	tg_master = 0
	Text group: master.
static final int	tg_slave = 1
	Text group: slave.
static final int	tid_ltr = 0x1000
	Paragraph direction: LTR.
static final int	tid_rtl = 0x2000
	Paragraph direction: RTL.
static final int	tid_default_ltr = 0x4000
	Paragraph direction: Choose direction automatically, default to LTR.
static final int	tid_default_rtl = 0x8000
	Paragraph direction: Choose direction automatically, default to RTL.
static final int	isv_SubFilter = 0x01
	Flag for ignoring mandatory requirements specified by the signature seed value dictionary: Ignore SubFilter (signing method).
static final int	isv_DigestMethod = 0x02
	Flag for ignoring mandatory requirements specified by the signature seed value dictionary: Ignore DigestMethod (hash algorithm).
static final int	csf_software = 0x01
	Flags for selecting certificates (for integer parameter "SelectCertificate": include certificates with software-based private keys.
static final int	csf_hardware = 0x02
	Flags for selecting certificates (for integer parameter "SelectCertificate": include certificates with hardware-based private keys.
static final int	csf_use_certificate_seed_values = 0x10
	Flags for selecting certificates (for integer parameter "SelectCertificate": include only certificates allowed by the PDF document's certificate seed value dictionary.
static final int	csf_ask_if_ambiguous = 0x20
	Flags for selecting certificates (for integer parameter "SelectCertificate": ask the user to select a certificate if there is more than one matching certificate.
static final int	csf_never_ask = 0x40
	Flags for selecting certificates (for integer parameter "SelectCertificate": never ask the user to select a certificate; exactly one certificate must match.
static final int	csf_create_self_signed = 0x80
	Flags for selecting certificates (for integer parameter "SelectCertificate": offer to create a self-signed certificate (cannot be used with csf_never_ask and csf_ask_if_ambiguous).
static final int	rsf_bw = 0x01
	Flags for rendering the signature (for integer parameter "RenderSignature": black and white.
static final int	rsf_gray = 0x02
	Flags for rendering the signature (for integer parameter "RenderSignature": use gray levels computed from pressure.
static final int	rsf_antialias = 0x04
	Flags for rendering the signature (for integer parameter "RenderSignature": use gray levels for antialiasing.
static final int	rsf_limit_size = 0x08
	Flags for rendering the signature (for integer parameter "RenderSignature": Limit the size of the rendered signature to the size of the captured signature.
static final int	it_opaque = 0
	Transparency of signature image: Make signature image opaque.
static final int	it_brightest = 1
	Transparency of signature image: Make the brightest color transparent.
static final int	ac_all = 0
	Integer parameter AddCertificates: Include all intermediate certificates and the root certificate.
static final int	ac_none = 1
	Integer parameter AddCertificates: Do not include any certificates.
static final int	ac_trusted = 2
	Integer parameter AddCertificates: Include all intermediate certificates and the root certificate, require the root certificate to be trusted.
static final int	ari_add = 0x01
	Flag for integer parameter AddRevocationInfo: Add revocation data.
static final int	rx_always = 0
	Integer parameter "RemoveXFA": Always remove XFA.
static final int	rx_if_allowed = 1
	Integer parameter "RemoveXFA": Remove XFA if possible.
static final int	rx_never = 2
	Integer parameter "RemoveXFA": Do not remove XFA.
static final int	rc_ok = 0
	Return code for setter functions: Parameter set successfully.
static final int	rc_unknown = 1
	Return code for setter functions: Unknown parameter.
static final int	rc_not_supported = 2
	Return code for setter functions: Setting the parameter is not supported.
static final int	rc_invalid_value = 3
	Return code for setter functions: The value for the parameter is invalid.
static final int	ps_set = 0
	Status of a parameter: Parameter has been set.
static final int	ps_missing = 1
	Status of a parameter: Parameter must be set but is not set.
static final int	ps_supported = 2
	Status of a parameter: Parameter is supported and optional, but has not been set or is set to the default value.
static final int	ps_ignored = 3
	Status of a parameter: Parameter can be (or is) set but will be ignored.
static final int	ps_not_supported = 4
	Status of a parameter: Parameter is not supported for this field.
static final int	ps_unknown = 5
	Status of a parameter: Unknown parameter.
Protected Member Functions
void	finalize () throws Throwable
	Finalize this object.

---

Detailed Description

Parameters for signing a document.

Use SignDocDocument.createSignatureParameters() or SignDocDocument.createSignatureParametersForTimeStamp() to create objects of this type.

The available parameters depend both on the document type and on the signature field for which the SignDocSignatureParameters object has been created. All setters have a special value for one of their arguments which can be used for checking if the parameter can be set.

SignDocDocument.addSignature() may fail due to invalid parameters even if all setters reported success as the setters do not check if there are conflicts between parameters.

Which certificates are acceptable may be restricted by the application (by using csf_software and csf_hardware of integer parameter "SelectCertificate", blob parameters "FilterCertificatesByIssuerCertificate" and "FilterCertificatesBySubjectCertificate", and string parameters "FilterCertificatesByPolicy" and "FilterCertificatesBySubjectDN") and by the PDF document (certificate seed value dictionary). If no matching certificate is available (for instance, because integer parameter "SelectCertificate" is zero), SignDocDocument.addSignature() will throw SignDocNoCertificateException. If more than one matching certificate is available but csf_never_ask is specified in integer parameter "SelectCertificate"), SignDocDocument.addSignature() will throw SignDocAmbiguousCertificateException.

To make the signature maximally meaningful, integer parameter "AddCertificates" should be ac_all (which is the default value) and integer parameter "AddRevocationInfo" should include ari_add.

Unless you need a specific signing method, you should leave integer parameter "Method" at its default value m_default. If you select a specific signing method and that method is not allowed by the signature field's seed values, signing will fail.

Unless you need a specific digest algorithm, you should leave integer parameter "DetachedHashAlgorithm" at its default value dha_default. If you select a specific digest algorithm and that algorithm is not allowed by the signature field's seed values, signing will fail.

The interaction between some parameters is quite complex; the following section tries to summarize the signing methods for PDF documents.

(1a)

Default method, private key and self-signed certificate created on the fly:

• Method: m_default
• CommonName: signer's name
• GenerateKeyPair: 1024-4096 (or GenerateECCKeyPair)

(1b)

Default method, the certificate and its key are provided as PKCS #12 blob:

• Method: m_default
• Certificate: PKCS #12 blob containing certificate (need not be self-signed) and its private key
• PKCS#12Password: password for private key in the PKCS #12 blob

(1c)

Default method, private key provided, certificate provided:

• Method: m_default
• Certificate: certificate
• CertificatePrivateKey: private key for the certificate

(1d)

Default method, user must select certificate:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware

(1e)

Default method, user may select certificate or choose to create a self-signed certificate, the private key of which will be generated:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware
• CommonName: signer's name (for self-signed certificate)
• GenerateKeyPair: 1024-4096 (or GenerateECCKeyPair)

(1f)

Default method, the certificate is selected programmatically or by the PDF document without user interaction:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware, csf_never_ask
• FilterCertificatesByPolicy: accept certificates having all of these certificate policies
• FilterCertificatesByIssuerCertificate: the acceptable issuer certificates (optional)
• FilterCertificatesBySubjectCertificate: the acceptable certificates (optional)
• FilterCertificatesBySubjectDN: accept certificates issued for these subjects (optional)

(1g)

Default method via SignRSA or SignECDSA interface:

• Method: m_default

See setRSA() and setECDSA() for details.

(1h)

Default method, private key provided, self-signed certificate created on the fly:

• Method: m_default
• CommonName: signer's name
• CertificatePrivateKey: private key for the self-signed certificate

(1i)

Default method, user may select certificate or choose to create a self-signed certificate, the private key of which is provided:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware
• CommonName: signer's name (for self-signed certificate)
• CertificatePrivateKey: private key for the self-signed certificate

(1j)

Default method, user may select certificate or choose to "create" a self-signed certificate, the certificate to be used in that case and its key are provided separately:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware, csf_create_self_signed
• Certificate: certificate
• CertificatePrivateKey: private key for the certificate

(1k)

Default method, user may select certificate or choose to "create" a self-signed certificate, the certificate to be used in that case and its key are provided as PKCS #12 blob:

• Method: m_default
• SelectCertificate: csf_software and/or csf_hardware, csf_create_self_signed
• Certificate: PKCS #12 blob containing certificate (need not be self-signed) and its private key
• PKCS#12Password: password for private key in the PKCS #12 blob

(2a)

PKCS #7 or CAdES, private key and self-signed certificate created on the fly:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• CommonName: signer's name
• GenerateKeyPair: 1024-4096 (or GenerateECCKeyPair)

(2b)

PKCS #7 or CAdES, the certificate and its key are provided as PKCS #12 blob:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• Certificate: PKCS #12 blob containing certificate (need not be self-signed) and its private key
• PKCS#12Password: password for private key in the PKCS #12 blob

(2c)

PKCS #7 or CAdES, private key provided, certificate provided:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• Certificate: certificate
• CertificatePrivateKey: private key for the certificate

(2d)

PKCS #7 or CAdES, user must select certificate:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware

(2e)

PKCS #7 or CAdES, user may select certificate or choose to create a self-signed certificate, the private key of which will be generated:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware
• CommonName: signer's name (for self-signed certificate)
• GenerateKeyPair: 1024-4096 (or GenerateECCKeyPair)

(2f)

PKCS #7 or CAdES, the certificate is selected programmatically or by the PDF document without user interaction:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware, csf_never_ask
• FilterCertificatesByPolicy: accept certificates having all of these certificate policies
• FilterCertificatesByIssuerCertificate: the acceptable issuer certificates (optional)
• FilterCertificatesBySubjectCertificate: the acceptable certificates (optional)
• FilterCertificatesBySubjectDN: accept certificates issued for these subjects (optional)

(2g)

PKCS #7 or CAdES via SignRSA or SignECDSA interface:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached

See setRSA() and setECDSA() for details.

(2h)

PKCS #7 or CAdES, private key provided, self-signed certificate created on the fly:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• CommonName: signer's name
• CertificatePrivateKey: private key for the self-signed certificate

(2i)

PKCS #7 or CAdES, user may select certificate or choose to create a self-signed certificate, the private key of which is provided:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware
• CommonName: signer's name (for self-signed certificate)
• CertificatePrivateKey: private key for the self-signed certificate

(2j)

PKCS #7 or CAdES, user may select certificate or choose to "create" a self-signed certificate, the certificate to be used in that case and its key are provided separately:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware, csf_create_self_signed
• Certificate: certificate
• CertificatePrivateKey: private key for the certificate

(2k)

PKCS #7 or CAdES, user may select certificate or choose to "create" a self-signed certificate, the certificate to be used in that case and its key are provided as PKCS #12 blob:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• DetachedHashAlgorithm: hash algorithm for m_digsig_pkcs7_detached and m_digsig_cades_detached
• SelectCertificate: csf_software and/or csf_hardware, csf_create_self_signed
• Certificate: PKCS #12 blob containing certificate (need not be self-signed) and its private key
• PKCS#12Password: password for private key in the PKCS #12 blob

(2l)

PKCS #7 or CAdES via SignPKCS7 interface:

• Method: m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached

See setPKCS7() for details.

(3a)

PKCS #1, private key and self-signed certificate created on the fly:

• Method: m_digsig_pkcs1
• CommonName: signer's name
• GenerateKeyPair: 1024-4096 (or GenerateECCKeyPair)

(3b)

PKCS #1 via SignRSA or SignECDSA interface:

• Method: m_digsig_pkcs1

See setRSA() and setECDSA() for details.

(3c)

PKCS #1, private key provided, self-signed certificate created on the fly:

• Method: m_digsig_pkcs1
• CommonName: signer's name
• CertificatePrivateKey: private key for the self-signed certificate

(3d)

PKCS #1, private key provided, self-signed certificate provided:

• Method: m_digsig_pkcs1
• Certificate: self-signed certificate
• CertificatePrivateKey: private key for the certificate

(4a)

document time stamp using a SignDocSignatureParameters object created by SignDocDocument.createSignatureParametersForTimeStamp():

• TimeStampServerURL: URL of time stamp server

Additionally:

• You may want to set string parameter "Filter" to "Adobe.PPKLite".
• You may want to set integer parameter "IgnoreSeedValues" if you set integer parameter "Method" and/or "DetachedHashAlgorithm".
• Set integer parameter "Optimize" to o_optimize unless SignDocDocument.getRequiredSaveToFileFlags() indicates that SignDocDocument.sf_incremental must be used. Note that o_optimize requires string parameter "OutputPath".

For TIFF documents, an additional, simplified signing method is available:

(4)

just a hash:

• Method: m_hash
• CommonName: signer's name

The following parameters control the signing method and related aspects of the signature:

• DetachedHashAlgorithm (integer)
• IgnoreSeedValues (integer)
• Method (integer)
• RSASignatureScheme (integer)

The following parameters control the private key used for signing:

• Certificate (blob)
• CertificatePrivateKey (blob)
• GenerateECCKeyPair (string)
• GenerateKeyPair (integer)
• PKCS#12Password (string)

The following parameters control rendering of the signature image from biometric data:

• BiometricData (blob)
• PenWidth (integer)
• RenderSignature (integer)
• RenderWidth (integer)
• SignatureColor (color)

The following parameters put additional data into the signature:

• ContactInfo (string)
• Filter (string)
• Location (string)
• Reason (string)
• Signer (string)
• Timestamp (string)

The following parameters provide texts for the appearance of a signature in PDF documents:

• Adviser (string)
• Comment (string)
• ContactInfo (string)
• Location (string)
• Reason (string)
• Signer (string)
• SignTime (string)
• Template (blob)
• Text1 through Text9 (string)

The following parameters control how a signed signature field in a PDF document will look like (parameters marked with * can be overridden with blob parameter "Template"):

• FontName (string) *
• FontSize (length) *
• Image (blob)
• ImageDPI (integer)
• ImageHAlignment (integer) *
• ImageMargin (length) *
• ImageTransparency (integer) *
• ImageVAlignment (integer) *
• SignatureColor (color)
• Template (blob)
• TextColor (color) *
• TextHAlignment (integer) *
• TextHMargin (length) *
• TextPosition (integer) *
• TextVAlignment (integer) *

The following parameters control the signing certificate:

• Certificate (blob)
• PKCS#12Password (string)

The following parameters are used for generating a self-signed certificate on the fly (you also need to set at least one parameter for the private key):

• CertificateSigningAlgorithm (integer)
• CommonName (string)
• Country (string)
• Locality (string)
• Organization (string)
• OrganizationUnit (string)

The following parameters are used for putting biometric data (handwritten signature) into the signature:

• BiometricData (blob)
• BiometricEncryption (integer)
• BiometricHashLocation (integer)
• BiometricKey (blob)
• BiometricKeyPath (string)
• BiometricPassphrase (string)

The following parameters control the certificate selection dialog:

• FilterCertificatesByIssuerCertificate (blob)
• FilterCertificatesByPolicy (string)
• FilterCertificatesBySubjectCertificate (blob)
• FilterCertificatesBySubjectDN (string)
• SelectCertificate (integer)
• SelectCertificateMessage (string)
• SelectCertificateTitle (string)

The following parameters control RFC 3161 timestamps:

• TimeStampClientCertificatePath (string)
• TimeStampClientKeyPath (string)
• TimeStampHashAlgorithm (integer)
• TimeStampRetries (integer)
• TimeStampServerPassword (string)
• TimeStampServerTimeout (integer)
• TimeStampServerURL (string)
• TimeStampServerUser (string)
• TimeStampSize (integer)
• TimeStampUserAgent (string)

The following parameters put additional certificates and revocation information into the signature:

• AddCertificates (integer)
• AddRevocationInfo (integer)
• IntermediateCertificate (blob)

The following parameters do not fall into the above categories:

• OutputPath (string)
• Optimize (integer)
• PDFAButtons (integer)
• RemoveXFA (integer)

---

Member Function Documentation

synchronized int de.softpro.doc.SignDocSignatureParameters.addTextItem	(	int	aItem,
		int	aGroup
	)		throws SignDocException

Add another string to be displayed, top down.

For DigSig signature fields, this function adds another string to the appearance stream of PDF documents. The first call clears any default strings. The default values depend on the profile passed to SignDocDocument.createSignatureParameters():

Profile	Value
""	ti_signer/tg_master, ti_sign_time/tg_master
"image"	(empty)

The paragraph direction is 0 which is treated like tid_ltr.

See also blob parameter "Template".

Parameters:

[in]	aItem	Select the string to be added (ti_signer etc.)
[in]	aGroup	The string's group for font size computation (tg_master or tg_slave).

Returns:

rc_ok iff successful.

See also:

addTextItem2(), clearTextItems(), setTextItemDirection(), tg_master, tg_slave, ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_signer, ti_sign_time, ti_text1

synchronized int de.softpro.doc.SignDocSignatureParameters.addTextItem2	(	int	aItem,
		int	aGroup,
		int	aHAlignment,
		int	aDirection
	)		throws SignDocException

Add another string to be displayed, top down, with paragraph direction.

For DigSig signature fields, this function adds another string to the appearance stream of PDF documents. The first call clears any default strings. The default values depend on the profile passed to SignDocDocument.createSignatureParameters():

Profile	Value
""	ti_signer/tg_master, ti_sign_time/tg_master
"image"	(empty)

See also blob parameter "Template".

Parameters:

[in]	aItem	Select the string to be added (ti_signer etc.)
[in]	aGroup	The string's group for font size computation (tg_master or tg_slave).
[in]	aHAlignment	Horizontal alignment. This value overrides integer parameter "TextHAlignment" unless it is ha_default.
[in]	aDirection	The paragraph direction: 0, tid_ltr, tid_rtl, tid_default_ltr, or tid_default_rtl. 0 is treated like tid_ltr.

Returns:

rc_ok iff successful.

See also:

addTextItem(), clearTextItems(), tg_master, tg_slave, ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_signer, ti_sign_time, ti_text1

synchronized int de.softpro.doc.SignDocSignatureParameters.clearTextItems

(

)

throws SignDocException

Remove all strings that were to be displayed.

addTextItem() cannot remove the default strings without adding a new string. This function does.

See also blob parameter "Template".

Returns:

rc_ok iff successful.

See also:

addTextItem()

synchronized void de.softpro.doc.SignDocSignatureParameters.destroy

(

)

throws SignDocException

Destroy this object, overwriting sensitive data.

After calling this method, all methods of this object will throw.

void de.softpro.doc.SignDocSignatureParameters.finalize

(

)

throws Throwable [protected]

Finalize this object.

Do not call this method unless you know what you are doing.

synchronized int de.softpro.doc.SignDocSignatureParameters.getAvailableMethods

(

)

throws SignDocException

Get a bitset indicating which signing methods are available for this signature field.

Returns:

1<<m_digsig_pkcs1 etc.

See also:

SignDocDocument.getAvailableMethods()

synchronized String de.softpro.doc.SignDocSignatureParameters.getErrorMessage

(

)

throws SignDocException

Get an error message for the last function call.

Returns:

A string describing the reason for the failure of the last function call. The string is empty if the last call succeeded.

synchronized int de.softpro.doc.SignDocSignatureParameters.getState

(

String

aName )

throws SignDocException

Get the status of a parameter.

Parameters:

[in]

aName

The name of the parameter (case-sensitive).

Returns:

The status of the parameter: ps_set, ps_supported, ps_not_supported, or ps_unknown.

See also:

ps_set, ps_supported, ps_not_supported, ps_unknown

synchronized byte [] de.softpro.doc.SignDocSignatureParameters.getTemplate

(

)

throws SignDocException

Get an XML document specifying the current layout.

This function can be used for debugging and for reporting bugs. This function will fail if the "Template" blob parameter is invalid.

Returns:

The XML document or null on error.

See also:

setBlob()

synchronized int de.softpro.doc.SignDocSignatureParameters.setBlob	(	String	aName,
		byte[]	aData
	)		throws SignDocException

Set a blob parameter.

Available blob parameters are:

• BiometricData The biometric data is stored in the document (see integer parameter "BiometricEncryption") and will be used for rendering the signature image if integer parameter "RenderSignature" is non-zero (unless a signature image is specified by blob parameter "Image"). If used for rendering, the data must be in a format understood by SignWare (e.g., created by SPFlatFileCreateFromSignature()).
• BiometricKey The public key (be_rsa) or the AES key (be_binary) for encrypting the biometric data. See also string parameter "BiometricKeyPath" and Encryption of biometric data.
• Certificate The certificate for the signature. The blob must contain a serialized X.509 certificate (DER or PEM) and blob parameter "CertificatePrivateKey" must contain the private key for that certificate. Alternatively, for PKCS #7 signatures and CAdES detached signatures, the blob may contain the certificate and its private key in PKCS #12 format; string parameter "PKCS#12Password" contains the password for extracting the private key.
• CertificatePrivateKey The private key for the (self-signed) certificate in PKCS #1 format (DER or PEM) for RSA or in PKCS #1 format (DER or PEM) for RSA or in SEC 1 format, traditional format, or PKCS #8 format (DER or PEM) for ECDSA. If a certificate is passed in blob parameter "Certificate", this parameter must contain the private key for that certificate. If a self-signed certificate is to be generated, the private key can be either set with this parameter or generated with integer parameter "GenerateKeyPair" or with string parameter "GenerateECCKeyPair".
• FilterCertificatesByIssuerCertificate Acceptable issuer certificates. Setting this parameter adds the specified DER-encoded certificate to a list of acceptable issuer certificates. Pass null to clear the list. A PDF document may contain (in its certificate seed value dictionaries) additional restrictions for acceptable issuer certificates. A signer certificate is acceptable for the rule defined by this parameter if it chains up to any of the certificates in the list of acceptable issuer certificates. SignDocDocument.addSignature() will fail if no matching certificate is available for signing. Note that csf_software and/or csf_hardware must be included in integer parameter "SelectCertificate" to make certificates available at all.
• FilterCertificatesBySubjectCertificate Acceptable certificates. Setting this parameter adds the specified DER-encoded certificate to a list of acceptable certificates. Pass null to clear the list. A PDF document may contain (in its certificate seed value dictionaries) additional restrictions for acceptable certificates. SignDocDocument.addSignature() will fail if no matching certificate is available for signing. Note that csf_software and/or csf_hardware must be included in integer parameter "SelectCertificate" to make certificates available at all.
• Image The signature image. The image can be in BMP, JPEG, PNG, or TIFF format. If no image is set (or rendered, see integer parameter "RenderSignature"), the signature field may or may not show an image computed from the biometric data, depending on the document type and signature field type. This parameter overrides integer parameter "RenderSignature". See also integer parameters "ImageDPI", "ImageTransparency", and blob parameter "Template".
• IntermediateCertificate An intermediate certificate for the signature. The blob must contain a DER-encoded X.509 certificate or one or more PEM-encoded X.509 certificates. setBlob() calls with name "IntermediateCertificate" are cumulative. Intermediate certificates can also be provided in the PKCS #12 blob passed to blob parameter "Certificate". See also integer parameter "AddCertificates".
• Template An XML document specifying the layout of the appearance of a signature in PDF documents. The XML document must conform to SignatureTemplate.dtd, which see for details. SignatureTemplate.dtd, which see for details. You can control the layout of the appearance of the signature by
  • using the default values provided by SignDocDocument.createSignatureParameters(), or
  • using only string parameters (such as "FontName"), integer parameters (such as "TextPosition"), length parameters (such as "ImageMargin"), and color parameters (such as "TextColor") or
  • using only blob parameter "Template", or
  • a mixture of the above.
  Initial values for the parameters are provided by SignDocDocument.createSignatureParameters(). If blob parameter "Template" is set, text items added by addTextItem() and friends are ignored, but other parameters provide default values for attributes not used in the XML document.

Additionally, you can store your own blobs in the signature by using a name starting with "Prop_", except for "Prop_AuthTime", "Prop_AuthType", "Prop_BiometricData", and "Prop_Build", see de.softpro.doc.SignDocVerificationResult.getSignatureString(). The name shall contain the following characters only: 0-9, a-z, A-Z, '-', and '_'.

Parameters:

[in]	aName	The name of the parameter (case-sensitive).
[in]	aData	The value.

Returns:

rc_ok iff successful.

See also:

getTemplate()

Todo:

support PKCS #7 for "Certificate"

synchronized int de.softpro.doc.SignDocSignatureParameters.setColor	(	String	aName,
		SignDocColor	aValue
	)		throws SignDocException

Set a color parameter.

Available color parameters are:

• SignatureColor The foreground color for the rendered signature (see integer parameter "RenderSignature"). The default color is black.
• TextColor The color to be used for text in the appearance of a DigSig signature field in a PDF document. If this parameter is not set, the color will be taken from the field's text field attributes. If the field doesn't have text field attributes, the document's text field attributes will be used. If this also fails, the text will be black. See also string parameter "FontName", length parameter "FontSize", and blob parameter "Template".

Parameters:

[in]	aName	The name of the parameter (case-sensitive).
[in]	aValue	The value of the parameter.

Returns:

rc_ok iff successful.

synchronized int de.softpro.doc.SignDocSignatureParameters.setECDSA

(

SignECDSA

aECDSA )

throws SignDocException

Set an object which will compute an ECDSA signature.

By default, ECDSA signatures are computed internally which means that the private key must be available on this machine.

Requirements for string parameters:

• GenerateECCKeyPair must not be set

Requirements for integer parameters:

• GenerateKeyPair must not be set
• SelectCertificate must be zero (which is the default value)

Requirements for blob parameters:

• Certificate must not be set
• CertificatePrivateKey must not be set

setRSA() and setPKCS7() must not have been called

Parameters:

[in]

aECDSA

The object that will compute the ECDSA signature.

Returns:

rc_ok iff successful.

See also:

setPKCS7()

synchronized int de.softpro.doc.SignDocSignatureParameters.setInteger	(	String	aName,
		int	aValue
	)		throws SignDocException

Set an integer parameter.

Available integer parameters are:

• AddCertificates This parameter controls inclusion of intermediate and root certificates. The value is ac_none, ac_all, or ac_trusted. The default value is ac_all. If you are using setPKCS7(), you'll have to include the certificates yourself. See also integer parameter "AddRevocationInfo" and blob parameter "IntermediateCertificate".
• AddRevocationInfo This parameter controls inclusion of revocation data (CRL and OCSP) for the signing certificate (unless it is self-signed) and the intermediate certificates. See ari_add. If the parameter is zero (which is the default value), revocation data won't be included. If the signature field has a mandatory AddRevInfo seed value, with value true, AddRevocationInfo is assumed to have ari_add set. If revocation data is to be added, integer parameter "Method" must be set to m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached, otherwise signing will fail. Integer parameter "AddCertificates" must be ac_all or ac_trusted, otherwise signing will fail. If revocation data is to be included, vf_check_revocation is assumed to be set in the value of integer parameter "VerificationFlags" of the verification parameters. Integer parameter "VerificationModel" of addSignature()'s aVerificationParameters is assumed to be vm_chain if it is vm_minimal (to enable inclusion of all certificates but the root certificate). If revocation data cannot be retrieved or if any of the certificates for which revocation information is retrieved is revoked or has unknown revocation status, signing will fail. If you are using setPKCS7(), you'll have to include revocation information yourself.
• BiometricEncryption Specifies how biometric data is to be encrypted (be_rsa, be_fixed, be_binary, be_passphrase, or be_dont_store). If not set, biometric data will not be embedded in the signature.
• BiometricHashLocation Specifies where to store the message digest computed over the document hash and the unencrypted biometric data (bhl_attr or bhl_contents). This parameter is used for PDF documents only. The default value is bhl_attr.
• CertificateSigningAlgorithm The signing algorithm for the self-signed certificate (csa_sha1_rsa, csa_md5_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa, or csa_ripemd160_rsa). When a self-signed certificate is to be generated, the signing algorithm can be set. If not set, a suitable default value will be used.
• DetachedHashAlgorithm Hash algorithm to be used for a detached signature (ie, if integer parameter "Method" is m_digsig_pkcs7_detached or m_digsig_cades_detached). Use dha_default, dha_sha1, dha_sha224, dha_sha256, dha_sha384, dha_sha512, or dha_ripemd160. The default value is dha_default. See also integer parameters "Method" and "IgnoreSeedValues".
• DocMDP To create a certification signature rather than an approval signature, set this parameter to a positive value (PDF only):
  • 1 no changes to the document shall be permitted
  • 2 only filling in forms, instantiating page templates, and signing shall be permitted
  • 3 only filling in forms, instantiating page templates, signing, creating annotations, deleting annotations, and modifying annotations shall be permitted.
  To create an approval signature, set this parameter to 0 or -1. The default value is -1. A positive MDP value from the signature seed value dictionary overrides this parameter, see SignDocField.getSeedValueMDP(). A PDF document can have at most one certification signature. If you want the certification signature to be invisible, create the signature field with zero for the left, bottom, right, and top coordinates.
• GenerateKeyPair Start generation of an RSA key pair for the self-signed certificate. The value is the number of bits (1024 through 4096, multiple of 8). When a self-signed certificate is to be generated, the private key can be either be generated by setting this parameter or set as blob parameter "CertificatePrivateKey". See also string parameter "GenerateECCKeyPair". "GenerateECCKeyPair" and "GenerateKeyPair" are mutually exclusive.
• IgnoreSeedValues Specifies what entries in the signature field seed value dictionary shall be ignored. This parameter contains a combination of isv_DigestMethod and isv_SubFilter. The default value is 0 which means that signing might fail due to a conflict between integer parameters "Method" and "DetachedHashAlgorithm" on one hand and the SubFilter and DigestMethod entries of the signature field seed value dictionary on the other hand. The Cert entry of the signature field seed value dictionary is currently ignored by default, see csf_use_certificate_seed_values of integer parameter "SelectCertificate". This parameter is ignored for TIFF documents.
• ImageDPI Resolution in DPI of the image passed in blob parameter "Image" for PDF signature fields. The width and height of the image computed by multiplying the resolution with the number of horizontal pixels and vertical pixels, respectively, limits the size of the image in the signature field: The image will never be wider or higher than that width and height, respectively. (You can cheat by specifying a smaller resolution.) Positive values of this parameter specify the horizontal resolution in DPI, zero means that the resolution is taken from the image (the behavior is undefined if the image does not specify a resolution), -1 means that the size of the image in the signature field won't be limited by values computed from its size (apart from the aspect ratio). The default value is -1. This parameter is ignored for TIFF documents.
• ImageHAlignment The horizontal alignment of the image (ha_left, ha_center, or ha_right). For DigSig signature fields, this parameter defines the horizontal alignment of the image in the appearance stream of PDF documents. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	ha_center
  "image"	ha_center

  See also blob parameter "Template".
• ImageVAlignment The vertical alignment of the image (va_top, va_center, or va_bottom). For DigSig signature fields, this parameter defines the vertical alignment of the image in the appearance stream of PDF documents. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	va_top
  "image"	va_center

  See also blob parameter "Template".
• ImageTransparency Image transparency (it_opaque or it_brightest). For DigSig signature fields, this parameter defines how to handle transparency for signature image (either the image passed in the "Image" blob parameter or the image computed according to the "RenderSignature" integer parameter). The default value is it_brightest. See also blob parameter "Template".
• Method The signing method (m_default, m_digsig_pkcs1, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, m_hash, or m_digsig_cades_detached). The default value is m_default. See also integer parameters "DetachedHashAlgorithm" and "IgnoreSeedValues".
• Optimize Set whether this is the first signature of the document and the document shall be optimized or whether the document shall not be optimized. Use o_optimize or o_dont_optimize. For PDF documents, o_optimize requires saving to a new file, see string parameter "OutputPath". The default value is o_dont_optimize. If the return value of getRequiredSaveToFileFlags() includes sf_incremental, signing with this parameter set to o_optimize will fail.
• PDFAButtons Set whether appearance streams of check boxes and radio buttons shall be frozen (fixed) for conformance with PDF/A-1 without TC2 before signing. Use pb_freeze, pb_dont_freeze, or pb_auto. The default value is pb_dont_freeze.
• PenWidth Pen width for rendering the signature (see blob parameter "BiometricData") for the signature image. Ignored unless integer parameter "RenderSignature" is non-zero. The pen width is specified in micrometers, the default value is 500 (0.5mm).
• RemoveXFA This parameter controls whether the XFA entry of the interactive form dictionary of the PDF document shall be removed. SignDoc SDK does not support XFA (XML Forms Architecture) and therefore addSignature(), addField(), applyFdf(), and setField() remove XFA from the document to avoid descrepancies between "classic" form fields and XFA. Use one of these values: rx_always, rx_if_possible, rx_never. The default value is rx_if_allowed. This parameter is ignored for TIFF documents.
• RenderSignature Specifies whether and how the signature (see blob parameter "BiometricData") is to be rendered for the signature image. This parameter contains 0, rsf_bw, rsf_gray. or rsf_antialias. If this value is 0, the signature won't be rendered. If no image is rendered (or set, see blob parameter "Image"), the signature field may or may not show an image computed from the biometric data, depending on the document type and signature field type. This parameter is ignored if blob parameter "Image" is set. The default value is 0. See also integer parameters "ImageTransparency", "PenWidth", and "RenderWidth" and color parameter "SignatureColor". "RenderSignature" is not supported under iOS and Android.
• RenderWidth Specifies the width (in pixels) for the signature image rendered from biometric data for PDF documents. This parameter is ignored for TIFF documents. The default value is 600. If the signature is higher than wide, this value specified the height of the signature image.
• RSASignatureScheme The RSA signature scheme to be used for PKCS #7 signatures with RSA keys:
  • rss_pkcs1 (default value)
  • rss_pss
• SelectCertificate Let the user and/or the application select the certificate for the signature. The parameter contains a combination of csf_software, csf_hardware, csf_ask_if_ambiguous, csf_never_ask, csf_create_self_signed, and csf_use_certificate_seed_values. If this parameter is zero (which is the default value), the user won't be asked and the certificate will either be generated on the fly or be supplied by the "Certificate" blob parameter and SignDocDocument.addSignature() will fail if the PDF document restricts acceptable certificates by means of a certificate seed value dictionary. This parameter is not yet implemented for Linux, iOS, Android, OS X, and Windows Store apps. See also string parameters "SelectCertificateMessage" and "SelectCertificateTitle".
• TextHAlignment The horizontal alignment of text lines (ha_left, ha_center, ha_right, ha_justify, or ha_auto). For DigSig signature fields, this parameter defines the horizontal alignment of text lines in the appearance stream of PDF documents. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	ha_center
  "image"	ha_center

  See also blob parameter "Template".
• TextPosition The position of the text block w.r.t. the image (tp_above, tp_below, tp_left_of, tp_overlay, tp_right_of or tp_underlay). For DigSig signature fields, this parameter defines the position of the text block in the appearance stream of PDF documents. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	tp_below
  "image"	tp_overlay

  See also blob parameter "Template".
• TextVAlignment The vertical alignment of text lines (va_top, va_center, or va_bottom). For DigSig signature fields, this parameter defines the vertical alignment of text lines in the appearance stream of PDF documents. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	va_bottom
  "image"	va_center

  See also blob parameter "Template".
• TimeStampHashAlgorithm Hash algorithm for RFC 3161 time-stamps. See tsha_default, tsha_sha1, tsha_sha256, tsha_sha384, and tsha_sha512. The default value is tsha_default. See also string parameter "TimeStampServerURL".
• TimeStampRetries The maximum number of retries for obtaining an RFC 3161 timestamp after a timeout. The default value is 0. See also string parameter "TimeStampServerURL".
• TimeStampServerTimeout Time out in milliseconds for retrieving a time stamp from an RFC 3161 time-stamp server. The value must be positive. The default value is 10000. See also string parameter "TimeStampServerURL".
• TimeStampSize If the value of this parameter is positive, add this many octets for the RFC 3161 timestamp to the anticipated size of the PKCS #7 message. If the value is zero or negative, a dummy time stamping request will be sent to the time-stamp server and the value of this parameter will be subtracted from the size of the response; as the response will be wrapped in an attribute, the value of this parameter should be smaller than -25. The default value is 8192. See also string parameter "TimeStampServerURL".

Parameters:

[in]	aName	The name of the parameter (case-sensitive).
[in]	aValue	The value of the parameter.

Returns:

rc_ok iff successful.

Todo:

document when "SelectCertificate" presents the dialog

implement "SelectCertificate" for Linux

synchronized int de.softpro.doc.SignDocSignatureParameters.setLength	(	String	aName,
		int	aType,
		double	aValue
	)		throws SignDocException

Set a length parameter.

Available length parameters are:

• FontSize The maximum font size. For DigSig signature fields, this parameter defines the maximum font size for the appearance stream of PDF documents. The font size will be reduced to make all text lines fit horizontally into the signature field. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	vt_field_height and 0.1
  "image"	vt_field_height and 0.1

  See also string parameter "FontName", color parameter "TextColor", and blob parameter "Template".
• ImageMargin The margin to add around the image. For DigSig signature fields, this parameter defines the margin to be added around the image in the appearance stream of PDF documents. This margin is added at all four edges of the image. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	vt_abs and 1.0
  "image"	vt_abs and 1.0

  See also blob parameter "Template".
• TextHMargin The horizontal margin for text. For DigSig signature fields, this parameter defines the horizontal margin of text in the appearance stream of PDF documents. The margin will be added on both sides of the text. The default value depends on the profile passed to SignDocDocument.createSignatureParameters():

  Profile	Value
  ""	vt_field_height and 0.1
  "image"	vt_field_height and 0.1

  See also blob parameter "Template".

Parameters:

[in]	aName	The name of the parameter (case-sensitive).
[in]	aType	Define how the length is specified (vt_abs, vt_field_height, or vt_field_width).
[in]	aValue	The value of the parameter.

Returns:

rc_ok iff successful.

See also:

vt_abs, vt_field_height, vt_field_width

synchronized int de.softpro.doc.SignDocSignatureParameters.setPKCS7

(

SignPKCS7

aPKCS7 )

throws SignDocException

Set an object which will create a PKCS #7 or CAdES signature.

By default, PKCS #7 and CAdES signatures are handled internally which means that the private key must be available on this machine.

Requirements for string parameters:

• CommonName must not be set
• Country must not be set
• GenerateECCKeyPair must not be set
• Locality must not be set
• Organization must not be set
• OrganizationUnit must not be set

Requirements for integer parameters:

• GenerateKeyPair must not be set
• Method must be m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached
• SelectCertificate must be zero (which is the default value)

Requirements for blob parameters:

• Certificate must not be set
• CertificatePrivateKey must not be set

setECDSA() and setRSA() must not have been called

The SignPKCS7 interface is quite hard to use, please use setRSA() and the SignRSA interface or setECDSA() and the SignECDSA interface instead.

Parameters:

[in]

aPKCS7

The object that will create the PKCS #7 or CAdES signature.

Returns:

rc_ok iff successful.

See also:

setECDSA(), setRSA()

synchronized int de.softpro.doc.SignDocSignatureParameters.setRSA

(

SignRSA

aRSA )

throws SignDocException

Set an object which will compute an RSA signature.

By default, RSA signatures are computed internally which means that the private key must be available on this machine.

Requirements for string parameters:

• GenerateECCKeyPair must not be set

Requirements for integer parameters:

• GenerateKeyPair must not be set
• SelectCertificate must be zero (which is the default value)

Requirements for blob parameters:

• Certificate must not be set
• CertificatePrivateKey must not be set

setECDSA() and setPKCS7() must not have been called

Parameters:

[in]

aRSA

The object that will compute the RSA signature.

Returns:

rc_ok iff successful.

See also:

setPKCS7()

synchronized int de.softpro.doc.SignDocSignatureParameters.setString	(	String	aName,
		String	aValue
	)		throws SignDocException

Set a string parameter.

Available string parameters are:

• Adviser The adviser. For DigSig signature fields, the adviser may be used for the appearance stream of PDF documents (see ti_adviser). The default value is empty. Complex scripts are supported, see Complex Scripts.
• BiometricKeyPath The pathname of a file containing the public key in PKCS #1 or X.509 format for encrypting the biometric data with integer parameter "BiometricEncryption" set to be_rsa. See also blob parameter "BiometricKey" and Encryption of biometric data.
• BiometricPassphrase Passphrase to be used if integer parameter "BiometricEncryption" is be_passphrase. Should contain ASCII characters only.
• Comment The comment. For DigSig signature fields, the comment may be used for the appearance stream of PDF documents (see ti_comment). The comment can contain multiple lines which are separated by '
  '. The default value is empty. Complex scripts are supported, see Complex Scripts.
• CommonName The common name for the self-signed certificate. When a self-signed certificate is to be generated, the common name (CN) must be set. See also string parameter "Signer".
• ContactInfo The contact information provided by the signer. For DigSig signature fields, the contact information will be stored in the digital signature. For DigSig signature fields, the contact information may be used for the appearance stream of PDF documents (see ti_contact_info). The default value is empty. Complex scripts are supported, see Complex Scripts.
• Country The country name for the self-signed certificate. When a self-signed certificate is to be generated, the country name (C) should be set. Use ISO 3166 country codes. The default value is empty.
• Filter The name of the preferred filter. For DigSig signature fields, the filter name will be stored in the digital signature. The default value is "SOFTPRO DigSig Security". You might want to set the filter to "Adobe.PPKLite".
• FilterCertificatesByPolicy A required certificate policy. Setting this parameter adds the specified OID to a list of required policy object identifiers. All specified policies are required for a certificate to be accepted. Pass an empty value to clear the list. The value must be a valid ASN.1 object identifier. A PDF document may contain (in its certificate seed value dictionaries) additional restrictions for acceptable certificates. SignDocDocument.addSignature() will fail if no matching certificate is available for signing. Note that csf_software and/or csf_hardware must be included in integer parameter "SelectCertificate" to make certificates available at all.
• FilterCertificatesBySubjectDN An acceptable subject Distinguished Name (DN). Setting this parameter adds the specified DN to a list of acceptable DNs. Pass an empty value to clear the list. The DN must be formatted according to RFC 4514, using short names for the attribute types. Multi-valued RDNs and multiple RDNs specifying a value for the same attribute are not allowed. A PDF document may contain (in its certificate seed value dictionaries) additional restrictions for acceptable certificates. SignDocDocument.addSignature() will fail if no matching certificate is available for signing. Note that csf_software and/or csf_hardware must be included in integer parameter "SelectCertificate" to make certificates available at all.
• FontName The name of the font to be used for text in the appearance of a DigSig signature field in a PDF document. The font name can be the name of a standard font, the name of an already embedded font, or the name of a font defined by a font configuration file. If the name is empty, the font name will be taken from the field's text field attributes. If the field doesn't have text field attributes, the document's text field attributes will be used. If this also fails, standard font Helvetica will be used (which will break PDF/A conformance). The default value is empty. See also length parameter "FontSize", color parameter "TextColor", and blob parameter "Template".
• GenerateECCKeyPair Start generation of an elliptic curve key pair for the self-signed certificate. The value is the name or the object identifier of the curve, e.g., prime256v1. When a self-signed certificate is to be generated, the private key can be either be generated by setting this parameter or set as blob parameter "CertificatePrivateKey". See also integer parameter "GenerateKeyPair". "GenerateECCKeyPair" and "GenerateKeyPair" are mutually exclusive.
• Locality The location name for the self-signed certificate. When a self-signed certificate is to be generated, the location name (L) should be set. The default value is empty. Do not confuse "Locality" and "Location"!
• Location The host name or physical location of signing. For DigSig signature fields, the location will be stored in the digital signature. For DigSig signature fields, the location may be used for the appearance stream of PDF documents (see ti_location). The default value is empty. Complex scripts are supported, see Complex Scripts. Do not confuse "Location" and "Locality"!
• Organization The organization name for the self-signed certificate. When a self-signed certificate is to be generated, the organization name (O) should be set. The default value is empty.
• OrganizationUnit The organization unit name for the self-signed certificate. When a self-signed certificate is to be generated, the organization unit name (OU) should be set. The default value is empty.
• OutputPath Specify the file to which the signed document shall be saved. If this parameter is empty and the document is backed by a file (ie, the last load or save operation was from or to a file, respectively), the signed document will be written to that file. The special value "<memory>" causes the document to be saved to and signed in memory (available for PDF documents only). See also integer parameter "Optimize". The default value is empty.
• PKCS#12Password The password for extracting the private key from the PKCS #12 blob set as blob parameter "Certificate". The password must contain ASCII characters only.
• Reason The reason for the signing. For DigSig signature fields, the reason will be stored in the digital signature. For DigSig signature fields, the reason may be used for the appearance stream of PDF documents (see ti_reason). The default value is empty. Complex scripts are supported, see Complex Scripts.
• SelectCertificateMessage A message to be displayed in the certificate selection dialog, see integer parameter "SelectCertificate".
• SelectCertificateTitle The title of the certificate selection dialog, see integer parameter "SelectCertificate". A localized version of "Select Certificate" will be used if empty or not set.
• Signer The signer name. This is the signer name that will be stored in the digital signature. If not set, the name will be taken from the certificate. For DigSig signature fields, the signer name may be used for the appearance stream of PDF documents (see ti_signer). The default value is empty (meaning that the name will be taken from the signing certificate). See also string parameter "CommonName". Complex scripts are supported, see Complex Scripts.
• SignTime The time of signing in free format. For DigSig signature fields, the time of signing may be used for the appearance stream of PDF documents (see ti_sign_time). The default value is empty. See also string parameter "Timestamp".
• Text1 A text to be included in the appearance stream of DigSig signature fields in PDF documents (see ti_text1). The text can contain multiple lines which are separated by '
  '. The default value is empty. Complex scripts are supported, see Complex Scripts. See also blob parameter "Template".
• Text2 See Text1 and ti_text2.
• Text3 See Text1 and ti_text3.
• Text4 See Text1 and ti_text4.
• Text5 See Text1 and ti_text5.
• Text6 See Text1 and ti_text6.
• Text7 See Text1 and ti_text7.
• Text8 See Text1 and ti_text8.
• Text9 See Text1 and ti_text9.
• Timestamp The timestamp to be used in the digital signature (instead of the current time). ISO 8601 format must be used: "yyyy-mm-ddThh:mm:ss" with optional timezone. For DigSig signature fields, the timestamp will be stored in the signature dictionary (transformed suitably for the M entry). If empty, the current time will be used. If the value is "-", the M entry will be omitted (this is only allowed if the PKCS #7 message contains a signingTime or timeStampToken attribute; note that the signingTime attribute is not allowed for method m_digsig_cades_detached). The default value is empty. If this parameter is set to a non-empty value, no time stamp will be retrieved from an RFC 3161 time-stamp server, even if specified by the signature field seed value dictionary. Do not set this parameter if a self-signed certificate is to be created. See also string parameters "SignTime" and "TimeStampServerURL".
• TimeStampClientCertificatePath The pathname of a file containing the certificate in PEM format for authenticating to an RFC 3161 time-stamp server over HTTPS. If the is non-empty, string parameter "TimeStampClientKeyPath" must also be set. If the value is empty, the client won't authenticate itself. The default value is empty. See also string parameters "TimeStampServerURL" and "TimeStampClientKeyPath".
• TimeStampClientKeyPath The pathname of a file containing the private key in PEM format for authenticating to an RFC 3161 time-stamp server over HTTPS. If the is non-empty, string parameter "TimeStampClientCertificatePath" must also be set. If the value is empty, the client won't authenticate itself. The default value is empty. See also string parameters "TimeStampServerURL", and "TimeStampClientKeyPath".
• TimeStampServerPassword The password for Basic/Digest HTTP authentication to the time-stamp server. Non-ASCII values probably don't work. If this parameter is set, string parameter "TimeStampServerUser" must also be set.
• TimeStampServerURL The URL of an RFC 3161 time-stamp server. If string parameter "Timestamp" is empty and string parameter "TimeStampServerURL" is non-empty, a time stamp will be obtained from a time-stamp server. The scheme of the URL must be either "http" or "https". The time-stamp server URL specified by the document's signature field seed value dictionary overrides the "TimeStampServerURL" parameter. An error will be returned by SignDocDocument.addSignature() if a time-stamp server is to be used and integer parameter "Method" is not m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, or m_digsig_cades_detached. See also integer parameters "TimeStampHashAlgorithm", "TimeStampRetries", "TimeStampServerTimeout", and "TimeStampSize", and string parameters "TimeStampClientCertificatePath", "TimeStampClientKeyPath", "TimeStampServerPassword", "TimeStampServerUser", and "TimeStampUserAgent". See also SignDocDocumentLoader.loadTrustedCertificatesFromFile().
• TimeStampServerUser The user name for Basic/Digest HTTP authentication to the time-stamp server. Non-ASCII values probably don't work. If this parameter is set, string parameter "TimeStampServerPassword" must also be set.
• TimeStampUserAgent The value of the User-Agent header field sent to the time-stamp server. The default value is "SignDoc".

Additionally, you can store your own strings in the signature by using a name starting with "Prop_", except for "Prop_AuthTime", "Prop_AuthType", "Prop_BiometricData", and "Prop_Build", see de.softpro.doc.SignDocVerificationResult.getSignatureString(). The name shall contain the following characters only: 0-9, a-z, A-Z, '-', and '_'. The length of the value is restricted for PDF documents and depends on the characters being used; the value encoded as PDF text string shall not exceed 32767 octets.

Parameters:

[in]	aName	The name of the parameter (case-sensitive).
[in]	aValue	The value of the parameter.

Returns:

rc_ok iff successful.

synchronized int de.softpro.doc.SignDocSignatureParameters.setTextItemDirection	(	int	aItem,
		int	aHAlignment,
		int	aDirection
	)		throws SignDocException

Set the paragraph direction of text items.

This function sets the paragraph direction of all existing text items matching aItem.

See also blob parameter "Template".

Parameters:

[in]	aItem	Select the text items (ti_signer etc.)
[in]	aHAlignment	Horizontal alignment. This value overrides integer parameter "TextHAlignment" unless it is ha_default.
[in]	aDirection	The paragraph direction: 0, tid_ltr, tid_rtl, tid_default_ltr, or tid_default_rtl. 0 is treated like tid_ltr.

Returns:

rc_ok iff successful.

See also:

addTextItem()

---

Member Data Documentation

final int de.softpro.doc.SignDocSignatureParameters.ac_all = 0 [static]

Integer parameter AddCertificates: Include all intermediate certificates and the root certificate.

This requires building at signing time the complete certificate chain up to a self-signed certificate. It does not matter whether that self-signed certificate is a trusted root CA certificate or not.

See also:

ac_none, ac_trusted

final int de.softpro.doc.SignDocSignatureParameters.ac_none = 1 [static]

Integer parameter AddCertificates: Do not include any certificates.

It is assumes that the signing certificate is a self-signed certificate or all intermediate certificates are available at verification time.

See also:

ac_all, ac_trusted

final int de.softpro.doc.SignDocSignatureParameters.ac_trusted = 2 [static]

Integer parameter AddCertificates: Include all intermediate certificates and the root certificate, require the root certificate to be trusted.

This requires building at signing time the complete certificate chain up to a self-signed certificate. That self-signed certificate must be trusted, otherwise signing will fail.

See also:

ac_all, ac_none

final int de.softpro.doc.SignDocSignatureParameters.ari_add = 0x01 [static]

Flag for integer parameter AddRevocationInfo: Add revocation data.

This requires building at signing time the complete certificate chain up to a self-signed certificate. It does not matter whether that self-signed certificate is a trusted root CA certificate or not.

final int de.softpro.doc.SignDocSignatureParameters.be_binary = 2 [static]

Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Binary 256-bit key.

Blob parameter "BiometricKey" must be set.

The biometric data to be encrypted is specified by blob parameter "BiometricData".

See also:

setInteger(), setBlob(), be_dont_store, be_fixed, be_passphrase, be_rsa

final int de.softpro.doc.SignDocSignatureParameters.be_dont_store = 4 [static]

Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): The biometric data won't be stored in the document.

Use this value if you want to use the biometric data for generating the signature image only. Note that using an automatically generated self-signed certificate is secure only if biometric data is stored in the document using asymmetric encryption.

See also:

setInteger(), setString(), setBlob(), be_binary, be_fixed, be_passphrase, be_rsa

final int de.softpro.doc.SignDocSignatureParameters.be_fixed = 1 [static]

Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Fixed key (no security).

The biometric data to be encrypted is specified by blob parameter "BiometricData".

See also:

setInteger(), be_binary, be_dont_store, be_passphrase, be_rsa

final int de.softpro.doc.SignDocSignatureParameters.be_passphrase = 3 [static]

Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Passphrase that will be hashed to a 256-bit key.

String parameter "BiometricPassphrase" must be set.

The biometric data to be encrypted is specified by blob parameter "BiometricData".

See also:

setInteger(), setString(), setBlob(), be_binary, be_dont_store, be_fixed, be_rsa

final int de.softpro.doc.SignDocSignatureParameters.be_rsa = 0 [static]

Select how to encrypt the biometric data (for integer parameter "BiometricEncryption"): Random session key encrypted with public RSA key.

Either blob parameter "BiometricKey" or string parameter "BiometricKeyPath" must be set.

The biometric data to be encrypted is specified by blob parameter "BiometricData".

See also:

setInteger(), setBlob(), setString(), be_binary, be_dont_store, be_fixed, be_passphrase, Encryption of biometric data

final int de.softpro.doc.SignDocSignatureParameters.bhl_attr = 0 [static]

Select where to store the message digest computed over the document hash and the unencrypted biometric data: If possible, store the biometric hash as unauthenticated attribute in the PKCS #7 (or CMS) message.

Used for integer parameter "BiometricHashLocation".

For method m_digsig_pkcs1, the biometric hash will stored in the Contents entry of the signature dictionary (see bhl_contents).

For all other methods, the biometric hash will stored as unauthenticated attribute in the PKCS #7 (or CMS) message.

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.bhl_contents = 1 [static]

Select where to store the message digest computed over the document hash and the unencrypted biometric data: Store the message digest in the Contents entry of the signature dictionary.

Used for integer parameter "BiometricHashLocation".

This is what SignDoc SDK 4.1 and older did; it violates a constraint of most PDF specifications.

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.csa_ecdsa_sha1 = 6 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-1.

See also:

setInteger(), csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_ecdsa_sha224 = 7 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-224.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_ecdsa_sha256 = 8 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-256.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_ecdsa_sha384 = 9 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-384.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_ecdsa_sha512 = 10 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): ECDSA with SHA-512.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_md5_rsa = 1 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): MD5 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_ripemd160_rsa = 5 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-512 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_sha1_rsa = 0 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-1 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha256_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_sha256_rsa = 2 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-256 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha384_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_sha384_rsa = 3 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-384 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha512_rsa

final int de.softpro.doc.SignDocSignatureParameters.csa_sha512_rsa = 4 [static]

Signing algorithms for self-signed certificates (for integer parameter "CertificateSigningAlgorithm"): SHA-512 with RSA.

See also:

setInteger(), csa_ecdsa_sha1, csa_ecdsa_sha224, csa_ecdsa_sha256, csa_ecdsa_sha384, csa_ecdsa_sha512, csa_md5_rsa, csa_ripemd160_rsa, csa_sha1_rsa, csa_sha256_rsa, csa_sha384_rsa

final int de.softpro.doc.SignDocSignatureParameters.csf_ask_if_ambiguous = 0x20 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": ask the user to select a certificate if there is more than one matching certificate.

See also:

setInteger(), csf_hardware, csf_software, csf_create_self_signed, csf_never_ask, csf_use_certificate_seed_values

final int de.softpro.doc.SignDocSignatureParameters.csf_create_self_signed = 0x80 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": offer to create a self-signed certificate (cannot be used with csf_never_ask and csf_ask_if_ambiguous).

See also:

setInteger(), csf_hardware, csf_software

final int de.softpro.doc.SignDocSignatureParameters.csf_hardware = 0x02 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": include certificates with hardware-based private keys.

As software-based private keys and hardware-based private keys cannot be reliably distinguished, you should always set both csf_software and csf_hardware.

If neither csf_ask_if_ambiguous nor csf_never_ask is included, the certificate selection dialog will be displayed.

See also:

setInteger(), csf_software, csf_create_self_signed, csf_ask_if_ambiguous, csf_never_ask, csf_use_certificate_seed_values

final int de.softpro.doc.SignDocSignatureParameters.csf_never_ask = 0x40 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": never ask the user to select a certificate; exactly one certificate must match.

See also:

setInteger(), csf_hardware, csf_software, csf_create_self_signed, csf_never_ask, csf_use_certificate_seed_values

final int de.softpro.doc.SignDocSignatureParameters.csf_software = 0x01 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": include certificates with software-based private keys.

As software-based private keys and hardware-based private keys cannot be reliably distinguished, you should always set both csf_software and csf_hardware.

If neither csf_ask_if_ambiguous nor csf_never_ask is included, the certificate selection dialog will be displayed.

See also:

setInteger(), csf_hardware, csf_create_self_signed, csf_ask_if_ambiguous, csf_never_ask, csf_use_certificate_seed_values

final int de.softpro.doc.SignDocSignatureParameters.csf_use_certificate_seed_values = 0x10 [static]

Flags for selecting certificates (for integer parameter "SelectCertificate": include only certificates allowed by the PDF document's certificate seed value dictionary.

See also:

setInteger(), csf_ask_if_ambiguous, csf_hardware, csf_software, csf_create_self_signed, csf_never_ask

final int de.softpro.doc.SignDocSignatureParameters.dha_default = 0 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): default hash algorithm.

For RSA, use the hash algorithm specified by the DigestMethod values of the signature field seed value dictionary or, if not present, SHA-256 (if supported), or SHA-1 (as last resort).

For ECDSA, use the hash algorithm recommended for the elliptic curve used by the signing certificate's key.

See also:

setInteger(), dha_ripend160, dha_sha1, dha_sha224, dha_sha256, dha_sha384, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_ripemd160 = 5 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): RIPEMD-160.

dha_ripemd160 is not supported under Windows.

See also:

setInteger(), dha_default, dha_sha1, dha_sha224, dha_sha256, dha_sha384, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_sha1 = 1 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-1.

See also:

setInteger(), dha_default, dha_ripend160, dha_sha224, dha_sha256, dha_sha384, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_sha224 = 6 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-224.

dha_sha224 is supported for ECDSA signatures only.

See also:

setInteger(), dha_default, dha_ripend160, dha_sha1, dha_sha224, dha_sha384, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_sha256 = 2 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-256.

dha_sha256 is supported under Linux, iOS, Android, and under Windows XP SP3 and later. If dha_sha256 is selected but not supported, SignDocDocument.addSignature() will fall back to dha_sha1.

See also:

setInteger(), dha_default, dha_ripend160, dha_sha1, dha_sha224, dha_sha384, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_sha384 = 3 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-384.

dha_sha384 is supported under Linux, iOS, Android, and under Windows XP SP3 and later. If dha_sha384 is selected but not supported, SignDocDocument.addSignature() will fall back to dha_sha1.

See also:

setInteger(), dha_default, dha_ripend160, dha_sha1, dha_sha224, dha_sha256, dha_sha512

final int de.softpro.doc.SignDocSignatureParameters.dha_sha512 = 4 [static]

Hash algorithm to be used for a detached signature (for integer parameter "DetachedHashAlgorithm"): SHA-512.

dha_sha512 is supported under Linux, iOS, Android, and under Windows XP SP3 and later. If dha_sha512 is selected but not supported, SignDocDocument.addSignature() will fall back to dha_sha1.

See also:

setInteger(), dha_default, dha_ripend160, dha_sha1, dha_sha224, dha_sha256, dha_sha384

final int de.softpro.doc.SignDocSignatureParameters.ha_auto = 4 [static]

Horizontal alignment (for integer parameter "TextHAlignment" and for addTextItem2()): Align left if the text begins with an LTR run, align right if the text begins with an RTL run.

See also:

setInteger(), ha_center, ha_justify, ha_left, ha_right

final int de.softpro.doc.SignDocSignatureParameters.ha_center = 1 [static]

Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Center.

See also:

setInteger(), ha_auto, ha_justify, ha_left, ha_right

final int de.softpro.doc.SignDocSignatureParameters.ha_default = -1 [static]

Horizontal alignment (for addTextItem2()): Use integer parameter "TextHAlignment".

See also:

setInteger(), ha_auto, ha_center, ha_justify, ha_left, ha_right

final int de.softpro.doc.SignDocSignatureParameters.ha_justify = 3 [static]

Horizontal alignment (for integer parameter "TextHAlignment" and for addTextItem2()): Justify (align both and right, expanding white space).

Note:

Expanding white space is not the correct way to justify Arabic text.

See also:

setInteger(), ha_auto, ha_center, ha_left, ha_right

final int de.softpro.doc.SignDocSignatureParameters.ha_left = 0 [static]

Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Align left.

See also:

setInteger(), ha_auto, ha_center, ha_justify, ha_right,

final int de.softpro.doc.SignDocSignatureParameters.ha_right = 2 [static]

Horizontal alignment (for integer parameters "ImageHAlignment" and "TextHAlignment" and for addTextItem2()): Align right.

See also:

setInteger(), ha_auto, ha_center, ha_justify, ha_left

final int de.softpro.doc.SignDocSignatureParameters.isv_DigestMethod = 0x02 [static]

Flag for ignoring mandatory requirements specified by the signature seed value dictionary: Ignore DigestMethod (hash algorithm).

Used for integer parameter "IgnoreSeedValues".

If this flag is not set signing will fail if the hash algorithm specified by integer parameter "DetachedHashAlgorithm" is not dha_default (or is implied by integer parameter "Method") and is not listed in the DigestMethod entry of the signature field seed value dictionary.

If this flag is set, you can override the DigestMethod entry of the signature field seed value dictionary with integer parameter "DestachedHashAlgorithm" and/or "Method" without risking failure of signing due to a conflict with DigestMethod.

See also:

setInteger(), isv_SubFilter

final int de.softpro.doc.SignDocSignatureParameters.isv_SubFilter = 0x01 [static]

Flag for ignoring mandatory requirements specified by the signature seed value dictionary: Ignore SubFilter (signing method).

Used for integer parameter "IgnoreSeedValues".

If this flag is not set signing will fail if the signing method specified by integer parameter "Method" is neither m_default nor listed in the SubFilter entry of the signature field seed value dictionary.

If this flag is set, you can override the SubFilter entry of the signature field seed value dictionary with integer parameter "Method" without risking failure of signing due to a conflict between "Method" and SubFilter.

See also:

setInteger(), isv_DigestMethod

final int de.softpro.doc.SignDocSignatureParameters.it_brightest = 1 [static]

Transparency of signature image: Make the brightest color transparent.

If the image has an alpha channel (or if its palette contains a transparent color), the image's transparency will be used. Otherwise, white will be made transparent for truecolor images and the brightest color in the palette will be made transparent for indexed images (including grayscale images).

Transparency is not supported for JPEG images and JPEG-compressed TIFF images. Signature images created from biometric data (according to the "RenderSignature" integer parameter) don't have an alpha channel.

final int de.softpro.doc.SignDocSignatureParameters.it_opaque = 0 [static]

Transparency of signature image: Make signature image opaque.

The signature image will be opaque unless the image has an Used for integer parameter "ImageTransparency". alpha channel or transparent colors in its palette.

Transparency is not supported for JPEG images and JPEG-compressed TIFF images. Signature images created from biometric data (according to the "RenderSignature" integer parameter) don't have an alpha channel.

See also:

setInteger(), it_brightest

final int de.softpro.doc.SignDocSignatureParameters.m_default = 0 [static]

Signing method (for integer parameter "Method"): default method.

For signature parameters created by SignDocDocument.createSignatureParametersForTimeStamp(), this value is treated as m_digsig_cades_rfc3161.

Use the method specified by the SubFilter values of the signature field seed value dictionary or, if not present, m_digsig_pkcs7_detached.

This is the recommended method unless you need an ETSI CAdES signature (m_digsig_cades_detached).

See also:

setInteger(), m_digsig_cades_detached, m_digsig_pkcs1, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, m_hash

final int de.softpro.doc.SignDocSignatureParameters.m_digsig_cades_detached = 5 [static]

Signing method (for integer parameter "Method"): Detached ETSI CAdES (PAdES-BES).

See also:

setInteger(), m_default, m_digsig_pkcs1, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, m_hash

final int de.softpro.doc.SignDocSignatureParameters.m_digsig_cades_rfc3161 = 6 [static]

Signing method (for integer parameter "Method"): ETSI CAdES RFC 3161 time stamp.

See also:

m_digsig_pkcs1, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, m_hash, m_digsig_cades_detached

final int de.softpro.doc.SignDocSignatureParameters.m_digsig_pkcs1 = 1 [static]

Signing method (for integer parameter "Method"): PKCS #1 (RSA keys only).

Not allowed for PDF/A-2 and PDF/A-3.

See also:

setInteger(), m_default, m_digsig_cades_detached, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1, m_hash

final int de.softpro.doc.SignDocSignatureParameters.m_digsig_pkcs7_detached = 2 [static]

Signing method (for integer parameter "Method"): detached PKCS #7.

See also:

setInteger(), m_default, m_digsig_cades_detached, m_digsig_pkcs1, m_digsig_pkcs7_sha1, m_hash

final int de.softpro.doc.SignDocSignatureParameters.m_digsig_pkcs7_sha1 = 3 [static]

Signing method (for integer parameter "Method"): PKCS #7 with SHA-1 (deprecated).

See also:

setInteger(), m_default, m_digsig_cades_detached, m_digsig_pkcs1, m_digsig_pkcs7_detached, m_hash

final int de.softpro.doc.SignDocSignatureParameters.m_hash = 4 [static]

Signing method (for integer parameter "Method"): The signature is just a hash (TIFF only).

See also:

setInteger(), m_default, m_digsig_cades_detached, m_digsig_pkcs1, m_digsig_pkcs7_detached, m_digsig_pkcs7_sha1

final int de.softpro.doc.SignDocSignatureParameters.o_dont_optimize = 1 [static]

Don't optimize document before signing (for integer parameter "Optimize").

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.o_optimize = 0 [static]

Optimize document before signing (for integer parameter "Optimize").

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.pb_auto = 2 [static]

Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Freeze (fix) appearances if appropriate.

Used for integer parameter "PDFAButtons".

Freeze (fix) appearances if the document claims PDF/A-1 conformance and if there are no signed signature fields.

Using pb_auto if the document claims PDF/A-1 conformance and has no signed signature fields is equivalent to saving the document with SignDocDocument.sf_pdfa_buttons before signing.

This value should be used only if you need conformance with ISO 19005-1:2005 without Technical Corrigendum 2 (TC2), that is, if you need conformance with a standard that is no longer in force.

Note that TC2 is in force and using this value breaks conformance with TC2.

See also:

setInteger(), pb_dont_freeze, pb_freeze

final int de.softpro.doc.SignDocSignatureParameters.pb_dont_freeze = 1 [static]

Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Don't freeze (fix) appearances.

Used for integer parameter "PDFAButtons".

This value should be used unless you need conformance with a standard (ISO 19005-1:2005 without Technical Corrigendum 2) that is no longer in force.

See also:

setInteger(), pb_auto, pb_freeze

final int de.softpro.doc.SignDocSignatureParameters.pb_freeze = 0 [static]

Fix appearances of check boxes and radio buttons for PDF/A-1 without Technical Corrigendum 2 before signing: Freeze (fix) appearances.

Used for integer parameter "PDFAButtons".

Using pb_freeze is equivalent to saving the document with SignDocDocument.sf_pdfa_buttons before signing.

This value should be used only if you need conformance with ISO 19005-1:2005 before Technical Corrigendum 2 (TC2), that is, if you need conformance with a standard that is no longer in force.

Note that TC2 is in force and using this value breaks conformance with TC2.

See also:

setInteger(), pb_auto, pb_dont_freeze

final int de.softpro.doc.SignDocSignatureParameters.ps_ignored = 3 [static]

Status of a parameter: Parameter can be (or is) set but will be ignored.

ps_ignored is currently not used.

See also:

getState(), ps_not_supported, ps_set, ps_supported, ps_unknown

final int de.softpro.doc.SignDocSignatureParameters.ps_missing = 1 [static]

Status of a parameter: Parameter must be set but is not set.

ps_missing is currently not used.

See also:

getState(), ps_not_supported, ps_set, ps_supported, ps_unknown

final int de.softpro.doc.SignDocSignatureParameters.ps_not_supported = 4 [static]

Status of a parameter: Parameter is not supported for this field.

See also:

getState(), ps_set, ps_supported, ps_unknown

final int de.softpro.doc.SignDocSignatureParameters.ps_set = 0 [static]

Status of a parameter: Parameter has been set.

Most parameters have a default value such as the empty string which may be treated as "set" or "not set" depending on the implementation's fancy.

Don't make your code depend on the difference between ps_set and ps_supported.

See also:

getState(), ps_not_supported, ps_supported, ps_unknown

final int de.softpro.doc.SignDocSignatureParameters.ps_supported = 2 [static]

Status of a parameter: Parameter is supported and optional, but has not been set or is set to the default value.

Most parameters have a default value such as the empty string which may be treated as "set" or "not set" depending on the implementation's fancy.

Don't make your code depend on the difference between ps_set and ps_supported.

See also:

getState(), ps_not_supported, ps_set, ps_unknown

final int de.softpro.doc.SignDocSignatureParameters.ps_unknown = 5 [static]

Status of a parameter: Unknown parameter.

See also:

getState(), ps_not_supported, ps_set, ps_supported

final int de.softpro.doc.SignDocSignatureParameters.rc_invalid_value = 3 [static]

Return code for setter functions: The value for the parameter is invalid.

final int de.softpro.doc.SignDocSignatureParameters.rc_not_supported = 2 [static]

Return code for setter functions: Setting the parameter is not supported.

final int de.softpro.doc.SignDocSignatureParameters.rc_ok = 0 [static]

Return code for setter functions: Parameter set successfully.

final int de.softpro.doc.SignDocSignatureParameters.rc_unknown = 1 [static]

Return code for setter functions: Unknown parameter.

final int de.softpro.doc.SignDocSignatureParameters.rsf_antialias = 0x04 [static]

Flags for rendering the signature (for integer parameter "RenderSignature": use gray levels for antialiasing.

rsf_bw, rsf_gray, and rsf_antialias are mutually exclusive.

See also:

setInteger(), rsf_bw, rsf_gray, rsf_limit_size

final int de.softpro.doc.SignDocSignatureParameters.rsf_bw = 0x01 [static]

Flags for rendering the signature (for integer parameter "RenderSignature": black and white.

rsf_bw, rsf_gray, and rsf_antialias are mutually exclusive.

See also:

setInteger(), rsf_gray, rsf_antialias, rsf_limit_size

final int de.softpro.doc.SignDocSignatureParameters.rsf_gray = 0x02 [static]

Flags for rendering the signature (for integer parameter "RenderSignature": use gray levels computed from pressure.

rsf_bw, rsf_gray, and rsf_antialias are mutually exclusive.

See also:

setInteger(), rsf_bw, rsf_antialias, rsf_limit_size

final int de.softpro.doc.SignDocSignatureParameters.rsf_limit_size = 0x08 [static]

Flags for rendering the signature (for integer parameter "RenderSignature": Limit the size of the rendered signature to the size of the captured signature.

If this flag is set, the rendered signature won't be magnified. However, it may be shrunk to fit the signature field.

Set this flag only if you are sure that the capture resolution stored in the blob passed to blob parameter "BiometricData" is accurate.

final int de.softpro.doc.SignDocSignatureParameters.rss_pkcs1 = 0 [static]

Signing scheme for RSA signatures: PKCS #1 (RSA v1.5).

Used for integer parameter "RSASignatureScheme".

This signature scheme should be supported by all software that verifies DigSig signatures in PDF documents. However, it is considered obsolete due to security concerns.

final int de.softpro.doc.SignDocSignatureParameters.rss_pss = 1 [static]

Signing scheme for RSA signatures: Probabilistic Signature Scheme (PSS) (RSA v2.0 and v2.1).

Used for integer parameter "RSASignatureScheme".

Improved signature scheme, supposed to be more secure than PKCS #1 However, this signature scheme may not be supported by all software that verifies DigSig signatures in PDF documents. For instance, Adobe Acrobat DC supports RSA-PSS since April 2017 (Windows) and August 2017 (MacOS).

When using a certificate from a Windows certificate store (see integer parameter "SelectCertificate"), the private key must be provided by a CNG Key Storage Provider.

final int de.softpro.doc.SignDocSignatureParameters.rx_always = 0 [static]

Integer parameter "RemoveXFA": Always remove XFA.

Use this value if you intend to call setField() or addField() after signing. Adding the signature will fail if the document prohibits removal of XFA.

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.rx_if_allowed = 1 [static]

Integer parameter "RemoveXFA": Remove XFA if possible.

XFA will be removed unless the document prohibits removal of XFA. addField() and setField() will fail if XFA is still present after signing.

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.rx_never = 2 [static]

Integer parameter "RemoveXFA": Do not remove XFA.

addField() and setField() will fail if XFA is still present after signing.

See also:

setInteger()

final int de.softpro.doc.SignDocSignatureParameters.tg_master = 0 [static]

Text group: master.

One font size is used per group and is chosen such that the text fits horizontally. The maximum font size is specified by length parameter "FontSize". The font size of the slave group cannot be greater than the font size of the master group, that is, long text in the slave group won't reduce the font size of the master group.

There must be at least one master text item if there is a slave text item.

See also:

addTextItem(), addTextItem2(), setLength(), tg_slave

final int de.softpro.doc.SignDocSignatureParameters.tg_slave = 1 [static]

Text group: slave.

One font size is used per group and is chosen such that the text fits horizontally. The maximum font size is specified by length parameter "FontSize". The font size of the slave group cannot be greater than the font size of the master group, that is, long text in the slave group won't reduce the font size of the master group.

See also:

addTextItem(), addTextItem2(), setLength(), tg_master

final int de.softpro.doc.SignDocSignatureParameters.ti_adviser = 3 [static]

Select a string for the appearance stream of PDF documents: String parameter "Adviser".

See also:

addTextItem(), addTextItem2(), setString(), ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_comment = 2 [static]

Select a string for the appearance stream of PDF documents: String parameter "Comment".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_contact_info = 4 [static]

Select a string for the appearance stream of PDF documents: String parameter "ContactInfo".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_location = 5 [static]

Select a string for the appearance stream of PDF documents: String parameter "Location".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_reason = 6 [static]

Select a string for the appearance stream of PDF documents: String parameter "Reason".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_sign_time = 1 [static]

Select a string for the appearance stream of PDF documents: String parameter "SignTime".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_signer = 0 [static]

Select a string for the appearance stream of PDF documents: String parameter "Signer".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text1 = 7 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text1".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text2, ti_text3, ti_text4, ti_text5, ti_text6, ti_text7, ti_text8, ti_text9

final int de.softpro.doc.SignDocSignatureParameters.ti_text2 = 8 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text2".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text3 = 9 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text3".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text4 = 10 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text4".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text5 = 11 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text5".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text6 = 12 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text6".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text7 = 13 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text7".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text8 = 14 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text8".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.ti_text9 = 15 [static]

Select a string for the appearance stream of PDF documents: String parameter "Text9".

See also:

addTextItem(), addTextItem2(), setString(), ti_adviser, ti_comment, ti_contact_info, ti_location, ti_reason, ti_sign_time, ti_signer, ti_text1

final int de.softpro.doc.SignDocSignatureParameters.tid_default_ltr = 0x4000 [static]

Paragraph direction: Choose direction automatically, default to LTR.

The base direction of each paragraph (BiDi paragraph level) will depend on the first strong directional character in the paragraph.

The paragraph level will be 0 (LTR) for paragraphs having no strong directional character.

See also:

addTextItem2(), setTextItemDirection()

final int de.softpro.doc.SignDocSignatureParameters.tid_default_rtl = 0x8000 [static]

Paragraph direction: Choose direction automatically, default to RTL.

The base direction of each paragraph (BiDi paragraph level) will depend on the first strong directional character in the paragraph.

The paragraph level will be 1 (RTL) for paragraphs having no strong directional character.

See also:

addTextItem2(), setTextItemDirection()

final int de.softpro.doc.SignDocSignatureParameters.tid_ltr = 0x1000 [static]

Paragraph direction: LTR.

See also:

addTextItem2(), setTextItemDirection()

final int de.softpro.doc.SignDocSignatureParameters.tid_rtl = 0x2000 [static]

Paragraph direction: RTL.

See also:

addTextItem2(), setTextItemDirection()

final int de.softpro.doc.SignDocSignatureParameters.tp_above = 4 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put above the image.

See also:

setInteger(), tp_below, tp_left_of, tp_overlay, tp_right_of, tp_underlay

final int de.softpro.doc.SignDocSignatureParameters.tp_below = 1 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put below the image.

See also:

setInteger(), tp_above, tp_left_of, tp_overlay, tp_right_of, tp_underlay

final int de.softpro.doc.SignDocSignatureParameters.tp_left_of = 5 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put on the left of the image.

See also:

setInteger(), tp_above, tp_below, tp_overlay, tp_right_of, tp_underlay

final int de.softpro.doc.SignDocSignatureParameters.tp_overlay = 0 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text and image are independent and overlap (text is painted on image).

See also:

setInteger(), tp_above, tp_below, tp_left_of, tp_right_of, tp_underlay

final int de.softpro.doc.SignDocSignatureParameters.tp_right_of = 3 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text is put on the right of the image.

See also:

setInteger(), tp_above, tp_below, tp_left_of, tp_overlay, tp_underlay

final int de.softpro.doc.SignDocSignatureParameters.tp_underlay = 2 [static]

Position of the text block w.r.t. to the image (for integer parameter "TextPosition": Text and image are independent and overlap (image is painted on text).

See also:

setInteger(), tp_above, tp_below, tp_left_of, tp_overlay, tp_right_of

final int de.softpro.doc.SignDocSignatureParameters.tsha_default = 0 [static]

Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): default value.

For signatures, use the same hash algorithm as used for the document hash. For document time stamps, use SHA-256 (if supported by the time stamp server) or SHA-1 (if SHA-256 is not supported by the time stamp server).

The hash algorithm requested for the document hash will be used for the time stamp even if the document hash falls back to SHA-1 (see dha_default). SHA-256 will be used if the document hash is SHA-224. SHA-256 will be used if integer parameter DetachedHashAlgorithm is dha_default and the document hash is SHA-384 or SHA-512 (this can happen for keys using certain elliptic curves).

See also:

setInteger(), tsha_sha1, tsha_sha256, tsha_sha384, tsha_sha512

final int de.softpro.doc.SignDocSignatureParameters.tsha_sha1 = 1 [static]

Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-1.

See also:

setInteger(), tsha_default, tsha_sha256, tsha_sha384, tsha_sha512

final int de.softpro.doc.SignDocSignatureParameters.tsha_sha256 = 2 [static]

Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-256.

tsha_sha256 is supported under Linux, iOS, Android, and under Windows XP SP3 and later.

See also:

setInteger(), tsha_default, tsha_sha1, tsha_sha384, tsha_sha512

final int de.softpro.doc.SignDocSignatureParameters.tsha_sha384 = 3 [static]

Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-384.

tsha_sha384 is supported under Linux, iOS, Android, and under Windows XP SP3 and later.

See also:

setInteger(), tsha_default, tsha_sha1, tsha_sha256, tsha_sha512

final int de.softpro.doc.SignDocSignatureParameters.tsha_sha512 = 4 [static]

Hash algorithm to be used for RFC 3161 timestamps (for integer parameter "TimeStampHashAlgorithm"): SHA-512.

tsha_sha512 is supported under Linux, iOS, Android, and under Windows XP SP3 and later.

See also:

setInteger(), tsha_default, tsha_sha1, tsha_sha256, tsha_sha384

final int de.softpro.doc.SignDocSignatureParameters.va_bottom = 2 [static]

Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Align bottom.

See also:

setInteger(), va_center, va_top

final int de.softpro.doc.SignDocSignatureParameters.va_center = 1 [static]

Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Center.

See also:

setInteger(), va_bottom, va_top

final int de.softpro.doc.SignDocSignatureParameters.va_top = 0 [static]

Vertical alignment (for integer parameters "ImageVAlignment" and "TextVAlignment": Align top.

See also:

setInteger(), va_bottom, va_center

final int de.softpro.doc.SignDocSignatureParameters.vt_abs = 0 [static]

Indicate how measurements are specified: aValue is the value to be used (units of document coordinates).

See also:

setLength(), vt_field_height, vt_field_width

final int de.softpro.doc.SignDocSignatureParameters.vt_field_height = 1 [static]

Indicate how measurements are specified: Multiply aValue by the field height.

See also:

setLength(), vt_abs, vt_field_width

final int de.softpro.doc.SignDocSignatureParameters.vt_field_width = 2 [static]

Indicate how measurements are specified: Multiply aValue by the field width.

See also:

setLength(), vt_abs, vt_field_height

---

The documentation for this class was generated from the following file:

• de/softpro/doc/SignDocSignatureParameters.java