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

= Authenticate to Trac using Crowd

== Description

[[Image(crowd_rgb_blue.png, align=right, width=150px)]]

This plugin is a [http://www.atlassian.com/software/crowd crowd] auth store for AccountManagerPlugin. Crowd is a web service that handles identity management for web apps, a single sign-on and user identity tool. It is a paid service and proprietary licensed.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

=== Prerequisites

 * AccountManagerPlugin.
 * [pypi:simplejson 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 it before.
 1. Change to the directory containing `setup.py`.
 1. If you want to install this plugin globally, this will install this plugin to the Python path: `python setup.py install`.
 1. 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
}}}
 1. Configure 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:'''