Help

Categories

Categories are used to contain passwords. You might have one for Work and one for Personal. This helps keep your passwords organized.

Begin by adding one via the Menu. After you've created one, you can touch it to open that category. Once a category is selected you may then create password entries.

Passwords

After first selecting a category, you may Edit, Add or Delete password entries from the Password List activity.

Password entries consist of the following fields:

Description
Description is a required field. This is what is shown in the password list.
Website
If appropriate, provide the full URL to the website associated with this entry.
Username
Username for the password, if appropriate.
Password
Finally the password itself.
Notes
Miscellaneous notes about this entry. You may type as much as you want, the field will expand to accommodate.

Master Password

When you run OI Safe for the very first time, you are prompted for a 'Master Password'. This password is used to encrypt a generated Master Key. The Master Key is in turn used to encrypt and decrypt all the password entries.

Each time that you launch OI Safe, the Master Password that you type is used to decrypt, or unlock, the Master Key. The Master Key is used to decrypt/encrypt the password entries.

The Master Key does not change. When you use the 'Change Master Password' Menu option, you are merely re-encrypting the Master Key with a new password. The encrypted password entries are untouched, since they are encrypted with the Master Key.

Backup and Restore

You should backup your database of passwords from time to time. To do this use Menu -> Backup. This will create a file named 'oisafe.xml' on the sdcard. Connect your phone to a computer and allow the USB mounting. Look for 'oisafe.xml' and copy that to a safe location on your computer. The file is encrypted using the same encryption as the database on your phone.

Import and Export

You can import data into OI Safe using CSV files. It is easiest to create and manage a CSV within a spreadsheet program like Excel or OpenOffice. Create a file with the following columns in the first row.

Category Description Website Username Password Notes

OI Safe import is very sensitive about the first row, so please specify the first row exactly like the above list. You may also find it helpful to put some data into the OI Safe and perform an export first, so that you can see what the CSV should look like.

Use the name 'oisafe.csv' for your filename. Connect the phone to your computer and copy 'oisafe.csv' onto the phone. The file must be in the base directory of the phone's USB storage.

Once the CSV file is in place, use Menu -> Import to import the file. Be sure that your phone is not connected to your computer as the sdcard is not allowed to be accessed by both your computer and the phone at the same time.

Exporting is a snap. Just use Menu -> Export. This will create the file 'oisafe.csv'. Connect your phone to a computer to retrieve this file.

WARNING: The exported file is not encrypted!! After exporting and working with the file, you should delete it as soon as possible!

Security Concerns

OI Safe was written to safely store your passwords so that nobody can see them other than you. The password you use to unlock OI Safe is used to encrypt the data. Data is stored within a SQLite database within your phone. That database stays local. It does not get transferred to the Internet. In fact, the application doesn't have the security privileges to even access the Internet.

Because OI Safe cannot access the Internet, the data is not automatically backed up. In order to backup, you will need to use Menu -> Backup.

Locking

Any of the following actions will cause OI Safe to lock:

Really, the easiest way to lock is to just hit the power button on the phone briefly and turn off the screen.

Credits

Authors:

Key Icon is Copyright David Vignoni, and licensed under the GNU LGPL V2.1

More Information

For further information about this application, please visit the OpenIntents project web page at http://www.openintents.org/.