vks-java/vks-java-cli/README.md

1.7 KiB

VKS-Java-CLI

javadoc Maven Central

Command Line Frontend for VKS-Java

Usage: vkscli [COMMAND]
Commands:
  help                  Displays help information about the specified command
  get                   Retrieve an OpenPGP certificate from the key server
  upload                Upload an OpenPGP certificate to the key server
  request-verification  Request verification for unverified user-ids

Usage Examples

By default, the CLI application uses https://keys.openpgp.org as key server. To use another VKS, use the option --key-server https://your.key.server in any command.

To retrieve a key from a Verifying Key Server, use the get subcommand:

$ ./vks-java-cli get -e vanitasvitae@fsfe.org > foo.asc
$ ./vks-java-cli get -f 7F9116FEA90A5983936C7CFAA027DB2F3E1E118A > foo.asc
$ ./vks-java-cli get -i -2535611045697927659 > foo.asc

To upload a key, use the upload subcommand:

$ ./vks-java-cli upload -r < foo.asc

The option -r automatically requests verification mails for unpublished mail addresses.

To manually request verification mails, use the request-verification subcommand, passing it the token acquired by the upload command:

$ ./vks-java-cli request-verification -t <upload-token> -a foo@bar.baz -a other@email.address