README

Collaborative passwords manager in web browser. Based on the Yii2 PHP framework. Ideal for intranet usage for teams. Fast and handy access from the internet. It provides the following features:

• Account credential and user management via web browser.
• Assign account credentials to various users.
• Passwords are saved as encrypted hash in the database. You can specify an unique key for password encryption in your configuration (config/params.php).
• Copy username or password fast into clipboard.
• Responsive user interface by bootstrap frontend framework.
• Import and export functionality via open KeePass XML format. Many apps and desktop programs for all operating systems are using the KeePass XML format. For example:
  • KeePassX (desktop)
  • KeePass (desktop)
  • KeePassDroid (app - Android)
  • MiniKeePass (app - iOS)
• Last but not least: easy and fast to modify and extend, because it's based on the excellent Yii2 PHP framework.
  • Quick start with coding via the great online guide.
• Single user mode. Just set it along with a hash for encoding and decoding in your config/params.php file. Then sign in with .htaccess and .htpasswd protection.

Getting Started

YiiPass uses SQlite database by default. That allows you to quickly check the YiiPass application without configuration hassle. The installation works via the Composer PHP package manager, so you can test YiiPass very quick.

If you're already using Composer, you need only 1 command to install YiiPass:

composer --stability=dev --keep-vcs create-project jepster/yiipass yiipass-dev

Please let your web server point to the "web"-directory which will be created afterwards. Like it's default in Yii2 framework.

The user for start is:

• username: admin
• password: admin

All set!

Then you can quickly start using YiiPass via accessing it from the web browser. The following screenshots will show you how to use YiiPass.

###Search fast

###Copy, edit, delete and view fast

###Integrate with open KeePass format

###User permissions

###Source code project structure Read more about the application structure in the Yii2 PHP framework guide.

Use MySQL, MariaDB, PostgreSQL, CUBRID, Oracle or MSSQL instead of SQlite

Change the configuration to the desired DBMS in the config file (config/db.php). An instruction can be found at bsourcecode.com. After the database config is set, you need to apply the database migrations via the command line program from Yii2 (more about the command line program in Yii2).

yii migrate --migrationPath=@yii/rbac/migrations
yii migrate --migrationPath=modules/yiipass/migrations

Now your database is feed with the schema.

The SQlite database, which is used per default, is located in the application root folder. The filename is yiipass.sqlite.

Troubleshooting

PDO_SQLITE driver not present on Ubuntu Linux server.. what to do?

Then try the following commands

sudo apt-get update

sudo apt-get install php5-sqlite --fix-missing

service apache2 restart

The first one updates the package manager sources. The second one installs the PHP5 SQLite extension and fixes missing package sources. The third one restarts the Apache2 web server. If you're using the Nginx web server, the Nginx Beginner's Guide could help you out.

Mcrypt extension is missing on Ubuntu Linux server

Then run the following commands.

sudo apt-get install php5-mcrypt

php5enmod mcrypt

service apache2 restart

The first command installs the PHP5 mcrypt extension. The second one enabled the extension in PHP. The third restarts the Apache2 webserver. If you use Nginx f.e., the first both commands could help you also.

Data cannot be written into database

The there're errors like follows:

SQLSTATE[HY000]: General error: 8 attempt to write a readonly database

or

SQLSTATE[HY000]: General error: 14 unable to open database file

Then make sure that the folder where the yiipass.sqlite SQlite database resides, has the correct permissions. Also the SQLite database itself must have the correct permissions. By default, this file is located in the application root-folder. The folder and the file must be owned by www-data, if you use apache. Further information

Known issues

YiiPass is still in development. Please mind the following issues. Help would be appreciated. Please consider the issues management functionality here on GitHub. Please ask me (jepster) if you want to learn more about the development.

• Last access field in account credential is not beeing updated.
• There should be a second password form field on the account credentials edit page. That way there would be more control about the password validity.

Bugs, questions, suggestions?

Please feel free to contact me via GitHub. Don't forget the issues management functionality here on GitHub.