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

= Trac Google Apps Authentication Plugin

== Description

This plugin allows a Trac site to authenticate users against a hosted Google Apps domain. It requires and uses the AccountManagerPlugin.

== Bugs/Feature Requests

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

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

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

== Download

This plugin can be found at the following locations:

http://pypi.python.org/pypi/TracGoogleAppsAuthPlugin/

http://code.google.com/p/tracgoogleappsauthplugin/

== Source

You can check out GoogleAppsAuthPlugin using [http://mercurial.selenic.com/ Mercurial] at the [http://code.google.com/p/tracgoogleappsauthplugin/source/checkout Google Code project], or [http://code.google.com/p/tracgoogleappsauthplugin/source/browse/#hg/src browse the source].

== Installation

After checkout or download, run the following command to install this plugin:
{{{#!sh
easy_install TracGoogleAppsAuthPlugin
}}}

== Example

Your `trac.ini` could look as follows to use this plugin:
{{{
#!ini
[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
}}}

== Recent Changes

[[ChangeLog(googleappsauthplugin, 3)]]

== Author/Contributors

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