summaryrefslogtreecommitdiff
authorMarco Barulli <marco@clipperz.com>2011-10-05 09:01:44 (UTC)
committer Marco Barulli <marco@clipperz.com>2011-10-05 09:01:44 (UTC)
commitf4c7a1ce0307418d0b097d610a2fa783c55c7b2a (patch) (unidiff)
tree7c3ec7d4b877789c0df299e9fb220383b348529b
parent3065be1b71e4c40428cfa192de560c970ba7f8b3 (diff)
downloadclipperz-f4c7a1ce0307418d0b097d610a2fa783c55c7b2a.zip
clipperz-f4c7a1ce0307418d0b097d610a2fa783c55c7b2a.tar.gz
clipperz-f4c7a1ce0307418d0b097d610a2fa783c55c7b2a.tar.bz2
Revised README.md
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--README.md10
1 files changed, 4 insertions, 6 deletions
diff --git a/README.md b/README.md
index 67d69b1..96b73a5 100644
--- a/README.md
+++ b/README.md
@@ -1,93 +1,91 @@
1# ![Clipperz icon][icon] Clipperz Password Manager - COMMUNITY EDITION 1# ![Clipperz icon][icon] CLIPPERZ COMMUNITY EDITION - Online Password Manager
2 2
3 3
4[Clipperz Community Edition][CE] allows you to host on your own server a web service identical to [Clipperz online password manager][clipperz]. It supports multiple backends (PHP/MySQL, Python/AppEngine, …) and you can contribute your own. 4[Clipperz Community Edition][CE] allows you to host on your own server a web service identical to [Clipperz online password manager][clipperz]. It supports multiple backends (PHP/MySQL, Python/AppEngine, …) and you can contribute your own.
5 5
6Please note that Clipperz Community Edition is not suitable for mass deployments since it lacks several critical capabilities such as bot protection. If you want to offer Clipperz password manager to a wide audience, please wait for the upcoming Provider Edition.
7
8In any case if you want to use Clipperz’s software in a commercial, for-profit environment, please contact us to inquire about licensing options for commercial applications.
9
10ALL 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. 6ALL 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.
11 7
8For any use not allowed by the AGPL license, please [contact us][contact] to inquire about licensing options for commercial applications.
9
12 10
13## Why a Community Edition 11## Why a Community Edition
14 12
15But why would you prefer running Clipperz Community Edition from your own server instead of using the free and anonymous online service provided by its developers? 13But why would you prefer running Clipperz Community Edition from your own server instead of using the free and anonymous online service provided by its developers?
16 14
17* “Clipperz security architecture is great, but I prefer to store my data on my hardware. I just feel better this way!” 15* “Clipperz security architecture is great, but I prefer to store my data on my hardware. I just feel better this way!”
18* “Clipperz is cool, but it would be even cooler it it had a Scala backend. I'm going to write it!" 16* “Clipperz is cool, but it would be even cooler it it had a Scala backend. I'm going to write it!"
19* “I would like to modify the look & feel of Clipperz and embed this powerful password manager within my family intranet.” 17* “I would like to modify the look & feel of Clipperz and embed this powerful password manager within my family intranet.”
20* “Clipperz works nicely, but I would love to play with the source code in order to improve feature X and add new features Y and Z.” 18* “Clipperz works nicely, but I would love to play with the source code in order to improve feature X and add new features Y and Z.”
21* … 19* …
22 20
23Whatever is your motivation, we would love to hear from you about how and where you use Clipperz Community Edition. [Get in contact!][contact] 21Whatever is your motivation, we would love to hear from you about how and where you use Clipperz Community Edition. [Get in contact!][contact]
24 22
25 23
26## Warnings 24## Warnings
27 25
28Please note that Clipperz Community Edition may not be suitable for mass deployments, depending on how robust is the backend you select. 26Please note that Clipperz Community Edition may not be suitable for mass deployments, depending on how robust is the backend you select.
29 27
30As an example, the current PHP backend lacks several critical capabilities such as bot protection and concurrent sessions management. 28As an example, the current PHP backend lacks several critical capabilities such as bot protection and cuncurrent sessions management.
31 29
32 30
33## Community Edition vs Workgroup Edition 31## Community Edition vs Workgroup Edition
34 32
35This Community Edition is aimed to **individual users**, but you may be interested to know that we are working on a **Workgroup Edition** targeting organizations that need a 33This Community Edition is aimed to **individual users**, but you may be interested to know that we are working on a **Workgroup Edition** targeting organizations that need a
36password manager for their workforce (creating and managing employees accounts, defining groups and sharing policies, ...). 34password manager for their workforce (creating and managing employees accounts, defining groups and sharing policies, ...).
37 35
38The Workgroup Edition development is quite challenging and, while the overall design is already in place, it will still require a fairly large amount of resources for analysis and implementation. 36The Workgroup Edition development is quite challenging and, while the overall design is already in place, it will still require a fairly large amount of resources for analysis and implementation.
39 37
40If your organization is interested in such edition, you can subscribe a "pledge" to sustain its development in exchange for a very generous user license with unlimited upgrades and other benefits. Again, [get in contact][contact]! 38If your organization is interested in such edition, you can subscribe a "pledge" to sustain its development in exchange for a very generous user license with unlimited upgrades and other benefits. Again, [get in contact][contact]!
41 39
42 40
43## Contributions 41## Contributions
44 42
45Your contributions to Clipperz Community Edition 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] 43Your contributions to Clipperz Community Edition 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]
46 44
47This enables a single entity to represent the aggregated code base and gives the community flexibility to act as a whole to changing situations. 45This enables a single entity to represent the aggregated code base and gives the community flexibility to act as a whole to changing situations.
48 46
49The 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. 47The 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.
50 48
51Please [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!** 49Please [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!**
52 50
53 51
54## Building 52## Building
55 53
56In order to build the deployable version, you need to invoke the following command: 54In order to build the deployable version, you need to invoke the following command:
57 55
58 ./scripts/build clean install debug --frontends beta --backends php 56 ./scripts/build clean install debug --frontends beta --backends php
59 57
60The output will be available in the `target` folder, with a separate folder for each build backend (initially this will be just a `php` folder). 58The output will be available in the `target` folder, with a separate folder for each build backend (initially this will be just a `php` folder).
61The 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. 59The 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.
62 60
63At 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) 61At 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)
64 62
65 63
66## Installing 64## Installing
67 65
68### PHP + MySQL backend 66### PHP + MySQL backend
69 67
70At the moment the only backend that the build script can successfully create is the PHP + MySQL one. 68At the moment the only backend that the build script can successfully create is the PHP + MySQL one.
71 69
72#### PHP 70#### PHP
73Once 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`. 71Once 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`.
74 72
75#### MySQL 73#### MySQL
76The 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. 74The 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.
77Once 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`. 75Once 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`.
78Here 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. 76Here 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.
79The 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!) 77The 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!)
80 78
81More information about building the PHP backend may be found in the `doc/install.php.txt` file. 79More information about building the PHP backend may be found in the `doc/install.php.txt` file.
82 80
83 81
84## Disclaimer 82## Disclaimer
85 83
86The 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!** 84The 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!**
87 85
88[icon]: http://0.gravatar.com/avatar/2a9fae49ced80a42830a206f88ea1022?size=100 86[icon]: http://0.gravatar.com/avatar/2a9fae49ced80a42830a206f88ea1022?size=100
89[CE]: http://clipperz.com/open_source/clipperz_community_edition 87[CE]: http://clipperz.com/open_source/clipperz_community_edition
90[clipperz]: http://www.clipperz.com 88[clipperz]: http://www.clipperz.com
91[contact]: http://clipperz.com/contact 89[contact]: http://clipperz.com/contact
92[CA]: http://www.clipperz.com/open_source/contributor_agreement 90[CA]: http://www.clipperz.com/open_source/contributor_agreement
93[pog]: http://www.phpobjectgenerator.com/ \ No newline at end of file 91[pog]: http://www.phpobjectgenerator.com/ \ No newline at end of file