Settings: persistence

The following settings are possible in settings.properties with the prefix "persistence.".

persistence.pathToDocumentConfigFile

Description	The storage location of the statically configured document types.
Possible values	Absolute or relative file path to the configuration file.
Default value	./documentconfig.cfg

persistence.referrerUrl

Settings	This setting specifies the URL to be redirected to if the Back button is clicked in the Viewer. If no URL to go back to is defined, the Back button is not displayed. When the URL is called, two parameters are attached.
Possible values	A valid URL to be redirected to after the application has been closed
	`AUTO`	The URL from the HTTP header (referer) is opened
	`BACK_FUNCTION`	The Viewer uses the browser navigation for the back function.
Default value	`AUTO`

persistence.useDocumentLocking

Description	This setting determines whether a document can be opened by multiple users simultaneously. This function is disabled by default.
Possible values	`true`	An open document cannot be opened a second time.
	`false`	A document is not locked after being opened.
Default value	`false`

persistence.formFieldProtectMode

Settings	This setting controls which form fields are locked or marked as read-only when capturing a signature. This function never locks signature fields and never unlocks form fields that have already been locked. Form or signature fields specified in the ‘signature field lock dictionary’ of a PDF are always locked independently of this function.
Possible values	`ALL`	All form fields (except signature fields) are locked. Use this setting if a form may not be edited after the first signature.
	`FILLED`	All form fields containing a value are locked. Use this setting if data that has already been entered into the form may not be edited, but empty form fields may still be filled out.
	`NONE`	The function is disabled. signoSign/Universal will only refer to the ‘signature field lock dictionary’.
Default value	`ALL`

persistence.signatureFieldAddingAllowed

Settings	This setting defines whether signature fields may be added manually. This function is enabled by default.
Possible values	`true`	Signature fields may be added manually.
	`false`	Signature fields may not be added manually.
Default value	`true`

persistence.signatureBackgroundTransparent

Settings	This value specifies whether the background of the rendered signature image displayed in the document is transparent.
Possible values	`AUTO`	The background is then only transparent if the loaded document is not a PDF/A 1-b.
	`ALWAYS`	The signature is displayed with a transparent background.
	`NEVER`	The signature is displayed with a white background.
Default value	`AUTO`

persistence.signatureTextEnabled

Settings	This setting defines whether the signature text, such as the timestamp (see persistence.signatureText) for example, is to be added into the image of the signature and be visible in the document.
Possible values	`true`	User-defined text is added to rendered signature images.
	`false`	Text is not added to rendered signature images.
Default value	`false`

persistence.signatureText

Settings	This setting can contain any text. This text is then added to the signature field in addition to the signature during the signing process if persistence.signatureTextEnabled is activated. @SIGNTIME and @LOCATION can be added as placeholders that are replaced by real values. If the setting is left empty, a pre-set timestamp is generated in a pre-set format corresponding to the language setting of the calling browser.
Possible values	Any character string with optional placeholders that are replaced by values when capturing a signature.
	`@LOCATION`	Is replaced by position data if the signature was captured on a mobile device using the signoSign/Universal app and position data is enabled.
	`@SIGNTIME`	Is replaced by the current time. The format of the timestamp is specified using the persistence.signatureTextDateTimeFormat setting.
Default value	signtime: @SIGNTIME, location: @LOCATION

persistence.signatureTextDateTimeFormat

Settings	This setting sets the timestamp format that replaces @SIGNTIME in signatureText, if included. The format string must adhere to the rules of Java SimpleDateFormat.
Possible values	`y`	Year
	`M`	Month
	`d`	Day of the month
	`h`	Hour (1–12)
	`H`	Hour (0–23)
	`m`	Minute in hour
	`s`	Seconds
	`S`	Milliseconds
	`z`	Time zone as text
	`Z`	Time difference
Default value	`dd.MM.yyyy HH:mm:ss Z`

persistence.signatureTextHorizontalAlign

Settings	A signature text can be added to every signature field. These settings allow you to define the alignment of the text.
Possible values	`LEFT`	The text is aligned with the left-hand edge of the signature field.
	`CENTER`	The text is aligned horizontally in the centre of the signature field.
	`RIGHT`	The text is aligned with the right-hand edge of the signature field.
Default value	`LEFT`

persistence.signatureTextVerticalAlign

Settings	A signature text can be added to every signature field. These settings allow you to define the alignment of the text.
Possible values	`BOTTOM`	The text is aligned with the bottom edge of the signature field.
	`CENTER`	The text is aligned vertically in the centre of the signature field.
	`TOP`	The text is aligned with the upper edge of the signature field.
