Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nextcloud/passman.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPassman Bot <info@passman.cc>2016-12-22 05:00:23 +0300
committerPassman Bot <info@passman.cc>2016-12-22 05:00:23 +0300
commit002efc08690f3d57fa18e6203a66b8ffcfd8b7e5 (patch)
treecc0d62263267d0e30887d4439ca6cb66f62e9d0c
Initial commit of dist branch
-rw-r--r--README.md87
1 files changed, 87 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..208d6b79
--- /dev/null
+++ b/README.md
@@ -0,0 +1,87 @@
+#Currently in BETA
+#Passman
+
+[![Build Status](https://travis-ci.org/nextcloud/passman.svg?branch=master)](https://travis-ci.org/nextcloud/passman)
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/nextcloud/passman/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/nextcloud/passman/?branch=master)
+[![Code Coverage](https://scrutinizer-ci.com/g/nextcloud/passman/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/nextcloud/passman/?branch=master)
+
+
+Passman is a full featured password manager.
+Features:
+- Vaults
+- Vault key is never sent to the server
+- Credentials are stored with 256 bit AES
+- Ability to add custom fields to credentials
+- Built-in OTP(One Time Password) generator
+- Password analyzer
+- Share passwords internally and via link in a secure manner.
+- Import from various password managers:
+ - KeePass
+ - LastPass
+ - DashLane
+ - ZOHO
+ - Clipperz.is
+
+
+## Tested on
+- NextCloud 10 / 11
+- ownCloud 9.1+
+
+
+## Supported databases
+- SQL Lite*
+- MySQL / MariaDB*
+
+*Tested on travis
+
+Untested databases:
+- pgsql
+
+
+##Screenshots
+![Logged in to vault](http://i.imgur.com/ciShQZg.png)
+
+![Credential selected](http://i.imgur.com/3tENldT.png)
+
+![Edit credential](http://i.imgur.com/Iwm3hUe.png)
+
+![Password tool](http://i.imgur.com/ZYkN70r.png)
+
+For more screenshots: [Click here](http://imgur.com/a/giKVt)
+
+## Code reviews
+If you have any improvements regarding our code.
+Please do the following
+- Clone us
+- Make your edits
+- Add your name to the contributors
+- Send a PR
+
+Or if you're feeling lazy, create an issue, and we'll think about it.
+
+## Docker
+To run passman with docker you can use `docker run -p 8080:80 -p 8443:443 brantje/passman`
+To use your own SSL cert mount them as below
+Example:
+`docker run -p 8080:80 -p 8443:443 -v /directory/cert.pem:/data/ssl/cert.pem -v /directory/cert.key:/data/ssl/cert.key brantje/passman`
+
+
+## Development
+Passman uses a single `.js` file for the templates. This gives the benefit that we don't need to request every template with XHR.
+For CSS we use SASS so you need ruby and sass installed.
+`templates.js` and the CSS are build width `grunt`.
+To watch for changes use `grunt watch`
+To run the unit tests install phpunit globally, and stup the envioronment variables on the `launch_phpunit.sh` script then just run that script any argumetns passed to this script will be forwarded to phpunit.
+
+## Main developers
+- Brantje
+- Animalillo
+
+## Contributors
+Add yours when creating a pull request!
+- None
+
+
+## FAQ
+**Are you adding something to check if malicious code is executing on the browser?**
+No, because malitous code could edit the functions that check for malicious code. \ No newline at end of file