Skip to content

Latest commit

 

History

History
148 lines (110 loc) · 5.62 KB

03. Web Interface.md

File metadata and controls

148 lines (110 loc) · 5.62 KB

[ ← Bootstrapping ]     [ Table Of Contents ↑ ]

Sunil Samuel
web_github@sunilsamuel.com
http://www.sunilsamuel.com

Web Interface

Once the application is bootstrapped, it will print out URLs that the application is listening on. Use any browser (IE, Mozilla, Chrome, ...) to access this page.

> java -jar target/password-safe-webapp-<version>.jar --dbDir ~/databases/newdb
Please enter a password for database:<password>
Server starting (try these URLs):
	http://192.168.0.103:8080
	http://localhost:8080

Authentication

Once the application is executed for the first time, it will initialize the database created with a user name and password that will be used to access this user interface for the first time. This user has full authorization to the system, therefore change the password once you log onto the system. This username and password are:

Username: admin@passwordsafeweb.com
Password: mypassword

The interface is as follows:

Home Page (Admin)

The application will create a default Category and Entry. Since the first user that the application creates has an authorization role of admin user, you should update the password and create additional users, using the Admin menu item.

The application uses a role-based system to authorize the different users into the system. This means that the admin can determine what type of access a user has into the system. There are three roles as follows:

  • Admin - The user has full access to this system. The user can add, update, and delete categories and entries in addition to modifying the users.
  • ReadWrite - The user can add, update, and delete categories and entries.
  • ReadOnly - The user can only view categories and entries but cannot change anything.
Role Category Entry User Import Export
Read Write Read Write My Account All Users
Admin
ReadWrite
ReadOnly

Category (Group)

A Category is a directory hierarchy that can hold several entries. A category can have sub-categories similar to a directory on a file system. Name a category according to the entries it will hold, such as 'Credit Cards', 'YouTube', 'Facebook', 'Personal', ....

Use the menu item 'Category' to create, delete, update, and view categories.

Create as many categories and sub-categories as you need so that you can group your entries accordingly using the Menu → Category → New Category link. At a minimum, provide a 'title' for the category and you can start to add entries into it.

Once a Category is created, use the Menu → Entry → New Entry link to create a new entry.

Entry

An entry hosts the username and password for a certain site or application. This can also hold youtube and facebook videos.

Create an Entry using the Menu → Entry; → New Entry.

Edit Entry

Click on one of the categories that was created (on the left side) to get a list of entries for a Category.

Use either the 'Action' link to Edit/Delete or Menu → Entry → Edit Entry/Delete Entry to modify the entry.

View Entry

Use the 'View Entry' menu item or action link to view the entry in a read only page.

Clipboard (double-click)

As you view this entry, you can double click on any of the elements and it will capture it into your clipboard. This will allow you to just paste the data into the input box. For instance, if you want to capture the password, double click on the password (although you cannot see it), it will save this password into the clipboard and you can paste it into the password field of the web or application.

Search

Use the search box on the top right, to search and find entries in all of the categories. Just enter the search term and it will find all of the entries where either the title, description, or notes has this search text.

[ ← Bootstrapping ]     [ Table Of Contents ↑ ]