React and Flask (Python and iText7) based AIS Client

This client is based on JavaScript, React and uses Swisscom All-in Signing Service (AIS) to sign and/or timestamp PDF documents. The client has the same functionalities for PDF files processing as our iText7 client.

Demo Video

or see it on SharePoint:

• https://swisscom-my.sharepoint.com/:v:/r/personal/paul_muntean_swisscom_com/Documents/Aufnahmen/Keycloak%20POC%20Implementation%20Session-20210728_085100-Besprechungsaufzeichnung.mp4?csf=1&web=1&e=JhHzGO

Getting started

To start using the Swisscom AIS service and this client library, do the following:

1. Acquire an iText license
2. Get authentication details to use with the AIS client.
3. Configure the AIS client for your use case
4. Use the AIS client from the command line

Quick examples

The rest of this page provides some quick examples for using the AIS client. Please see the links above for detailed instructions on how to get authentication data, download and configure the AIS client. The following snippets assume that you are already set up.

Command line usage

Get a help listing by calling the client without any parameters:

./bin/ais-client.sh

or

./bin/ais-client.sh -help

Get a default configuration file set in the current folder using the -init parameter:

./bin/ais-client.sh -init

Apply an On Demand signature with Step Up on a local PDF file:

./bin/ais-client.sh -type ondemand-stepup -input local-sample-doc.pdf -output test-sign.pdf

You can also add the following parameters for extra help:

• -v: verbose log output (sets most of the client loggers to debug)
• -vv: even more verbose log output (sets all the client loggers to debug, plus the Apache HTTP Client to debug, showing input and output HTTP traffic)
• -config: select a custom properties file for configuration (by default it looks for the one named sign-pdf.properties)

More than one file can be signed/timestamped at once:

./bin/ais-client.sh -type ondemand-stepup -input doc1.pdf -input doc2.pdf -input doc3.pdf

You don't have to specify the output file:

./bin/ais-client.sh -type ondemand-stepup -input doc1.pdf

The output file name is composed of the input file name plus a configurable suffix (by default it is "-signed-#time", where #time is replaced at runtime with the current date and time). You can customize this suffix:

./bin/ais-client.sh -type ondemand-stepup -input doc1.pdf -suffix -output-#time

References

• Swisscom All-In Signing Service homepage
• Swisscom All-In Signing Service reference documentation (PDF)
• Swisscom Trust Services documentation
• iText library