gpg-lacre/gpg-mailgate-web
perennate fbe2f1bba1 Update license to GNU GPL v3. 2013-10-02 14:27:28 -04:00
..
public_html Update license to GNU GPL v3. 2013-10-02 14:27:28 -04:00
README Update gpg-mailgate-web readme. 2013-09-28 17:07:10 -04:00
cron.py Update license to GNU GPL v3. 2013-10-02 14:27:28 -04:00
schema.sql Initial commit for gpg-mailgate-web addition. 2013-09-26 19:40:27 -04:00

README

gpg-mailgate-web
----------------

gpg-mailgate-web is a web interface designed to allow any web user
  to upload their PGP public key and then have all mail sent via
  your mail server be encrypted. (Note: this is not meant for email
  authentication, only encryption.)

After submitting their key to a web form, the user will be required
  to confirm their email address. A cron script will register the
  public key with gpg-mailgate (keyhome_only must be set to no
  currently, which is the default) after email confirmation. From
  then on, email to the specified address will be encrypted with
  the public key.

gpg-mailgate-web is useful for two purposes: for a transparent
  PGP encryption layer in front of any web application, or simple as
  a web interface for gpg-mailgate so that users on your mail server
  can easily upload and change their PGP keys.

Note that all processing relating to the mail server is done via the
  cron script. This means that gpg-mailgate and the gpgmw cron can
  be installed on a different server from the web server. The MySQL
  database must be shared between the two applications though.

Installation instructions:

  1) Install gpg-mailgate.
  2) Create a MySQL database for gpg-mailgate.
    a) Schema file is located in schema.sql
    b) Database name and account goes in /etc/gpg-mailgate.conf (and set enabled = yes)
  3) Copy the contents of public_html to your web directory.
  4) Move config.sample.php to config.php and edit the configuration file.
  5) Copy cron.py to /usr/local/bin/gpgmw-cron.py and set up a cron job
    a) Create /etc/cron.d/gpgmw with the contents:
    */3 * * * * gpgmap /usr/bin/python /usr/local/bin/gpgmw-cron.py > /dev/null
     (replace gpgmap with the owner of the gpg-mailgate GPG home directory)
  6) Ensure that cron is working and test your new gpg-mailgate-web installation!

Any issues should be reported to https://github.com/uakfdotb/gpg-mailgate