Aloaha Commandline Signer (ACS)

The Aloaha Commandline Singer is a CLI application which is based on the Aloaha PDF SDK. It supports a broad range of document formats such as PDF, EML, etc. For easy integration into existing environments it supports a broad range of command line parameters and also STDIN, STDOUT and STDERR.

The Aloaha Commandline Signer is not available as free download and has to be requested by email from info@aloaha.com

Requirements:

1. Aloaha Enterprise License required
2. Aloaha PDF Suite, Aloaha PDF SDK or Aloaha Multisignator installed

Usage:

ACS is part of the Aloaha Multisignator Service Signer. More usage Samples can be found here.

-info
Lists card reader and certificates.

-c:<address>
This command reads the given certificate. The syntax is reader.certtype. For example cls.exe -c:0.1 to read Auth Certificate of Reader 0

-s:<filepath> (optional)
With the parameter -s the inputdata will be saved as it was received from Aloaha to the specified filepath. Ideal for debugging!

-i:<filepath> (optional)
The -i parameter specifies the input file. Instead of using the -i parameter the data can be simply piped (stdin) into the CLS.

-o:<filepath> (optional)
The -o parameter specifies the output file. If not specified the output will go to stdout.

-interactive (optional)
Instructs Aloaha to show blue popup boxes, etc

-quite (optional)
Instructs Aloaha to ommit blue popup boxes, etc

-u:<CertName>
Defines the Certificate to be used.
If Certname has is only one letter it can be only in the range of 0-9 and specifies that Aloaha should use the qualified Certificate of that cardreader
If Certname looks like aloaha_<Certificate Fingerprint> Aloaha will find automatically the correct reader.

-p:<PIN> (optional)
The PIN specified by -p will be used for the digital signature

-pin:<CertID>:<PIN>
The PIN will be cached in memory. If you ommit the PIN (-p:<CertID>) the cache will be cleared. If you call -p:<CertID>:check Aloaha will check if the PIN is cached.

-unlock:<CertID>
Forces unlocking of Certificate

-px1, -py1, -px2, -py2 (optional)
Those parameter specify the position of the signature on the PDF.

-location:<Location> (optional)
Specifies the location attribute in the PDF signature.

-reason:<reason> (optional)
Specifies the reason attribute in the PDF signature.

-image:<imagepath> (optional)
Defines the image to be used for the PDF signature.

-sigcontent:<content string> (optional)
Specifies the Text to be used for the signature.

-sha2 forces a SHA2 signature (required for SigG compliance) in PDF signatures

-x:<action>
Specifies the action to be take. For example -x:p creates an embedded PDF signature, -x:d creates a detached signature and -x:a creates an attached signature.

-page:<pageno> (optional)
Specifies the pagenumber on which the signature should be placed. If pageno is higher than existing pages than the last page will be used.

-w
Wait factor (milliseconds) for stdin/stdout. Allowed values from 1 to 1000 

-user, -pass
In some cases it is important to run ACS under the credentials of a different user. For example if used as CGI application in a web service. In that case it is important to be able to specify the user to be used. For example ACS.exe -user:test -pass:test123 ......
It should be also noted that in some cases a process does not has access to the card reader. For example if a process runs as service, as web service, etc. In that case you can gain access with specifying the user, pass credentials.



Samples:

acs.exe -info 

acs.exe -user:test -pass:test123 -info

acs.exe -c:0.1 

acs.exe -user:test -pass:test123 -c:0.0

acs.exe -x:p -i:c:\1.pdf -u:aloaha_d64e1d3cd5abdaedb9e2a411cb21c98915c3d99b -o:c:\signed.pdf -px1:10 -px2:30 -py1:80 -py2:70 -reason:I saw the document -location:here -image:c:\sig.jpg -p:123456 

type c:\1.pdf | acs.exe -x:p -u:3 -px1:10 -px2:30 -py1:80 -py2:70 -reason:I saw the document -location:here -image:c:\sig.jpg -p:123456 -page:99999

type c:\1.pdf | acs.exe -x:a -u:aloaha_d64e1d3cd5abdaedb9e2a411cb21c98915c3d99b -p:123456 -w:5 

acs -x:p -u:0 -p:123456 < c:\1.pdf > c:\signed.pdf