author | Giulio Cesare Solaroli <giulio.cesare@solaroli.it> | 2011-10-05 09:04:56 (UTC) |
---|---|---|
committer | Giulio Cesare Solaroli <giulio.cesare@solaroli.it> | 2011-10-05 09:04:56 (UTC) |
commit | bbd415769410aac765f889e74a28992bc8483f94 (patch) (unidiff) | |
tree | 7c3ec7d4b877789c0df299e9fb220383b348529b /README.md | |
parent | 3065be1b71e4c40428cfa192de560c970ba7f8b3 (diff) | |
parent | f4c7a1ce0307418d0b097d610a2fa783c55c7b2a (diff) | |
download | clipperz-bbd415769410aac765f889e74a28992bc8483f94.zip clipperz-bbd415769410aac765f889e74a28992bc8483f94.tar.gz clipperz-bbd415769410aac765f889e74a28992bc8483f94.tar.bz2 |
Merge pull request #8 from mbarulli/master
Revised README.md
-rw-r--r-- | README.md | 10 |
1 files changed, 4 insertions, 6 deletions
@@ -1,62 +1,60 @@ | |||
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 | ||
6 | Please 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 | |||
8 | In 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 | |||
10 | ALL 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. | 6 | ALL 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 | ||
8 | For 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 | ||
15 | But 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? | 13 | But 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 | ||
23 | Whatever is your motivation, we would love to hear from you about how and where you use Clipperz Community Edition. [Get in contact!][contact] | 21 | Whatever 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 | ||
28 | Please note that Clipperz Community Edition may not be suitable for mass deployments, depending on how robust is the backend you select. | 26 | Please note that Clipperz Community Edition may not be suitable for mass deployments, depending on how robust is the backend you select. |
29 | 27 | ||
30 | As an example, the current PHP backend lacks several critical capabilities such as bot protection and concurrent sessions management. | 28 | As 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 | ||
35 | This 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 | 33 | This 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 |
36 | password manager for their workforce (creating and managing employees accounts, defining groups and sharing policies, ...). | 34 | password manager for their workforce (creating and managing employees accounts, defining groups and sharing policies, ...). |
37 | 35 | ||
38 | The 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. | 36 | The 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 | ||
40 | If 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]! | 38 | If 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 | ||
45 | Your 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] | 43 | Your 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 | ||
47 | This enables a single entity to represent the aggregated code base and gives the community flexibility to act as a whole to changing situations. | 45 | This 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 | ||
49 | The 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. | 47 | The 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 | ||
51 | Please [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!** | 49 | Please [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 | ||
56 | In order to build the deployable version, you need to invoke the following command: | 54 | In 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 | ||
60 | The output will be available in the `target` folder, with a separate folder for each build backend (initially this will be just a `php` folder). | 58 | The output will be available in the `target` folder, with a separate folder for each build backend (initially this will be just a `php` folder). |
61 | The 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. | 59 | The 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 | ||