TracGoogleAppsAuthPlugin 0.2.1

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

To magically install from the PyPI,

$> sudo easy_install TracGoogleAppsAuthPlugin

… or from source,

$> sudo python setup.py install

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 = mydomainname.com
group_access = trac_users
admin_username = sysadmin
admin_secret = TOP_S3CRET

You can configure most (all?) of these settings from the Trac web-based Admin console. Essentially, if you already have the web-based TracAccountManager plugin enabled and working, just enable the GoogleAppsPasswordStore (under TracGoogleAppsAuthPlugin) and disable the other password stores HtDigestStore and HtPasswdStore (under TracAccountManager). You can then configure the plugin via the Accounts / Configuration menu of the Trac web-based Admin.

Future versions will allow multiple password stores to be enabled for fallback to other auth sources (this is currently disabled for performance).

Detailed documentation TODO…