The simplest API to sign, certify, and verify documents

CLI integration example code

By developers, for developers

Find the right integration solution for your architecture

Use our CLI tool to sign and verify documents from the command line

Easily integrate Certifaction to your standalone application on any platform and quickly build signature automation in any scripting language

Deploy our HTTP proxy in a VM or a Docker container in your infrastructure

Benefit from our simple API to add document signature and verification to your processes while still keeping your documents private

How to sign and certify within your IT landscape

Overview of the full integration process

One

Choose the right integration solution for your architecture

The Certifaction CLI can be used in two modes:

  • Interactive to execute commands on the shell, as part of a script or from a third party application.
  • Server mode that exposes HTTP endpoints.

In both cases, the CLI sits between the third party application and Certifaction API and will handle document signing, verification and revocation without leaking the document content outside the controlled IT infrastructure of the client.

Standalone application integration

In this scenario, the standalone application will use the OS command execution available to their platform to run the Certifaction commands. The documents can either be saved and loaded on the file system, or they can be passed to the command using the standard input and output.

Running the HTTP server on a node

In this scenario, the Certifaction CLI is started in server mode, either directly in a node or VM, or inside a Docker container. The client will use HTTP to sign and verify documents with the guarantee that documents do not leave the client IT system. This is the best option for centralized document signature where documents are signed during an automated document workflow.

Two

Sign or certify within your architecture

During document signature, the CLI will:

  1. Receive the PDF document to sign and process it (add security features and the signature footer).
  2. The processed document is returned and must replace the initial document (as this will be the document that will be signed).
  3. The hash of the file and a public key is sent to the Certifaction API for registration.
  4. The signature is timestamped in Ethereum.
  5. The signature is stored encrypted in a public database.
Three

Verify (your) signed or certified documents

During verification, the CLl will calculate the document hash and extract the private signature decryption key, then call Certifaction API that will find any signature timestamp in the blockchain and return the encrypted signatures.

  1. The document to verify is provided to the CLI
  2. The document hash is sent to the Certifaction API
  3. The verification Certifaction API will search Ethereum for all the signature timestamps for the given hash and return them.
  4. The timestamps refers to encrypted signatures stored in content addressable storage (CAS).
  5. Certifaction API returns the encrypted signature to the CLI since it cannot decrypt them without the private signature decryption key contained only in the document.
  6. The signatures are decrypted and a verification result is returned.

Your way forward

Join leading organizations

Contact us now to see how we can integrate our one-click sign button into your existing software. Or start a free trial to explore how you can sign and certify your documents through our web app – and to test our online verification tool.

emonitor Logo
emonitor Logo
Just released: The new PES - digital signature with instant ID check
This is default text for notification bar