Skip to content

CLI Reference ​

HIN Sign command line interface (CLI) is a convenient tool to sign documents and

request signatures from others.

General usage ​

certifaction [certifaction flags] <command> [arguments]

Getting help ​

Use certifaction --help to get the list of available commands:

certifaction --help
The HIN Sign 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 HIN Sign API and will handle document signing, verification and revocation without leaking the document content outside the controlled IT infrastructure of the client.

The two main functions of the CLI are document signature and verification.

Usage:
  certifaction [command]

Available Commands:
  delete-access Remove HIN Sign access to the file
  download      Download and decrypt document from digital archive
  export        Export data
  generate-keys Generate encryption keys & a possible password
  health        Return the health of the HIN Sign API
  help          Help about any command
  info          Return the metadata of provided file
  ping          Ping the HIN Sign API
  prepare       Prepare a document for signing
  qes           QES (Qualified E-Signature)
  register      registers a document
  request       Request a document signature
  retract       retract a document
  revoke        revoke a document
  server        Start in server mode
  sign          Sign a document
  user          Return the authenticated user information
  verify        Verify a document

Flags:
      --api string       Overrides the default HIN Sign API URL
      --api-key string   The api key used for authentication
      --env string       Optional environment name. Defaults to prod. Will automatically setup the API URL for a Given HIN Sign environment.
  -h, --help             help for certifaction
  -t, --token string     The authentication token
  -v, --verbose count    Increase logs verbosity. Can be repeated multiple times to increase it even more.
      --version          version for certifaction

Then use certifaction help <command> to get more detailed help for a given command, like for example:

certifaction help help
Help provides help for any command in the application.
Simply type certifaction help [path to command] for full details.

Usage:
  certifaction help [command] [flags]

Flags:
  -h, --help   help for help

Global Flags:
      --api string       Overrides the default HIN Sign API URL
      --api-key string   The api key used for authentication
      --env string       Optional environment name. Defaults to prod. Will automatically setup the API URL for a Given HIN Sign environment.
  -t, --token string     The authentication token
  -v, --verbose count    Increase logs verbosity. Can be repeated multiple times to increase it even more.