CLI Reference

• General usage
• Getting help

Certifaction 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 Magenta Security 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 Magenta Security 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 Magenta Security 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 Magenta Security Sign API
  help          Help about any command
  info          Return the metadata of provided file
  ping          Ping the Magenta Security 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 Magenta Security 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 Magenta Security 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 Magenta Security 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 Magenta Security Sign environment.
  -t, --token string     The authentication token
  -v, --verbose count    Increase logs verbosity. Can be repeated multiple times to increase it even more.