aboutsummaryrefslogtreecommitdiff
path: root/README.txt
blob: 8d56e81904180f641e52ff6563bed0fcca871420 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
GPIGEON
========

Gpigeon generate links for a GPG user to be sent to a non technical person (or
not a GPG user) so they can send you encrypted mail messages via a one-time
web link.
Feels of déjàvu ? I was inspired by https://hawkpost.co but wasn't really
interested in the multi-user perspective and managing a database.

Dependencies
============

You need perl and the following modules and my perl version is v5.32.0, YMMV:

    * Net:SSLeay
    * Digest::SHA 
    * Email::Valid 
    * String::Random 
    * HTML::Entities
    * CGI (I'm planning on removing it, I use it just for the
    convenient param function.) 
    * CGI::Carp (primarly for debugging, comment the line in
    gpigeon-template.cgi if you won't need it)
    * Net::SMTP
    * Net::SMTPS
    * GPG

Having a webserver with CGI support or a separate CGI engine is needed. I'm using
nginx and fcgiwrap.
A note on Net::SMTP and Net:SMTPS dependencies: if you have a mailserver well
configured with OpenDKIM and the likes (so your chances to get your mail
treated as spam is greatly reduced) you could replace these two deps with
Mail::Sendmail then comment and uncomment some lines in <gpigeon-template.cgi>.


Installation
============

I'm currently making a install script for it but frankly if you look around in
the perl script source code you should figure things out quickly (hint: look for variables
values ending in 'goes_here').

##WIP##