[[PageOutline(2-5,Contents,pullout)]]

= Configure Mod_WSGI Account manager

== Description

This plugin uses the AccountManagerPlugin to provide authentication to the Apache webserver.

== Bugs/Feature Requests

Existing bugs and feature requests for ModWsgiAcctmgrScript are 
[report:9?COMPONENT=ModWsgiAcctmgrScript here].

If you have any issues, create a 
[/newticket?component=ModWsgiAcctmgrScript new ticket].

[[TicketQuery(component=ModWsgiAcctmgrScript&group=type,format=progress)]]

== Download

Download the zipped source from [export:modwsgiacctmgrscript here].

== Source

You can check out ModWsgiAcctmgrScript from [/svn/modwsgiacctmgrscript here] using Subversion, or [source:modwsgiacctmgrscript browse the source] with Trac.

== Configuration

=== Single host

{{{#!apache
WSGIPythonPath /var/trac-0.11dev/lib/python2.4/site-packages
<VirtualHost *:80>
  ServerName hostname.domain
  <Location /svn>
    DAV svn
    SVNPath /srv/trac/svn/it
    AuthType Basic
    AuthName "Account Manager Auth"
    AuthBasicProvider wsgi
    WSGIAuthUserScript /path/to/script/acctmgr_auth.wsgi
    Require valid-user
  </Location>
</VirtualHost>
}}}

The `TRAC_ENV` and `PYTHON_EGG_CACHE` need to be modified and set inside the script.

=== Multiple hosts

'''First you need the patch from ticket #8525.''' The patch adds a function, that analyzes the REQUEST_URI and takes the part between TRAC_REQUEST_LOCATION and the next "/" as a part of the folder to the Trac environment.

Apache:
{{{#!apache
WSGIPythonPath /var/trac-0.11dev/lib/python2.4/site-packages
<VirtualHost *:80>
  ServerName hostname.domain
  <Location /svn>
    DAV svn
    SVNParentPath /srv/trac/repos
    SVNListParentPath Off
    AuthType Basic
    AuthName "Account Manager Auth"
    AuthBasicProvider wsgi
    WSGIAuthUserScript /path/to/script/acctmgr_auth.wsgi
    Require valid-user
  </Location>
</VirtualHost>
}}}

Settings of the acctmgr_auth.wsgi:
{{{
TRAC_REQUEST_LOCATION="/svn"
TRAC_ENV_PARENT="/srv/trac/envs"
PYTHON_EGG_CACHE="/path/to/eggs"
}}}

== Recent Changes

[[ChangeLog(modwsgiacctmgrscript, 3)]]

== Author/Contributors

'''Author:''' [wiki:pacopablo] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''