From b67d1c4229c2fa2e21af9a451eec16322e4ee204 Mon Sep 17 00:00:00 2001 From: Matthias Andreas Benkard Date: Mon, 2 Apr 2012 20:41:13 +0200 Subject: Rename README -> README.md. --- README | 72 ------------------------------------------------------------------ 1 file changed, 72 deletions(-) delete mode 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 100644 index 05b7176..0000000 --- a/README +++ /dev/null @@ -1,72 +0,0 @@ - - -# Mulky IMAP BrowserID Primary - -## Introduction - -This software provides a simple BrowserID primary (authenticating -party) based on an existing local IMAP server setup. Users use their -IMAP login and password to authenticate themselves as the owner of -their email address. - -The primary is implemented as a set of simple CGI scripts. - - -## Assumptions About Your E-Mail Setup - -This software assumes that email addresses can be resolved to user -names by way of `/etc/aliases` and that the user names provided -therein are identical to those accepted by your IMAP server for -purposes of authenticating. - -If this is not true for your setup, you will need to hack the source -code. - - -## Installation - -### Prerequisites - -The following CPAN modules need to be installed: - - * `CGI` - * `CGI::Fast` - * `CGI::Session` - * `common::sense` - * `Crypt::OpenSSL::RSA` - * `File::Slurp` - * `JSON` - * `MIME::Base64` - * `Mail::ExpandAliases` - * `Mail::IMAPTalk` - * `Modern::Perl` - * `Time::HiRes` - -### Key Setup and jQuery Download - -In order to generate an RSA private key and download necessary -third-party components, run `setup.sh`. - -`setup.sh` will also generate a `browserid.json` file and prompt you -to put it wherever your web server will be able to serve it as -`/.well-known/browserid`. **It is very important to do this now**, -because `browserid.org` will look at that location and *cache* the -response, even if it is just a 404. - - -## License - -Copyright 2012, Matthias Andreas Benkard. - -This program is free software: you can redistribute it and/or modify -it under the terms of the GNU Affero General Public License as published by -the Free Software Foundation, either version 3 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU Affero General Public License for more details. - -You should have received a copy of the GNU Affero General Public License -along with this program. If not, see . -- cgit v1.2.3