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 --------------------------------------------------------------- README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 72 insertions(+), 72 deletions(-) delete mode 100644 README create mode 100644 README.md 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 . diff --git a/README.md b/README.md new file mode 100644 index 0000000..05b7176 --- /dev/null +++ b/README.md @@ -0,0 +1,72 @@ + + +# 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