User GuideReference ManualIntegration Scenarios
 

2.2.7. Signing an Outgoing Message

See: Managing Channels - Message Edit Functions

You can add a digital signature, proving its integrity and origin, to an outgoing message for secure transaction.

You can securely sign and send any output file. To do this, your output file is attached to a pdf file that is then securely signed. Of course, if your output file is already a pdf file, the signature will be directly added to the file without attaching it to a new pdf file.

Babelway allows many options are to create and sign the "surrounding" pdf. You can use an existing PDF or even a template in Xhtml with images and css. You can use you company usual letterhead.

To process an output file in order to sign it you should add the properties described hereunder as new properties in the Advanced Properties of your Message Out definition.

Advanced properties of the Message Out definition

Figure 2.27. Advanced properties of the Message Out definition


Enter the value in the Property name field and its value in the Value field as illustrated in the above figure. Click on the   Add command to validate this property or on the   Remove command to erase it.

The properties that should be added to attach your file to a signed pdf are:

pdfWrapped

[true|false] Select true to attach (wrap) your message in a pdf file, false otherwise. Ignored if your message is already a pdf. This option used alone creates a very basic template and do not add signature to the PDF. (OPTIONAL)

pdfSigned

[true|false] Select true to sign the pdf file, false otherwise. This property imply pdfWrapped. (OPTIONAL)

pdfTemplate

This FileProperty contains the template for the PDF. The template could be an Xhtml file or a PDF. If it is an Xhtml, you can add image and css as file properties and refer to them as directly relative URL. Note that if you are using Xhtml you can use the standard metadata mechanism to include dynamic information see metadata section. (OPTIONAL)

pdfLetterHead

This FileProperty contains a letterhead in PDF. The letterhead is added to the background of your PDF. Note that the size of the page should match with the size of the pdfTemplate. (OPTIONAL)

pdfAppendix

This FileProperty contains a appendix in PDF. The appendix is added at the end of your PDF. (OPTIONAL)

pdfSignatureReason

Add a Reason text to the signature. This information is displayed at the bottom of the signature and in the "Signature Panel" of Acrobat reader. (OPTIONAL)

pdfShowSignature

[true|false] Display a signature "logo" on the bottom right of the created PDF file. Regardless of this property, signature information visible in the "Signature Panel" of Acrobat reader. Possible values are: true or false. (OPTIONAL, default is false)

pdfSignatureLowerLeftX

Lower left horizontal position of the signature "logo". (OPTIONAL, default is 450)

pdfSignatureLowerLeftY

Lower left vertical position of the signature "logo". (OPTIONAL, default is 300)

pdfSignatureUpperRightX

Upper right horizontal position of the signature "logo". (OPTIONAL, default is 550)

pdfSignatureUpperRightY

Upper right vertical position of the signature "logo". (OPTIONAL, default is 400)

pdfResize

[true|false] Enable the resize of the PDF. Note that the resize has no effect on the letterHead and the appendix. (OPTIONAL, default is false)

pdfPageSize

If pdfResize is enable, set the PDF size, for instance: A4, A3, LETTER... (OPTIONAL, default is the original PDF size)

pdfOffSetX

If pdfResize is enable, set the horizontal offset for the document. This is useful when cropping a document made for professional printing. (OPTIONAL, default is 0)

pdfOffSetY

If pdfResize is enable, set the vertical offset for the document. This is useful when cropping a document made for professional printing. (OPTIONAL, default is 0)

pdfPositionX

If pdfResize is enable, set the horizontal position of the lower left corner of for the document. (OPTIONAL, default is -pdfOffSetX)

pdfPositionY

If pdfResize is enable, set the vertical position of the lower left corner of for the document. (OPTIONAL, default is -pdfOffSetY)

pdfScaleX

If pdfResize is enable, set the horizontal scaling to apply to the document. (OPTIONAL, default is 1)

pdfScaleY

If pdfResize is enable, set the vertical scaling to apply to the document. (OPTIONAL, default is )

messageFileName

Select the name of the attachment in the PDF containing the message out. Note that the extension of the name will influence Adobe Acrobat behaviour when opening the attachment. (OPTIONAL, default is attachment.bin)

messageFileDescription

Select the description of the attachment in the PDF containing the message out. This description is visible in the file attachment section of Acrobat reader. (OPTIONAL, default is "signed message")

metadataName

In addition of the message itself, you have the possibility to add the content of metadata as a file attachment withing the PDF. This property controls the name of the metadata to export in the PDF. (OPTIONAL)

metadataFileName

Select the name of the attachment in the PDF containing this metadata (OPTIONAL, default is the same name as metadataName )

metadataFileDescription

Select the description of the attachment in the PDF containing the metadata. This description is visible in the file attachment section of Acrobat reader. (OPTIONAL)

metadataFileEncoding

Select the encoding for the metadata added as an attachment. (OPTIONAL)

pdfKeyAlias

Select the private key to be used (This is valid only if you have a custom keystore. Call support if you are otherwise interested).