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

= Trac Crowd Authentication Plugin

== Description

TracCrowdAuthPlugin is a [http://www.atlassian.com/software/crowd crowd] auth store for [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManagerPlugin]

== Bugs/Feature Requests

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracCrowdAuthPlugin&owner=richard new ticket].

== Download

Download the zipped source from [download:traccrowdauthplugin here].

== Source

You can check out TracCrowdAuthPlugin from [http://trac-hacks.org/svn/traccrowdauthplugin here] using Subversion, or [source:traccrowdauthplugin browse the source] with Trac.

== Installation

=== Prerequisites

 * [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManagerPlugin]
 * simplejson when using Python below 2.6

=== Installation steps

You can install this software as a normal Trac plugin.

 1. Uninstall TracCrowdAuthPlugin if you have installed before.

 2. Change to the directory containning setup.py.

 3. If you want to install this plugin globally, that will install this plugin to the Python path: `python setup.py install`

 4. If you want to install this plugin to Trac instance only:
  * `python setup.py bdist_egg`
  * Copy the generated egg file to the trac instance's plugin directory:
  {{{#!sh
cp dist/*.egg /srv/trac/env/plugins
}}}

 5. Config your `trac.ini` file:
  {{{
#!ini
[components]
acct_mgr.web_ui.loginmodule = enabled
acct_mgr.web_ui.registrationmodule = disabled
trac.web.auth.loginmodule = disabled

[crowdauth]
crowd_rest_base_url = http://crowdserver:8095/crowd/rest/usermanagement/latest/
crowd_realm = Crowd REST Service
crowd_useranme = trac
crowd_password = trac
crowd_group = trac_grp

[account-manager]
password_store = CrowdAuthStore
}}}

== Recent Changes

[[ChangeLog(traccrowdauthplugin, 3)]]

== Author/Contributors

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