Readme for Prasi 1.4 (22-january-2007)

This file explains

what Prasi is
how to install it
how Prasi works with OpenID
how to contact the author
credits

Prasi is licenced under GPL2 -- please read licence.txt if you are unfamiliar with the provisions laid out in it.

1. What is Prasi?

Prasi is an authentication framework with full user data management for Perl or PHP web applications. Enabled services can save and share user profile data and can be on different servers. Available in 10 languages, compatible with OpenID.

The main reason you might want to use Prasi is because you want to install Wefis, and Wefis requires Prasi.

THIS RELEASE IS PROVIDED WITH NO GUARANTEE OF CORRECT FUNCTIONING. In particular, numerous bugs may still exist. USE THIS SOFTWARE AT YOUR OWN RISK.

2. How to install Prasi.

Prasi is not meant to be particularly easy to install. In fact, only people who have considerable experience in installing and maintaining complex CGI programs should install this version. Bear in mind that there is no warranty of any kind. Make backups.

If you have a cgi-bin -based system, put *.cgi and *.pl in a web-accessible cgi-bin directory, and *.html and *.png in a normal web-accessible directory. Otherwise if you don't have the cgi-bin requirement, you should put all the files in the same web-accessible directory.

(Do not use the translations provided in "other-languages" until Prasi is correctly installed.) Navigate with your browser (Firefox1.5+ or IE7+) to the file 'prasi_installer.cgi'. Follow the on-screen instructions.

Important: If you are upgading from a previous version, read the notes on the website to find out how you retain your old settings and data during the upgrade process. Upgrading from versions before 0.6 is not recommended or supported as the data-tree file formats are different and incompatible. Note that the file 'config.pl' will be updated with each upgrade; this is normal. Do not attempt to restore an older version of this file, otherwise Prasi may malfunction.

Note: Using the language packs in the "other-languages" directory requires an appropriately configured server. Always test Prasi without them first.

3. Prasi and OpenID

On the login page you will notice the optional OpenID field. The very first time you login to Prasi, you must use the username/password combination. Then go to your settings and specify your OpenID settings, and 'enable' the functionality. Only after you do this, you can then login to Prasi using only your OpenID -- you will no longer need your username/password combination. Using OpenID in this way is as secure as using Prasi in the 'normal' way.

4. Contact us.

Please report bugs at http://prasi.sourceforge.net - all bug reports help us to improve Prasi.

Prasi is open source; if you have a contribution to make please use this address also. We welcome all those who wish to help; volunteer translators would be particularly appreciated.

5. Credits.

Code written by:
Prasi server: Aurelien Botman
PHP remote-client: Josh Owings (SykkN) and Brinley Ang Wefis integration: Francois Botman
OpenID integration: Brad Fitzpatrick (Net::OpenID modules) and Dave Holland (www.biff.org.uk/dave)

Translations kindly provided by:
English: default
Dutch: Benoît Liessens
French: Aurelien Botman
Finnish: Tatu Heikkilä (http://koti.mbnet.fi/tazca/) German: Richard Hartmann
Italian: Francesco Savoia (http://www.babboia.it) Norwegian: Leif Roger Kolberg (leifk at linuxmail dot org) Portuguese: Silvio M. Amâncio (silvio.amancio at poli.usp.br) Spanish: Alejandro Ravard
Thai: Kulathep Charoenpornwattana (TER,butter9@gmail.com,http://www.latech.edu/~kch020)