Appearance
Options
TestingMode
Set to true
to avoid transaction charges (for those license types that have transactions charges). This will result in a TEST DOCUMENT
banner printed in each PDF document and Test document only - not for general use
printed under each signature in HTML documents.
PDFSignaturePromptFontSize
May be set to a font size from 8
to 36
points. If missing or 0 then it will default to 10
points. This value controls the font size in the signature prompt for PDF documents. The signature prompt is typically the yellow highlighted Click Here to Sign
text displayed to users.
DeleteFailedTransactionFiles
If a transaction has failed (i.e. status is Closed(7), Cancelled(8), or Expired(9), then the transaction directories and files will be deleted. This conserves file space.
NOTE
The AlphaTrust® e-Sign database information for the transaction is never deleted, just the document files and their associated directories.
DeleteFailedTransactionFilesWaitInDays
Number of days to wait before deleting failed transaction files if DeleteFailedTransactionFiles
is true
. The minimum is 1
day. The default is 7
days.
AddSignatureDateTime
true
Add signature date/time to signature block (default)false
Do not.
Only meaningful for HTML documents.
EncryptingFileSystem
false
Is not using Windows EFS in the data storestrue
Is using EFS.
UserForcePasswordChangeInDays
A values from 1
to 365
means force a User password change after that number of days, otherwise do not force a User password change.
ClientIPHeaderName
AlphaTrust® e-Sign records the client IP address at the time of signing. There are special cases when using firewalls, load balancers, etc. where such intermediary devices will alter or remove the client IP address. In some cases the true client IP address will be added by such devices to a custom HTTP header value that is then passed on to AlphaTrust® e-Sign. This value is normally set to "X-Forwarded-For"
If you have configured your intermediary device to add the true client IP address to a different custom HTTP header, you must set that custom HTTP header value here. For example, if your custom HTTP header name is X-Forwarded-for
, then you would set:
ClientIPHeaderName="X-Forwarded-for"
All requests will then use the IP address passed in this custom header, rather than the IP address reported by IIS.
DeletePageImageFilesOnDocCompletion
true
delete the PNG files AlphaTrust® e-Sign uses for the PDF "PageImage" user interface after the document is complete (status=4). This saves disk space as these files are not needed after document completion. Please note: there will be a 3-4 day delay; the cleanup runs daily at the time specified at SystemUpdateTime, but the PNG files will only be deleted for transactions completed at least 3 days (72 hours) before the cleanup.false
do not delete the PNG files.
DefaultDocumentSessionMinutes
The number of minutes to allow a document session to live. This is a timeout value (default is 30 minutes). If a user starts a document session (signing, review, delivery, etc.) the timeout value will be checked at several steps in the process. If the user's session has expired then the user may need to re-authentication or may be returned to the caller. Valid values are 1
to 10800
.
WatermarkType
A value from 0
to 4
specifying whether and what type of watermark is stamped on PDF pages when retrieving them.
0
means do not watermark1
means print the watermark diagonally,2
means print the watermark across the top3
means print the watermark across the bottom4
means print the watermark across both the top and bottom.
This setting and the "Text" settings below do not affect the document-specific watermarking requested on any specific transaction.
WatermarkTextOriginal
Text to watermark when retrieving 'original' documents - documents as submitted to AlphaTrust® e-Sign.
WatermarkTextCancelled
Text to watermark when retrieving a document that was cancelled.
WatermarkTextExpired
Text to watermark when retrieving a document that expired before processing was complete.
WatermarkTextCopy
Text to watermark when a "copy" is specifically requested.
WatermarkTextVoid
Text to watermark when retrieving a document that was voided.
QueuedActionRetry
Minutes to wait to retry a failed Queued Action Item (usually a Document or Signature 'POST' action) before retrying the action. Default = 5
. Valid range 1
to 1440
.
QueuedActionLimit
Limit in minutes to continue to retry a failed Queued Action Item before recording the action as failed. Default = 4320
(3 days). Valid Range QueuedActionRetry
value to 52596000
(100 years).
QueuedActionsResponseTimeoutInSeconds
The number of seconds to wait for a response to a queued action request. This is a timeout value (default is 10 seconds). If a post to an URL exceeds the timeout value, the post will fail, and the Queued Action will be attempted again or expired based on the number of retries allowed (QueuedActionLimit and QueuedActionRetry).
DefaultMinimumFontSizePDF
Minimum font size in points. This value is used for the auto-fitting of signature block data in PDF documents where Autofit
is requested and a MinFontSize
is not specified in the request for that item. Valid values are 2
to 12
. Default = 8
.
RequireCookiesOptInPermission
true
to prompt users to opt-in for the use of cookies with this application.
IsSaaS
true
indicates applications are running in a SaaS environment (allow external user groups).false
indicates on-premise (internal user groups only)
MaximumFileUploadSizeInMegabytes
Specifies the maximum size for an uploaded file in megabytes. Default = 50
.
MaximumApiPayloadInMegabytes
Specifies the maximum upload payload in megabytes (sum of all file sizes). Default = 100
.
PasswordMinimumLength
Defines the minimum length of a password. Valid values are greater than or equal to 8
. Default = 12
.
PasswordMaximumLength
Defines the maximum length of a password. Valid values are less than or equal to 64
. Default = 64
.
UseSignatureChrome
true
enables the use of signature chrome in documents. Available placeholders include:
{{DocumentID}}
{{TaskID}}
{{ParticipantID}}
{{TransactionID}}
{{SignerName}}
{{Date}}
{{IpAddress}}
(coming soon...)
SignatureChromeHeader
Default: Signed By
You can include any text you wish here along with the placeholders listed above but there would be size limitations based on how it looks in your document.
SignatureChromeFooter
Default: {{ParticipantID}}-{{TaskID}}
You can include any text you wish here along with the placeholders listed above but there would be size limitations based on how it looks in your document.
MinimumDocumentRetentionDays
Sets the minimum number of days for document retention. Default value: 0
.
MaximumDocumentRetentionDays
Sets the maximum number of days for document retention. Default value: ""
(blank). If left blank, documents are kept indefinitely.
DefaultDocumentRetentionDays
Specifies the initial value for a group's Document Retention Value in Days. Default value is not set.
CleanUpCompletedTransactionSourceFiles
Setting to true
enables cleanup to delete all Transaction Source.pdf
files for completed transactions.
CleanUpCompletedTransactionVersionFiles
Setting to true
enables cleanup to delete all Transaction <DocumentID>_v#.pdf
files for completed transactions.
CleanUpCompletedTransactionDocumentIDFiles
Setting to true
enables cleanup to delete all Transaction <DocumentID>.pdf
files for completed transactions if (and only if) you are using an HSM to seal documents which generates a <DocumentID>_Final.pdf
file. Otherwise, these <DocumentID>.pdf
files will never delete.