summaryrefslogtreecommitdiff
path: root/README.md
authorGiulio Cesare Solaroli <giulio.cesare@clipperz.com>2013-04-21 15:55:37 (UTC)
committer Giulio Cesare Solaroli <giulio.cesare@clipperz.com>2013-04-21 15:55:37 (UTC)
commite68efe56187ce0f264159c9fe7574e68d1131404 (patch) (unidiff)
tree7391a928cf9936aecec9965a24fd6d04306ad34f /README.md
parent959c262afc598c4eeb58fe8fccf90ea8305c0eec (diff)
downloadclipperz-e68efe56187ce0f264159c9fe7574e68d1131404.zip
clipperz-e68efe56187ce0f264159c9fe7574e68d1131404.tar.gz
clipperz-e68efe56187ce0f264159c9fe7574e68d1131404.tar.bz2
Updated readme
Diffstat (limited to 'README.md') (more/less context) (ignore whitespace changes)
-rw-r--r--README.md54
1 files changed, 30 insertions, 24 deletions
diff --git a/README.md b/README.md
index f9ad766..e20082c 100644
--- a/README.md
+++ b/README.md
@@ -1,78 +1,84 @@
1# ![Clipperz icon][icon] CLIPPERZ - Online Password Manager 1# ![Clipperz icon][icon] CLIPPERZ - Online Password Manager
2 2
3 3
4##What does Clipperz do? 4##What does Clipperz do?
5 5
6You can think of Clipperz as an online vault where you can store any sort of confidential data without worrying about security. It can be used to save and manage passwords, private notes, burglar alarm codes, credit and debit card details, PINs, software keys, … 6Clipperz is an online vault where you can store confidential data without worrying about security. It can be used to save and manage passwords, private notes, burglar alarm codes, credit and debit card details, PINs, software keys, …
7Since passwords are the most common type of private information that you need to protect, we have added a great deal of functionality to make Clipperz the best online password manager available thus solving the “password fatigue” problem. 7Since passwords are the most common type of private information that you need to protect, we have added a great deal of functionality to make Clipperz a great [online password manager][home] thus solving the “password fatigue” problem.
8 8
9**Clipperz makes the Internet the most convenient and safe place to keep you most precious and sensitive data.** 9**Clipperz makes the Internet the most convenient and safe place to keep you most precious and sensitive data.**
10 10
11Read more on the [Clipperz website][clipperz]. 11Read more on the [Clipperz website][home].
12
13[home]: http://www.clipperz.com
12 14
13## Why an open source version 15## Why an open source version
14 16
15Because we want to enable as many people as possible to play with our code. So that you can start trusting it, the code not the developers. 17Because we want to enable as many people as possible to play with our code. So that you can start trusting it, the code not the developers.
16 18
17In order to allow you to inspect the code and analyze the traffic it generates between client and server, we had to provide an easy way to locally deploy the whole service. 19In order to allow you to inspect the code and analyze the traffic it generates between client and server, we had to provide an easy way to locally deploy the whole service.
18 20
19So, feel free to host on your own server a web service identical to [Clipperz online password manager][clipperz]. You can choose among multiple backends (PHP/MySQL, Python/AppEngine, …) and you can contribute your own. 21Feel free to host on your machine a web service identical to [Clipperz online password manager][clipperz]. You can choose among **multiple backends** (PHP/MySQL, Python/AppEngine, …) or you can [contribute][CA] your own.
20 22
21Whatever is your motivation, we would love to hear from you: [get in contact!][contact] 23Whatever is your motivation, we would love to hear from you: [get in contact!][contact]
22 24
25[CA]: http://www.clipperz.com/open_source/contributor_agreement
26[contact]: http://www.clipperz.com/about/contacts
27
23## License 28## License
24ALL the code included in this project, if not otherwise stated, is released with the **AGPL v.3 license** (see `LICENSE.txt`), and all rights are reserved to Clipperz Srl. For any use not allowed by the AGPL license, please [contact us][contact] to inquire about licensing options for commercial applications. 29ALL the code included in this project, if not otherwise stated, is released with the [AGPL v3][agpl] license (see `LICENSE.txt`), and all rights are reserved to Clipperz Srl. For any use not allowed by the AGPL license, please [contact us][contact] to inquire about licensing options for commercial applications.
30
31[agpl]: http://www.gnu.org/licenses/agpl.html
32
25 33
26## Warnings 34## Warnings
27Please note that the open source version of Clipperz may not be suitable for mass deployments, depending on how robust is the backend you select. As an example, the current PHP backend lacks several critical capabilities such as bot protection and cuncurrent sessions management. 35Please note that the open source version of Clipperz Password Manager may not be suitable for mass deployments, depending on how robust is the backend you select. As an example, the current PHP backend lacks several critical capabilities such as bot protection and concurrent sessions management.
28 36
29## Contributions 37## Contributions
30 38
31Your contributions to Clipperz are very welcome! In order to avoid jeopardizing the ownership of the code base, we will require every developer to sign the Clipperz [Contributor Agreement][CA] 39Your contributions to Clipperz are very welcome! In order to avoid jeopardizing the ownership of the code base, we will require every developer to sign the Clipperz [Contributor Agreement][CA]
32 40
33This enables a single entity to represent the aggregated code base and gives the community flexibility to act as a whole to changing situations. 41This enables a single entity to represent the aggregated code base and gives the community flexibility to act as a whole to changing situations.
34 42
35The CA establishes a joint copyright assignment in which the contributor retains copyright ownership while also granting those rights to Clipperz Srl. With the CA in place, the aggregated code base within any Clipperz open source project is protected by both the distribution license and copyright law. 43The CA establishes a joint copyright assignment in which the contributor retains copyright ownership while also granting those rights to Clipperz Srl. With the CA in place, the aggregated code base within any Clipperz open source project is protected by both the distribution license and copyright law.
36 44
37Please [download][CA] and review the Contributor Agreement for a complete understanding of its terms and conditions. You may send your signed and completed CA to Clipperz by scanning your completed form and emailing the image or by fax. Please retain a copy for your records. **Thanks!** 45Please [download][CA] and review the Contributor Agreement for a complete understanding of its terms and conditions. You may send your signed and completed CA to Clipperz by scanning your completed form and emailing the image or by fax. Please retain a copy for your records. **Thanks!**
38 46
39 47
40## Building 48## Building
41 49
42In order to build the deployable version, you need to invoke the following command: 50In order to build the deployable version, you need to invoke the following command:
43 51
44 ./scripts/build clean install debug --frontends beta --backends php 52 git clone git@github.com:clipperz/password-manager.git
53 cd password-manager
54 ./scripts/build install --backends php python --frontends beta gamma
55
56The output will be available in the `target` folder, with a separate folder for each backend (currently the available options are `php` and `python`).
57The script, invoked with these parameters, will build both the full version (`install` -> index.html) and the debug version (index_debug.html) of the specified frontends.
45 58
46The output will be available in the `target` folder, with a separate folder for each build backend (initially this will be just a `php` folder). 59Besides PHP and Python, more backends are in the works, most notably a node.js version.
47The script, invoked with these parameters, will build both the full version (`install` -> index.html) and the debug version (index_debug.html) of the /beta frontend using the PHP backend.
48
49At the moment this is the only combination that works, but this script will be gradually extended to be able to build also the [/gamma frontend][gamma] (whose code is already in the repository) and possibly also other backends (Python AppEngine being the very first candidate, and a Javascript version per node.js another interesting option)
50 60
51 61
52## Installing 62## Installing
53 63
54### PHP + MySQL backend 64### PHP + MySQL backend
55 65
56At the moment the only backend that the build script can successfully create is the PHP + MySQL one. 66* **PHP**
57 67 Once the project has been successfully build, the application needs to be moved in a location where the web server can run it. Everything that is needed is located into `target/php`.
58#### PHP
59Once the project has been successfully build, the application needs to be moved in a location where the web server can run it. Everything that is needed is located into `target/php`.
60
61#### MySQL
62The application needs a simple MySQL database; to configure all the credentials to access the previously allocated DB, edit the file found in `php/configuration.php`. You need to edit the file actually used by the web server; this will usually be the one moved into the right place in the previous step.
63Once the application is in place, and the DB credentials have been configured, you should initialize the DB itself; in order to do so, just point your browser at the following url: `http://<host>/<path>/php/setup/index.php`.
64Here you will find the standard [POG][pog] setup page: it should be enough to click the "POG me up!" button at the bottom of the page, and then the "Process" button on the next page.
65The POG interface will allow also a very basic access to the DB data that may be useful to check that the application is actually writing something on the DB (even if you will not be able to make much sense out of the data you will see, as they are all encrypted!)
66 68
67More information about building the PHP backend may be found in the `doc/install.php.txt` file. 69* **MySQL**
70 The application needs a simple MySQL database; to configure all the credentials to access the previously allocated DB, edit the file found in `php/configuration.php`. You need to edit the file actually used by the web server; this will usually be the one moved into the right place in the previous step.
71 Once the application is in place, and the DB credentials have been configured, you should initialize the DB itself; in order to do so, just point your browser at the following url: `http://<host>/<path>/php/setup/index.php`.
72 Here you will find the standard [POG][pog] setup page: it should be enough to click the "POG me up!" button at the bottom of the page, and then the "Process" button on the next page.
73 The POG interface will allow also a very basic access to the DB data that may be useful to check that the application is actually writing something on the DB (even if you will not be able to make much sense out of the data you will see, as they are all encrypted!)
74 More information about building the PHP backend may be found in the `doc/install.php.txt` file.
68 75
69 76
70## Disclaimer 77## Disclaimer
71 78
72The resulting application has not been fully tested, so there may be still problems due to the new build script or some other changes that were done due to the new repository structure. So, for the moment, **use it at your own risk!** 79The resulting application has not been fully tested, so there may be still problems due to the new build script or some other changes that were done due to the new repository structure. So, for the moment, **use it at your own risk!**
73 80
74[icon]: http://0.gravatar.com/avatar/2a9fae49ced80a42830a206f88ea1022?size=100 81[icon]: http://0.gravatar.com/avatar/2a9fae49ced80a42830a206f88ea1022?size=100
75[clipperz]: http://www.clipperz.com 82[clipperz]: http://www.clipperz.com
76[contact]: http://clipperz.com/contact 83
77[CA]: http://www.clipperz.com/open_source/contributor_agreement
78[pog]: http://www.phpobjectgenerator.com/ \ No newline at end of file 84[pog]: http://www.phpobjectgenerator.com/ \ No newline at end of file