Default value	`BOTTOM`

persistence.documentSharing

Settings	This setting defines whether the function for sharing the document is enabled. If this function is disabled, the toolbar button is disabled/greyed out. The visibility of the toolbar button is configured using web.sharingButtonVisibility.
Possible values	`true`	Documents can be shared.
	`false`	Document sharing is disabled.
Default value	`true`

persistence.documentSharingEditablePassword

Settings	This setting defines whether the password of a shared document can be edited before the process is carried out. This function is enabled by default.
Possible values	`true`	A custom password can be set when sharing a document. If the password is left empty in this case, the document can be called without a password.
	`false`	A custom password cannot be set when sharing; the application will generate a random password.
Default value	`true`

persistence.automatedSignStartMode

Settings	This property allows you to specify whether and how the signature capture is automatically started when a document is opened.
Possible values	`NEVER`	The function is disabled, does not start automatically.
	`FIRST_FIELD`	Starts automatically with the first empty signature field.
	`FIRST_MANDATORY_FIELD`	Starts automatically with the first empty mandatory signature field.
	`CELL_PHONE_AUSTRIA`	Starts automatically with ‘mobile phone signature Austria’.
Default value	`NEVER`

persistence.automatedSaveMode

Settings	This property allows you to specify whether and when a document is saved automatically.
Possible values	`NEVER`	The function is disabled. The document is not saved automatically.
	`SIGNATURE_STARTING`	The document is saved before the start of a signature capture.
	`SIGNATURE_FINISHED`	The document is saved after a signature has been captured.
	`ALL_FIELDS_SIGNED`	The document is saved once the last empty signature field has been signed.
	`DOCUMENT_CLOSING`	The document is saved when the document is closed by signoSign/Universal in the Viewer.
Default value	`NEVER`

persistence.allowSignfieldSelection

Settings	This setting defines whether the signature capture for a signature field can be started by clicking on the signature field. If this function is disabled, the signatures can only be captured in the predetermined order by using the ‘Sign’ button.
Possible values	`true`	Direct signing by clicking a signature field is permitted.
	`false`	The signing process can only be started via the signature button in the application. This means signatures can only be carried out in the pre-defined order.
Default value	`true`

persistence.usePadEncryption

Settings	This setting controls whether the captured data of a signature are encrypted in the signotec signature device or in the backend of the web application. This means it only affects signatures captured with signature devices.
Possible values	`NEVER`	The data are always encrypted in the backend of the web application on the server.
	`IFSUPPORTED`	It is automatically detected whether the data can be encrypted in the signature device. If a signature device is not used or the pad does not support encryption, the data are encrypted in the backend of the web application.
	`ALWAYS`	If a signature device is used, the data are always encrypted in the signature device. If the data cannot be encrypted, an error message is displayed to the user and the captured signature is not processed any further. If a signature device is not used, the data are encrypted in the backend of the web application.
Default value	`NEVER`

persistence.allowedAuthenticationMethods

Settings	Setting for specifying the permitted authentication methods.
Possible values	`PASSWORD`	Allows authentication via password.
	`TAN_EMAIL`	Allows authentication via e-mail.
	`TAN_SMS`	Allows authentication via text message.
	`NO_AUTH`	Does not allow any authentication.
Default value	`PASSWORD,TAN_EMAIL,TAN_SMS,NO_AUTH`

If TAN_EMAIL is set, the SMTP settings must be configured.
If TAN_SMS is set, the preferredSmsService must be configured.

persistence.documentSharingRejectable

Settings	Sets whether shared documents can be rejected by the recipients. In the event of a rejection, the recipient must provide a reason, which will be communicated to the sender by e-mail, provided a valid SMTP configuration is available.
Possible values	`true`	Recipients of shared access can reject documents.
	`false`	The option to reject is not available when editing shared access.
Default value	`false`

persistence.documentSharingDeferrable

Settings	Sets whether shared documents can be saved by recipients without completing them. The process is not completed or ended and can be called again at a later time.
Possible values	`true`	Shared accesses can be stored temporarily.
	`false`	Shared accesses cannot be stored temporarily.
Default value	`false`

persistence.mailTemplatesLocation

Settings	Setting to define the directory of the e-mail templates.
Possible values	The absolute path to the e-mail template directory.
Default value	-

Certificates

signoSign/Universal requires both a certificate for the encryption of the signature and a certificate with a private key for signing the document. See also the Certificates section. Encryption in the signature device is controlled using the persistence.usePadEncryption setting.

