From 2fd3332f66226033f5803583b4c9e57d90abec3b Mon Sep 17 00:00:00 2001 From: lars Date: Mon, 17 Apr 2006 18:16:29 +0000 Subject: [PATCH] instructions for encrypted mailing lists added --- README | 29 +++++++++++++++++++--------- README.gnupg | 50 ++++++++++++++++++++++++++++++++++++++++++++++++ ezmlmwebrc.gnupg | 7 +++++-- 3 files changed, 75 insertions(+), 11 deletions(-) create mode 100644 README.gnupg diff --git a/README b/README index 00bd7aa..f10aaea 100644 --- a/README +++ b/README @@ -14,9 +14,10 @@ Contents V. Notes VI. Multi-level list access VII. Language Portability -VIII. Bugs && Bug Reports - XI. Acknowledgements - X. Availability +VIII. Encrypted mailing lists + IX. Bugs && Bug Reports + X. Acknowledgements + XI. Availability I. Copyright Stuff - essentially the FreeBSD licence ... @@ -255,7 +256,14 @@ Secondly, please mail me a copy (ezmlm-web@sumpfralle.de) so that I may use them in any future releases of ezmlm-web. -VIII. Bugs && Bug Reports +VIII. Encrypted mailing lists +============================= +If you want to manage encrypted mailing lists (see +http://www.synacklabs.net/projects/crypt-ml/) with ezmlm-web, then you should +read README.gnupg and follow the instructions. + + +IX. Bugs && Bug Reports ======================= I don't know of any bugs, but then this is a rewrite and a first release. It has been tested reasonably well, but not exhaustively. I know it works on @@ -263,12 +271,15 @@ FreeBSD 4.0-STABLE, FreeBSD 3.4-RELEASE, RedHat 5.1, Redhat 6.0 and Debian 3.0 all using an Apache web server, but I would be interested to know whether it works on other OSs and with other web servers. -Please mail bug reports and comments to ezmlm-web@sumpfralle.de. -Or (even better) submit a bug report at https://systemausfall.org/trac/ezmlm-web. -Or subscribe to the ezmlm-web mailinglist: ezmlm-web-subscribe@lists.systemausfall.org. +Please mail bug reports and comments to + ezmlm-web@sumpfralle.de +Or (even better) submit a bug report at + https://systemausfall.org/trac/ezmlm-web +Or subscribe to the ezmlm-web mailinglist: + ezmlm-web-subscribe@lists.systemausfall.org -IX. Acknowledgements +X. Acknowledgements =================== * Guy Antony Halse (guy-ezmlm@rucus.ru.ac.za) - he created ezmlm-web and maintained it till 02005 @@ -293,7 +304,7 @@ IX. Acknowledgements interface for v3.0 -X. Availability +XI. Availability ================= More information on ezmlm-web and developments to ezmlm-web can be found at: https://systemausfall.org/toolforge/ezmlm-web diff --git a/README.gnupg b/README.gnupg new file mode 100644 index 0000000..929b4cc --- /dev/null +++ b/README.gnupg @@ -0,0 +1,50 @@ +This file describes how to manage encrypted mailing lists with ezmlm-web. + +Content: +1) Requirements +2) Installation of gpg-ezmlm +3) Setup of ezmlm-web +4) Notes + +------------------------------ + +1) Requirements +To use encrypted mailing lists, you need to install gpg-ezmlm (see +http://www.synacklabs.net/projects/crypt-ml/). It is essential to use +at least version 0.3.4. +gpg-ezmlm will handle your incoming and outgoing mails. It does not +support all the features of ezmlm-idx, but it should suffice for the +specialized needs of encrypted communication for small groups. + +Install the perl module Mail::Ezmlm::Gpg to access gpg-ezmlm. You can +downloaded it from +https://systemausfall.org/toolforge/ezmlm-web/downloads/gnupg-support. + +Of course, you also need gnupg (it is required by gpg-ezmlm, too). + + +2) Installation +Follow the instructions in the README file of gpg-ezmlm. +Usually it should boil down to the following commands: + perl Makefile.PL + make + make install + + +3) Setup of ezmlm-web +The location of the encryption configuration file for ezmlm-web depends +on the location of your ezmlmwebrc file. ezmlm-web will just check, if +a file prefixed with ".gnupg" exists besides ezmlmwebrc. +In short: you have to put it into the same directory, as you placed your +ezmlmwebrc. ezmlm-web will NOT look into any other location. + +To support the setup of encrypted mailing lists, you have to include the +following lines in your ezmlmwebrc.gnupg file. + use Mail::Ezmlm::Gpg; + GPG_SUPPRT = yes; + +4) Notes +As soon as you installed all the necessary programs and after you did put +the ezmlmwebrc.gnupg to the right location, you will find a new link in the +navigation bar of ezmlm-web named "Encryption". + diff --git a/ezmlmwebrc.gnupg b/ezmlmwebrc.gnupg index 1669f1e..42ca7d7 100644 --- a/ezmlmwebrc.gnupg +++ b/ezmlmwebrc.gnupg @@ -1,4 +1,8 @@ # sample configuration file for encrypted mailing list support +# You do not need to change anything, if you do not want to +# manage encrypted mailing lists. See README.gnupg for details. + +# Put this file besides ezmlmwebrc (just suffixed with ".gnupg"). # BEWARE: enable the following line ONLY if you installed the # Mail::Ezmlm::Gpg module - otherwise ezmlm-web will not work! @@ -6,7 +10,6 @@ # turn support for encrypted mailing lists on or off # defaults to 0 (off) -# you MUST enable the "use" line above, if you turn on the gpg support +# you MUST enable the "use" line above, if you want to turn on gnupg support $GPG_SUPPORT = 0; -