Neevia
PDFsign/encrypt
user’s manual
version 3.2
(http://neeviaPDF.com/PDFsign)
ELECTRONIC END USER LICENSE AGREEMENT
For One (1) Computer
This is an End User License Agreement. This is a contract. If you install this software, you must abide by the terms of this agreement. This license is applicable to all software products sold by Neevia Technology. The term software includes upgrades, modified versions or updates. This software is licensed and not sold. Only a personal, non-transferable and nonexclusive right to use the Neevia products is granted to the end user.
The following are definitions that should be noted by the user:
COMPUTER
This is a single computer owned, rented or leased by a single individual or entity on which one or more applications load and execute software in the memory space of that computer. Software is installed on a computer for one or more users. All computers must be licensed to utilize Neevia software.
THIS IS A CONTRACT BETWEEN YOU AND NEEVIA TECHNOLOGY. YOU SHOULD CAREFULLY READ THIS LICENSING AGREEMENT AND MUST ACCEPT ALL THE TERMS AND CONDITIONS BEFORE INSTALLING THIS NEEVIA SOFTWARE. BY INSTALLING THE SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS AND CONDITIONS OF THIS LICENSE. IF YOU DO NOT AGREE TO THE TERMS OF THIS LICENSE, DO NOT INSTALL THE SOFTWARE, AND DO NOT USE THE SOFTWARE. IF YOU VIOLATE THIS AGREEMENT, YOU WILL BE SUBJECT TO LEGAL ACTION BY NEEVIA TECHNOLOGY.
Subject to the payment of applicable license fees, Neevia Technology grants you a nonexclusive right to use its accompanying Neevia software product and related documents (the Software) in the terms and conditions provided as follow:
LICENSE
Until such time as Neevia has issued a valid serial number to you, you may only use this software for a 30-day trial period. You agree to remove any copies of the software after the expiration of the trial period. No license is issued to you until you are issued a valid serial number.
You cannot use a license for the software concurrently on different computers. You may install and use the Software in a single location on a hard disk or other storage device of one computer only.
(a) Home Use:
The primary user of each computer on which the Software is installed or used may also install the Software on one home or portable computer. However another person may not use the Software on a secondary computer at the same time the Software on the primary computer is being used.
(b) Server or Network Use:
You may keep one copy of the Software on a single file server only for the purposes of downloading and installing the Software onto a hard disk of up to the Permitted Number of Computers that are on the same network as the file server. No other network use is permitted.
(c) Operating system or Language versions:
If you receive two or more copies of the Software with different operating systems or language versions, the total aggregate number of computers on which all versions of the Software are used may not exceed the Permitted Number of Computers. You may not rent, lease, sublicense, lend or transfer versions or copies of the Software you do not use, or Software contained on any unused media.
(d) Archiving:
You may make one copy of the Software solely for archival purposes. If the Software is an upgrade, you may use the Software only in conjunction with upgraded product. If you receive your first copy of the Software electronically, and a second copy on media afterward, the second copy can be used for archival purposes only.
For all Neevia Technology products, you agree that you will only use our software on a server and all applications that will access the server will reside on the server and you will not permit remote access to the software except through your application residing on the server. You agree to surrender your license(s) if you violate this agreement. If you violate this agreement, you will not receive a refund upon termination of this license. You agree not to utilize our software to violate the copyright of any third parties. If you do violate the copyright of a third party utilizing our software, you agree to hold Neevia Technology harmless and will indemnify Neevia Technology for any such activity even if the violation is unintentional.
COPYRIGHT
The Software is owned by Neevia Technology and/or its suppliers, and is protected by the copyright and trademark laws of the United States and related applicable laws. You may not copy the Software except as set forth in the "License" section. Any copies that you are permitted to make pursuant to this Agreement must contain the same copyright and other proprietary notices that appear on or in the Software.
You may not rent, lease, sub-license, transfer, or sell the Software. You may not modify, translate, reverse engineer, decompile, disassemble, or create derivative works based on the Software, except to the extent applicable law expressly prohibits such foregoing restriction. You may use the trademarks to identify the Software owner's name, or to identify printed output produced by the Software. Such use of any trademark does not give you any rights of ownership in that trademark.
NO WARRANTY LICENSED SOFTWARE (S) - "AS IS"
The Software is provided AS IS. NEEVIA TECHNOLOGY AND ITS SUPPLIERS MAKE NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE MERCHANTABILITY, QUALITY, NONINFRINGEMENT OF THIRD PARTY RIGHTS, FITNESS FOR A PARTICULAR PURPOSE, AND THOSE ARISING BY STATUTE OR OTHERWISE IN LAW OR FROM A COURSE OF DEALING OR USAGE OF TRADE. THE ENTIRE RISK AS TO THE QUALITY, RESULTS BY USING THE SOFTWARE, AND PERFORMANCE OF THE SOFTWARE IS WITH THE END USER. Some states or jurisdictions do not allow the exclusion or limitation of incidental, consequential or special damages, or the exclusion of implied warranties or limitations on how long an implied warranty may last, so the above limitations may not apply to you or your company.
LIMITATION OF REMEDIES AND LIABILITY
NEEVIA TECHNOLOGY OR ITS SUPPLIERS OR RESELLERS SHALL NOT UNDER ANY CIRCUMSTANCE BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST SAVINGS, OR FOR ANY CLAIM BY A THIRD PARTY, ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF NEEVIA TECHNOLOLGY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
GENERAL
This Agreement shall be construed, interpreted, and governed by the laws of the State of Florida, excluding the application of its conflicts of law rules. The United Nations Convention on Contracts of the International Sale of Goods, will not govern this Agreement. If any part of this Agreement is found void and unenforceable, it will not affect the validity of the rest of the Agreement, which shall remain valid and enforceable according to its terms.
If you need to redistribute this product with your own software products, you need to contact Neevia and negotiate a separate licensing and royalty agreement.
You may not ship, transfer, or export the Software into any country or used in any manner prohibited by any export laws, restrictions or regulations.
UPGRADES
You must be properly licensed to install upgrades to Neevia Software products. Neevia upgrades replace and or supplement the previous product that formed the basis for your eligibility to for the upgrade. You may use the upgrade only in accordance with the terms of this Agreement. Upgrades may not be separated and used on separate computers.
GOVERNEMENT USERS
For United States government users, the Software and associated Documentation are deemed to be "commercial computer software" and "commercial computer documentation", respectively pursuant to DFAR 227.7202 and FAR 12.212(b) as applicable.
ENTIRE AGREEMENT
You acknowledge that you have read this Agreement, understand it and agree to be bounded by its terms and conditions. It is the complete and exclusive statement of the Agreement between us, which supersedes any proposal or prior agreement, oral or written, and other communication between us relating to the subject matter of this Agreement.
CONTACT INFORMATION
neeviaPDF.com
103 NE 4th Street
Fort Lauderdale, Florida 33301
Tel: (954) 893.9343
Email: info@neeviaPDF.com
Web: http://neeviaPDF.com
Installing and Uninstalling Neevia PDFsign/encrypt8
PDFsign/encrypt command line interface (CLsign.exe)10
Using the COM interface to sign/encrypt PDF files14
Using the .NET assembly to sign/encrypt PDF files14
PDF Encryption related properties
PDF Initial View & Metadata related properties
Using the graphic interface to sign PDF files25
Using the graphic interface to encrypt PDF files34
Example 1vb. Sign a PDF file with an invisible signature (Visual Basic)
Example 1delphi. Sign a PDF file with an invisible signature (Delphi)
Example 2vb. Sign and timestamp a PDF file (Visual Basic)
Example 2delphi. Sign and timestamp a PDF file (Delphi)
Neevia PDFsign/encrypt is a software tool that can be used to digitally sign and/or encrypt PDF files.
The main purpose of a digital signature is to uniquely identify the signer of a PDF document and guarantee the integrity of the content.
A digital signature is defined as a data structure associated with a document or other set of data that uniquely identifies the person or organization that is signing, or authorizing the contents of the data and ensures the integrity of the signed data.
PDFsign comes as a command line tool, a graphic interface application, COM object and .NET assembly. Supported platforms are: Windows 2000/XP/2003/Vista.
With Neevia PDFsign/encrypt you can:
· Time-stamp PDF file(s).
· Linearize (optimize for Fast Web View) output PDF.
· Set document information (Title, Author, etc).
Before installing and/or using this product, please make sure you have carefully read the copyright notice and agreed to all of its terms. If you have any questions about the licensing agreement, feel free to call (954) 981.9252 or send an email to sales@neeviaPDF.com.
To install Neevia PDFsign/encrypt:
download and save the http://neeviaPDF.com/prods/PDFsign_setup.exe file onto your hard drive. After downloading the file, double-click on it and follow the instructions. The installation procedure automatically detects your operating system, copies the needed files into your system directory and installs Neevia PDFsign/encrypt.
Unattended installation:
To perform an unattended (silent) installation launch the PDFsign/encrypt installer with /sp /very silent /norestart command line switches. Here is the full list of supported switches:
/SP
Disables the "This will install... Do you wish to continue?" prompt at the beginning of Setup.
/SILENT, /VERYSILENT
Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are not displayed but the installation progress window is. When Setup is very silent the installation progress window is not displayed. Everything else is normal so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with '/SP-' command line option explained above). If a restart is necessary and the '/NORESTART' command is not used (see below) and Setup is silent, it will display a “Reboot now?” dialog. If it's very silent it will reboot without asking.
/NOCANCEL
Prevents the user from canceling during the installation
process, by
disabling the Cancel button and ignoring clicks on the close button.
Useful along with /SILENT.
/NORESTART
Instructs Setup not to reboot even if it's necessary.
/DIR="x:\dirname"
Overrides the default directory name displayed on the Select Destination Directory wizard page. A fully qualified pathname must be specified.
/GROUP="folder name"
Overrides the default folder name displayed on the Select
Start Menu Folder
wizard page.
/user="username", /company="company name", /serial="serial number"
Use these switches to pass the registration info (username, company name and serial number) to the installer.
To remove Neevia PDFsign/encrypt from your computer:
1. Select Settings -> Control Panel from the Start menu.
2. In the Control Panel click Add/Remove programs and select Neevia PDFsign/encrypt from the applications list.
3. Click the Add/Remove button to remove the program. A confirmation prompt is displayed.
Unattended uninstall:
To perform an unattended (silent) uninstall, launch unins000.exe from the folder where the application has been installed with /verysilent /norestart command line switches. Here is the full list of supported switches:
/SILENT, /VERYSILENT
When specified, the uninstaller will not ask the user for startup confirmation or display a message stating that uninstall is complete. Shared files that are no longer in use are deleted automatically without prompting. Any critical error messages will still be shown on the screen. When '/VERYSILENT' is specified, the uninstall progress window is not displayed. If a restart is necessary and the '/NORESTART' command isn't used (see below) and '/VERYSILENT' is specified, the uninstaller will reboot without asking.
/NORESTART
Instructs the uninstaller not to reboot even if it's necessary.
How to register Neevia PDFsign/encrypt.
After you downloaded the product run the installer and at the end of the process enter your registration info. If you do not have a serial number and simply want to test the product select Evaluate Product then click Finish. To register via the graphic interface run PDFsign.exe click About -> Register -> copy and paste your licensing info.
Usage: CLsign.exe <inputfile> <outputfile> [options]
<inputfile> PDF file to sign/encrypt
<outputfile> Output PDF file
-u <password> Open password to input PDF file
-lin Linearize (Optimize for Fast Web View) output PDF file
-certsubject <subject> Locate and load certificate by subject
-certfile <file> Load cerfificate from specified file
-certpwd <pwd> Master password to the certificate
-replacesign <name> Replace existing signature in PDF file
-location <value> Your location information
-reason <value> Reason for signing this document
-contactinfo <value> Your contact information
-signpage <page> Page to place signature on
(use 0 to place signature on the last page)
-invisible Applies a signature that is not displayed in the output PDF - it is only viewable in document’s signature pane;
Example:
CLsign.exe c:\in.pdf c:\out.pdf -certfile c:\cert.pfx -certpwd passwd -invisible
-x <value> Where on the X axis to place signature
-y <value> Where on the Y axis to place signature
-width <value> Width of rectangle containing signature
-height <value> Height of rectangle containing signature
-units <value> Measurement units to use for -x, -y, -width, -height parameters
Possible values:
1 inches
2 centimeters
3 millimeters
4 points (Default)
-certify Certify document
-certifyperms <val> Specify the types of changes that are permitted for the document to remain certified. Possible values:
0 - Disallow any changes to the document;
1 - Only allow form fields fill-in;
2 - Only allow commenting and form fields fill-in;
-timestamp Time stamp signature
-timeserverurl <url> Time server address (time server has to be TS RFC-3161 compatible)
-timeserveruser <val> Time server user name (if time server requires authentication)
-timeserverpwd <val> Time server password (if time server requires authentication)
-viewtype Specifies what to display in the signature’s graphic box
0 - no image; 1 - show signer’s name; 2 - show image from file;
-signimage <value> Image file to associate with signature (when -viewtype 2)
-textboxpos Text box position in signature field. Possible values:
0 - text box on the left;
1 - text box on the right (default);
-textcolor Text color in signature field (web format)
-hidename Hides certificate name in signature field
-hidelabels Hides field labels
-hidelocation Hides location info in signature field
-hidereason Hides reason for signing in signature field
-hidedate Hides signature date in signature field
-hidedistname Hides distinguished name in signature field
-customtext <value> Adds custom text to signature field
Encryption settings
-owner <value> Owner password to use for encrypting output PDF file
-user <value> User password to use for encrypting output PDF file
-rc4 Uses 128 bits RC4 encryption for encrypting output file
-aes Uses 128 bits AES encryption for encrypting output file
-nometa Does not encrypt PDF Metadata
-perms <value> PDF security permissions to use for encrypting output file
flags:
p - document printing is denied
c - changing the document is denied
s - selection and copying of text and graphics is denied
a - adding or changing annotations or form fields is denied
The following flags are defined for 128 bits encryption:
i - disables editing of form fields
e - disables extraction of text and graphics
d - disables document assembly
q - disables high quality printing
Example:
CLsign.exe c:\in.pdf c:\out.pdf -owner test -aes -perms pcs
Document Info settings
-title <value> Sets output PDF file title to <value>
-author <value> Sets output PDF file author to <value>
-creator <value> Sets output PDF file creator to <value>
-subject <value> Sets output PDF file subject to <value>
-keywords <value> Sets output PDF file keywords to <value>
Example:
CLsign.exe c:\in.pdf c:\out.pdf -title "Daily Report"
-openmagn <value> Sets open magnification (in %) for output PDF file
-openpage <value> Sets open page for output PDF file
Example:
CLsign.exe c:\in.pdf c:\out.pdf -openmagn 50 -openpage 1
-pm <value> Specifies how output file should be displayed when opened in PDF viewer.
Possible values:
0 - Default view
1 - Page only
2 - Outlines (bookmarks) visible
3 - Thumbnail images visible
4 - Optional content group panel visible
5 - Attachments panel visible
6 - Full screen mode
-pl <value> Specifies page layout to use when output file is opened in PDF viewer.
Possible values:
1 - Displays one page at a time (default)
2 - Displays the pages in one column
3 - Displays the pages in two columns, with odd numbered pages on the left
4 - Displays the pages in two columns, with odd numbered pages on the right
5 - Displays the pages two at a time, with odd numbered pages on the left
6 - Displays the pages two at a time, with odd numbered pages on the right
Example:
CLsign.exe c:\in.pdf c:\out.pdf -pm 2 -pl 1
-hidemenubar Specifies if PDF viewer should hide menu bar when output file is displayed
-hidetoolbar Specifies if PDF viewer should hide toolbar when output file is displayed
-hidewindowui Specifies if PDF viewer should hide user interface elements when output file is displayed
-fitwindow Specifies if PDF viewer should resize the document's window to fit the size of the first displayed page
-centerwindow Specifies if PDF viewer should position the document's window in the center of the screen
Example:
CLsign.exe c:\in.pdf c:\out.pdf -hidetoolbar -hidemenubar
Class ID
Neevia.PDFsign
Example:
Visual Basic: Set NVsign = CreateObject("Neevia.PDFsign")
Delphi: NVsign := CreateOLEObject("Neevia.PDFsign")
To use the PDFsign .NET interface for signing PDF files, in Visual Studio go Project -> Add Reference ->.NET and select PDFsignNET from the list. After this:
Visual Basic: Dim NVsign As New Neevia.PDFsign
Visual C#: Neevia.PDFsign NVsign = new Neevia.PDFsign();
Returns the PDFsign version.
Syntax
value = NVsign.version
Data Type: String
Specifies whether the output PDF file should be linearized (Optimized for fast Web View).
Possible values: true, false (Default value: false)
Syntax
NVsign.Linearize = value
Data Type: Boolean
Replaces an existing signature in the PDF file.
Syntax
NVsign.ReplaceSignature = value
Data Type: String
Locates and loads certificate by subject.
Syntax
NVsign.CertificateSubject = value
Data Type: String
Specifies the file to load the certificate from.
Syntax
NVsign.CertificateFile = value
Data Type: String
Master password to the certificate.
Syntax
NVsign.CertificatePassword = value
Data Type: String
Specifies your location info (ex: city name).
Syntax
NVsign.Location = value
Data Type: String
Specifies the reason for signing this document.
Syntax
NVsign.Reason = value
Data Type: String
Specifies your contact info (ex: phone number).
Syntax
NVsign.ContactInfo = value
Data Type: String
Specifies the page to place signature on (use 0 to place signature on last page).
Syntax
NVsign.PlaceOnPage = value
Data Type: Integer
X-coordinate of signature.
Syntax
NVsign.X = value
Data Type: Float
Y-coordinate of signature.
Syntax
NVsign.Y = value
Data Type: Float
Width of the rectangle containing signature.
Syntax
NVsign.Width = value
Data Type: Float
Height of the rectangle containing signature.
Syntax
NVsign.Height = value
Data Type: Float
Measurement units to use for X, Y, Width and Height parameters.
Possible values: 1 - inches, 2 - centimeters, 3 - millimeters, 4 - points (default)
Syntax
NVsign.Units = value
Data Type: Integer
Specifies whether to certify the output PDF file.
Possible values: true, false (Default value: false)
Syntax
NVsign.Certify = value
Data Type: Boolean
Specifies the types of changes that are permitted for the document to remain certified.
Possible values: 0 - Disallow any changes to the document;
1 - Only allow form fields fill-in;
2 - Only allow commenting and form fields fill-in;
Syntax
NVsign.CertifyPermissions = value
Data Type: Integer
Specifies whether to time-stamp the signature.
Possible values: true, false (Default value: false)
Syntax
NVsign.TimeStamp = value
Data Type: Boolean
Specifies the time server url (time server has to be RFC 3161 compatible).
Syntax
NVsign.TimeServerURL = value
Data Type: String
Note: neeviaPDF.com provides a TESTING time-stamping server at http://tsa.neeviaPDF.com/tsa
Time server user name (if time server requires authentication)
Syntax
NVsign.TimeServerUser = value
Data Type: String
Time server password (if time server requires authentication)
Syntax
NVsign.TimeServerPassword = value
Data Type: String
Specifies what to display in the signature’s graphic box.
Possible values: 0 - no graphic, 1 - show signer’s name, 2 - show image from file;
Syntax
NVsign.ViewType = value
Data Type: Integer
Specifies the image file to associate with signature (when ViewType = 2).
Syntax
NVsign.Image = value
Data Type: String
Specifies how to align the text box in signature field.
Possible values: 0 - left, 1 – right (default)
Syntax
NVsign.TextAlign = value
Data Type: Integer
Specifies the Text color in signature field (web format).
Syntax
NVsign.TextColor = value
Data Type: String
Specifies custom text to add to the signature field.
Syntax
NVsign.CustomText = value
Data Type: String
Specifies whether to show location info in signature field.
Possible values: true, false (Default value: true)
Syntax
NVsign.ShowLocation = value
Data Type: Boolean
Specifies whether to show reason for signing in signature field.
Possible values: true, false (Default value: true)
Syntax
NVsign.ShowReason = value
Data Type: Boolean
Specifies whether to show signing date in signature field.
Possible values: true, false (Default value: true)
Syntax
NVsign.ShowDate = value
Data Type: Boolean
Specifies whether to show distinguished name in signature field.
Possible values: true, false (Default value: false)
Syntax
NVsign.ShowDistinguishedName = value
Data Type: Boolean
Specifies whether to show text labels in signature field.
Possible values: true, false (Default value: true)
Syntax
NVsign.ShowLabels = value
Data Type: Boolean
Specifies whether the output PDF file should be encrypted.
Possible values: true, false (Default value: false)
Syntax
NVsign.PDFEncrypt = value
Data Type: Boolean
Specifies whether the metadata in the output PDF file should be encrypted.
Possible values: true, false (Default value: true)
Syntax
NVsign.PDFEncrypt = value
Data Type: Boolean
Note: Will have effect only if PDFEncrypt = true.
Specifies the encryption algorithm
Possible values: "40", (low - 40 bits RC4 encryption - Acrobat 3-and-later compatible)
"rc4", (high - 128 bits RC4 encryption - Acrobat 5-and-later compatible)
"aes". (high - 128 bits AES encryption - Acrobat 6-and-later compatible)
Syntax
NVsign.PDFEncryptionType = value
Data Type: String
Note: Will have effect only if PDFEncrypt = true.
Sets the user password in the output document. Users will be asked to enter this password before Acrobat Reader allows them to view the document.
Syntax
NVsign.PDFUserPassword = value
Data Type: String
Note: Will have effect only if PDFEncrypt = true.
Sets the output document owner password. This option will force the user of the PDF to enter a password before Acrobat Reader allows them to change the user password and security permissions.
Syntax
NVsign.PDFOwnerPassword = value
Data Type: String
Note: Will have effect only if PDFEncrypt = true.