django-googleauth 2.1

Callback URL

The callback URL is constructed from your preferred URL scheme, the domain at which your site is hosted, and the path where you mount the googleauth URL config in Django.

Let’s assume you are using HTTPS and have mounted the googleauth URL config at the root URL. Your callback URL would look something like:

https://<your-domain>/callback/

Okay, now let’s assume you are using HTTP and have mounted the googleauth URL config under /accounts/:

http://<your-domain>/accounts/callback/

Settings and configuration

The following settings should be placed in settings.py.

Add to INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'googleauth',
    ...
)

Add to AUTHENTICATION_BACKENDS:

AUTHENTICATION_BACKENDS = (
    'googleauth.backends.GoogleAuthBackend',
    ...
)

Required settings:

# client ID from the Google Developer Console
GOOGLEAUTH_CLIENT_ID = ''

# client secret from the Google Developer Console
GOOGLEAUTH_CLIENT_SECRET = ''

# your app's domain, used to construct callback URLs
GOOGLEAUTH_CALLBACK_DOMAIN = ''

Optional settings:

# callback URL uses HTTPS (your side, not Google), default True
GOOGLEAUTH_USE_HTTPS = True

# restrict to the given Google Apps domain, default None
GOOGLEAUTH_APPS_DOMAIN = ''

# get user's name, default True (extra HTTP request)
GOOGLEAUTH_GET_PROFILE = True

# sets value of user.is_staff for new users, default False
GOOGLEAUTH_IS_STAFF = False

# list of default group names to assign to new users
GOOGLEAUTH_GROUPS = []

URL routes

Add URL config:

urlpatterns = patterns('',
    ...
    (r'^auth/', include('googleauth.urls')),
    ...
)

googleauth doesn’t need to be mounted under /auth/, it can go anywhere. Place it where you see fit for your specific app.