Passworld Vault

Manual

Before launching the application, ensure the reader is plugged in. If a card is not inserted in the reader before launching the application, the application will ask you to insert your card.

System requirements

• Ruby 1.9.x (with rubygems)
• an internet connection to download the dependencies

Installation

Simply unzip passvault.zip, open your system command-line interpreter, go to the unzipped directory and type: gem install passvault-0.1.0.gem (you might need sudo in front of that).

User Guide

Our password vault comes with two different user interfaces. One is a command line interface and the other is graphical interface. Everyone can use the command line interface, but it is the only way to run administration commands.

The user interfaces are provided with a timeout system that requires the user to re-type its password every five minutes. This mechanism allows to prevent a potential attacker to access the vault content if the user is away and forgets to close the application properly.

Before launching one of the the application, ensure the reader is plugged in. If a card is not inserted in the reader before launching the application, the application will ask you to insert your card.

Command-line interface

Command: passvault

Available commands (copy of the inline help):

-- user commands --
list            : list the names of registered credentials
display <name>  : display a registered credential
clip <name>     : same as "display", but copies the password to the clipboard
                  instead of displaying it
add <name>      : register a new credential'
remove <name>   : remove a registered credential'
edit <name>     : change a registered credential'
quit            : exit the program'
help            : display this help message'
-- administration commands --
reset           : reinitialize the vault'
erase           : erase the vault from the tag'

Graphical user interface

Command: passvault-gui

Note: the graphical user interface does not seem to work on Linux.

Using our GUI is quite straightforward: when the interface is launched, the user is prompted to type its vault password. If its password is correct, the user access to the main part of the application, a window that shows the list of the entries name currently in the vault. The user simply has to double-click on an entry name to consult the associated password and login.