/ 
App-passmanager-1.113580
River stage zero No dependents
/ passmanager

NAME

passmanager - Command-Line Shared Password Store

VERSION

version 1.113580

SYNOPSIS

$ passmanager --help
Available commands:

  commands: list the application's commands
      help: display a command's help screen

      init: initialize git repository and passphrase files
   newuser: provision a new user, or reset a user passphrase
      open: browse and edit the password repository

DESCRIPTION

This program manages one or more password stores which can be securely shared and edited amongst a team. Each team member maintains their own passphrase to access a password store.

Individual user passphrases can be changed and new users added. The password store is a simple XML format which can easily be read by humans or the XML::Simple Perl module, and is maintained in a Git repository.

USAGE

The program passmanager takes three commands as shown in "SYNOPSIS", above. These allow you to initialise a new password store, access the store, and add a new user to an existing store.

There can be multiple password stores (a default name is provided, or overridden on the command line), and they are stored in a Git repository (obviously, as binary files due to the encryption).

Use the --help flag to see what options are available. In general you can set the location of the Git repository, the name of the password store, and your own username. Each of these has sane defaults shown in the help text.

PASSWORD HIERARCHY

A three tier system is provided to help organise passwords. The names of the tiers have no special meaning - you can group passwords however you wish. The first two tiers, called Categories and Services, are simply containers. The third tier, Entries, holds multiple password details.

  • Category

  • Service

  • Entry

Categories and Services have only a title. The password Entry itself has a tile, username, password, and comment field. In each case the title is required, and for entries, either of the username or password is required.

INITIAL SET-UP

$ passmanager init

Call the initialisation command as shown, and you will be prompted for your own passphrase (twice) and the master passphrase for the store (also twice). Then the Git repository will be initialised and you are shown the password management interface.

Subsequently, run the application with the open command and you will be prompted for your own passphrase:

$ passmanager open

Use the --help flag to see what options are available. In general you can set the location of the Git repository, the name of the password store, and your own username. Each of these has sane defaults shown in the help text.

THANKS

My thanks to Guy Edwards who collaborated on the original version of this application.

AUTHOR

Oliver Gorwits <oliver@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Oliver Gorwits.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.