========================
TracGoogleAppsAuthPlugin
========================

Plugin for Trac which allows user authentication against hosted Google Apps account.

Features:

* Allows users to log in to Trac with their Google Apps username and password

* Assigns Trac groups to users based on their Google Apps groups

* Allows basic user info listing via Trac Account Manager

Author: David A. Riggs <david.riggs@createtank.com>


License
=======

Copyright 2010 createTank, LLC

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
Version 2 as published by the Free Software Foundation.

http://www.gnu.org/licenses/old-licenses/gpl-2.0.html


Requirements
============

This plugin requires Trac (tested with 0.12), Google's gdata, and the Trac AccountManagerPlugin.

``$> sudo easy_install gdata``

``$> sudo easy_install https://trac-hacks.org/svn/accountmanagerplugin/trunk``


Installation
============

``$> sudo python setup.py install``

See contents of example 'trac.ini' file for Trac configuration.


Configuration
=============

Trac 'trac.ini' configuration::

	[account-manager]
	password_store = GoogleAppsPasswordStore
	
	[components]
	acct_mgr.api.accountmanager = enabled
	acct_mgr.web_ui.loginmodule = enabled
	createtank.trac.googleauth.googleauthplugin.googleappspasswordstore = enabled
	trac.web.auth.loginmodule = disabled
	
	[google_apps]
	domain = createtank.com
	admin_username = david.riggs
	admin_secret = TOP_S3CRET

Detailed documentation TODO...