To encrypt biometric data, signoSign/Universal is supplied with a certificate as standard that is created and managed by a notary. This provides the greatest possible security when dealing with sensitive signature data without you having to deal with key management. In the case of a dispute, the notary can be instructed to decrypt the biometric data. If you would prefer to manage the certificates yourself, please remember to adjust the configuration accordingly before using the system productively. More information is available directly from the signotec sales team. The document is digitally signed with a demo certificate as standard that needs to be replaced by a trusted certificate for productive use. See also the Global certificates section.

persistence.useCertificateDataProperties

Settings	This setting defines whether an encryption certificate and a signature certificate are to be used globally for all users or whether the certificates are loaded from a central keystore.
Possible values	`true`	Global certificates are used. The following settings in this section must also be configured.
	`false`	signoSign/Universal generates sample certificates for each user. The following settings in this section are ignored.
Default value	`true`

persistence.keystoreBiometric

Settings	This setting defines the absolute storage location of the keystore from which the encryption certificate is loaded.
Possible values	Absolute path to the storage location of the keystore.
Default value	`keystoreBiometric.jks`

persistence.biometricKeyStoreType

Settings

This setting defines the type of the keystore as JKS, PKCS12, WINDOWS-MY, and so on. The default value is the JRE standard type JKS or the type defined by the system property keystore.type.

persistence.biometricKeyStorePassword

Settings

This setting defines the password for the keystore. Use an empty value if a password parameter of null must be transferred for the keystore implementation when the KeyStore.load() method is called.

persistence.biometricAlias

Settings

The setting for the alias of the encryption certificate in the keystore.

persistence.keystoreSigning

Settings	This setting defines the absolute or storage location of the keystore from which the signature certificate and the private key are loaded.
Possible values	Absolute path to the storage location of the keystore.
Default value	`keystoreSigning.jks`

persistence.signingKeyStoreType

Settings

This setting defines the type of the keystore as JKS, PKCS12, WINDOWS-MY, and so on. The default value is the JRE standard type JKS or the type defined by the system property keystore.type.

See also keystoreSigning.

Possible values

The character string with which a Java keystore implementation can be instantiated.

Default value

JKS

persistence.signingKeyStorePassword

Settings

This setting defines the password for the keystore. Use an empty value if a password parameter of null must be transferred for the keystore implementation when the KeyStore.load() method is called.

See also keystoreSigning.

Possible values

The password of the keystore defined in keystoreSigning.

Default value

JKS

persistence.signingAlias

Settings

This setting defines the alias of the signature certificate and the private key in the keystore.

See also keystoreSigning.

Possible values

The alias for the signature certificate of the keystore defined in keystoreSigning.

Default value

signingAlias

persistence.signingPrivateKeyPassword

Settings

This setting defines the password for the private key in the keystore. Use an empty value if a password parameter of null must be transferred for the keystore implementation when the KeyStore.load() method is called.

See also keystoreSigning.

Possible values

The password for the private key in the keystore.

Default value

signingPrivateKeyPassword

Passwords

The following settings are available for custom setting of the desired password policy. These are taken into account when passwords are generated by signoSign/Universal or when a user wants to set a password.

persistence.passwords.length

Settings	Setting for specifying the minimum length for entered passwords. Setting the value 0 enables empty passwords. The value also determines the length of the generated password.
Possible values	An integer `>=` 0
Default value	8

persistence.passwords.requireDigit

Settings	The setting specifies whether passwords need to contain numbers.
Possible values	`true`	Passwords must contain at least one number.
	`false`	Passwords are not checked for a number.
Default value	`false`

persistence.passwords.requireUppercase

Settings	The setting specifies whether passwords need to contain upper case letters.
Possible values	`true`	Passwords must contain at least one upper case letter.
	`false`	Passwords are not checked for upper case letters.
Default value	`false`

persistence.passwords.requireLowercase

Settings	The setting specifies whether passwords need to contain lower case letters.
Possible values	`true`	Passwords must contain at least one lower case letter.
	`false`	Passwords are not checked for lower case letters.
Default value	`false`

persistence.passwords.requireSpecial

Settings	The setting specifies whether passwords need to contain special characters. The permitted special characters can be specified with the setting passwords.allowedSpecialCharacters.
Possible values	`true`	Passwords must contain a special character from passwords.allowedSpecialCharacters.
	`false`	Passwords are not checked for special characters.
Default value	`false`

persistence.passwords.allowedSpecialCharacters

Settings

Setting for specifying the permitted special characters.

In addition to the specified special characters, all Latin letters, in upper and lower case, and numbers are always permitted.

Possible values

A string of special characters

Default value

!#$%&@