= Script authentication for AccountManagerPlugin = == Description == Similar to normal HTTP Authentication, this plugin uses explicit URL parameters for transferring the username and password to a web script that implements the check and returns the authentication result in the HTTP response code and content. When possible, the users email address is transferred and set as well. == Bugs/Feature Requests == Existing bugs and feature requests for ScriptAuthPlugin are [report:9?COMPONENT=ScriptAuthPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=ScriptAuthPlugin&owner=Carsten new ticket]. == Download and Source == Download the zipped source from [download:scriptauthplugin here], check out [/svn/scriptauthplugin using Subversion], or [source:scriptauthplugin browse the source] with Trac. == Installation == * First make sure you have AccountManagerPlugin installed * Grab the source * Unpack the source * Change into the source directory that contains the `setup.py` file * Build an egg: {{{ python setup.py bdist_egg }}} * Copy the egg, found in `dist/` to the `plugins` directory of the desired trac environment == Configuration == Set the URL of the script that does the authentication: {{{ [account-manager] # password_store = ScriptAuthStore # When using ScriptAuthStore alone. password_store = HtPasswdStore,ScriptAuthStore script_auth_url = http://www.example.com/my_auth.php?u=&p= }}} Note the two placeholders '''''' and '''''' in the `script_auth_url`. Type them exactly like this in order to have them automatically replaced by the appropriate user details. The script at `script_auth_url` is expected to return `ok` followed by newline followed by the email address of the user as the HTTP content when the user details are valid, or anything else otherwise. (The HTTP result codes like 200 and 401 can unfortunately not (easily) be utilized with Python <= 2.4.) An example for a script that implements authentication against the phpBB forum database is available [http://www.phpbb.de/community/viewtopic.php?p=1155503#p1155503 here]. It is useful when you cannot use the PhpBbAuthPlugin directly, e.g. because the phpBB database is not accessible from your Trac host. == Recent Changes == [[ChangeLog(scriptauthplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:Carsten] [[BR]] '''Maintainer:''' [wiki:Carsten] [[BR]] '''Contributors:''' http://www.cafu.de