vovsecurity
This program provides security key pair management functions for VOV.
vovsecurity ACTION {OPTIONS}
vovsecurity - security and key related management commands:
This program provides security key pair management functions for VOV.
ACTIONS:
keygen Generate a new keypair
getkey Print your public key
getserverkey Show server public key
addkey Add user key to vovserver
delkey Delete user key from vovserver
listkeys List user keys on vovserver
OPTIONS:
-f <filename> Filename to read or write for API keys.
The default is ~/.vov/userkey
-kv <keyval> Value of key to add
-kd <keydes> Description of key to add
-y Don't prompt when overwriting existing file
-v Enable verbosity
-a List keys for all users. Only valid for admins
-u <username> Specify user whose key you wish to delete. Only valid for admins
-h Show brief usage
Examples
Action | Command |
---|---|
Generates a public/private key pair and tries to write to $HOME/.vov/userkey. If the file already exists, you will be asked whether to overwrite the existing file. Overwriting your key file means that the previous keypair stored there will no longer be usable, and thus rendering storage of that public key on any vovserver instances as useless. |
|
Generates a public/private keypair and writes it into a separate key file named keyfile.txt. |
|
Reads $HOME/.vov/userkey and echos the public key back to the console. |
|
Retrieves the public key for the current project. The vovserver’s public key is written in $VOVDIR/local/registry/[system-nc | system-wx | system-lm] folders respectively. Currently, FlowTracer and Allocator projects do not support the system registry. |
|
Adds a new public key to vovserver, associated with the current user. Interactively prompts for the key value and the key description on the terminal, in addition to the user’s password in order to perform password based authentication. |
|
Adds a new public key to vovserver associated with the current user. Interactively prompts for the user’s password in order to perform username/password authentication with vovserver. If VOV_PASSWORD is set, the value of this environment variable will be used, and no prompts will be made. |
|
Deletes a key belonging to the current user. Interactively prompts for the user’s password in order to perform username/password authentication with vovserver. If VOV_PASSWORD is set, the value of this environment variable will be used, and no prompts will be made. |
|
For users with ADMIN security access on the project, keys belonging to other users can be deleted using this variation. |
|
Lists all the current user’s public keys which vovserver has stored. Interactively prompts for the user’s password in order to perform username/password authentication with vovserver. If VOV_PASSWORD is set, the value of this environment variable will be used, and no prompts will be made. |
|
For users with ADMIN access to the project, list all public keys stored in vovserver for the project. Interactively prompts for the user’s password in order to perform username/password authentication with vovserver. If VOV_PASSWORD is set, the value of this environment variable will be used, and no prompts will be made. |
|