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.
> vovsecurity keygen
Generates a public/private keypair and writes it into a separate key file named keyfile.txt.
> vovsecurity keygen -f keyfile.txt 
Reads $HOME/.vov/userkey and echos the public key back to the console.
> vovsecurity getkey
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.
> vovsecurity getserverkey
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.
> vovsecurity addkey
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.
> vovsecurity addkey -kv KEYVAL -kd 'My New Key'
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.
> vovsecurity delkey -kv KEYVAL
For users with ADMIN security access on the project, keys belonging to other users can be deleted using this variation.
> vovsecurity delkey -kv KEYVAL -u USERID
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.
> vovsecurity listkeys 
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.
> vovsecurity listkeys –a