{ "info": { "author": "Jeremy Carbaugh", "author_email": "jcarbaugh@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "=================\ndjango-googleauth\n=================\n\nSimplified OAuth + OpenID Connect for authentication via Google.\n\ngoogleauth used to be REALLY simple, but then Google decided to get rid of their OpenID service. Boooo Google. googleauth has been migrated to `OAuth 2.0 + OpenID Connect `_, which isn't quite as great because it takes a bit more configuration to get going.\n\ngoogleauth was built to provide an easy way to add authentication against a Google Apps for Business domain, ideally for an individual organization. This package is not the best option if you are looking for a general social auth solution. Check out `python-social-auth `_ instead.\n\n\nGetting things set up on Google\n===============================\n\n#. Log in to the `Google API Console `_.\n\n#. Open an existing project or create a new one if needed.\n\n#. Under the *APIS & AUTH* menu item, click *APIs*.\n\n#. Turn on the Google+ API.\n\n#. Under the *APIS & AUTH* menu item, click *Credentials*.\n\n#. Click the *Create new Client ID* button.\n\n#. Select *Web application* for application type, add your domain as the JavaScript origin, and add the full domain and path to the OAuth callback (see below for how to find this URL). Click the *Create Client ID* button to finish.\n\n#. You're going to need the Client ID and Client secret values in Django settings, so keep this window open or copy them for later.\n\n\nCallback URL\n~~~~~~~~~~~~\n\nThe 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.\n\nLet's assume you are using HTTPS and have mounted the googleauth URL config at the root URL. Your callback URL would look something like::\n\n https:///callback/\n\nOkay, now let's assume you are using HTTP and have mounted the googleauth URL config under */accounts/*::\n\n http:///accounts/callback/\n\n\nDjango Setup\n============\n\nSettings and configuration\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe following settings should be placed in *settings.py*.\n\nAdd to *INSTALLED_APPS*::\n\n INSTALLED_APPS = (\n ...\n 'googleauth',\n ...\n )\n\nAdd to *AUTHENTICATION_BACKENDS*::\n\n AUTHENTICATION_BACKENDS = (\n 'googleauth.backends.GoogleAuthBackend',\n ...\n )\n\nRequired settings::\n\n # client ID from the Google Developer Console\n GOOGLEAUTH_CLIENT_ID = ''\n\n # client secret from the Google Developer Console\n GOOGLEAUTH_CLIENT_SECRET = ''\n\n # your app's domain, used to construct callback URLs\n GOOGLEAUTH_CALLBACK_DOMAIN = ''\n\n\n\nOptional settings::\n\n # callback URL uses HTTPS (your side, not Google), default True\n GOOGLEAUTH_USE_HTTPS = True\n\n # restrict to the given Google Apps domain, default None\n GOOGLEAUTH_APPS_DOMAIN = ''\n\n # get user's name, default True (extra HTTP request)\n GOOGLEAUTH_GET_PROFILE = True\n\n # sets value of user.is_staff for new users, default False\n GOOGLEAUTH_IS_STAFF = False\n\n # list of default group names to assign to new users\n GOOGLEAUTH_GROUPS = []\n\nURL routes\n~~~~~~~~~~\n\nAdd URL config::\n\n urlpatterns = patterns('',\n ...\n (r'^auth/', include('googleauth.urls')),\n ...\n )\n\ngoogleauth doesn't need to be mounted under */auth/*, it can go anywhere. Place it where you see fit for your specific app.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jcarbaugh/django-googleauth", "keywords": null, "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "django-googleauth", "package_url": "https://pypi.org/project/django-googleauth/", "platform": "any", "project_url": "https://pypi.org/project/django-googleauth/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/jcarbaugh/django-googleauth" }, "release_url": "https://pypi.org/project/django-googleauth/2.1/", "requires_dist": null, "requires_python": null, "summary": "OAuth 2.0 authentication for Google and Google Apps accounts", "version": "2.1" }, "last_serial": 1428728, "releases": { "2.0": [ { "comment_text": "", "digests": { "md5": "38f99be7c4e24b3edee1397ca50f71da", "sha256": "70fbace1bd32131c57637e8ddfd30e361333fb2bddd20b768860e90fc779eccb" }, "downloads": -1, "filename": "django-googleauth-2.0.tar.gz", "has_sig": false, "md5_digest": "38f99be7c4e24b3edee1397ca50f71da", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4749, "upload_time": "2014-06-24T16:52:42", "url": "https://files.pythonhosted.org/packages/76/0b/649410cc084bab8031f7101baf998674343ced6136228715c88fb1dc8a09/django-googleauth-2.0.tar.gz" } ], "2.1": [ { "comment_text": "", "digests": { "md5": "fcdeda45e548ce2c9da3209e3d7abb1f", "sha256": "a74ed0d5f18ed5e7da3aca1571d5d0018d8e23e72b667f052da4ff874fd21a83" }, "downloads": -1, "filename": "django-googleauth-2.1.tar.gz", "has_sig": false, "md5_digest": "fcdeda45e548ce2c9da3209e3d7abb1f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4779, "upload_time": "2015-02-18T17:18:37", "url": "https://files.pythonhosted.org/packages/4a/60/8ccf4512d4605a511faa57e722ccbaa060406d81b4c4f634db33f1be5633/django-googleauth-2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "fcdeda45e548ce2c9da3209e3d7abb1f", "sha256": "a74ed0d5f18ed5e7da3aca1571d5d0018d8e23e72b667f052da4ff874fd21a83" }, "downloads": -1, "filename": "django-googleauth-2.1.tar.gz", "has_sig": false, "md5_digest": "fcdeda45e548ce2c9da3209e3d7abb1f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4779, "upload_time": "2015-02-18T17:18:37", "url": "https://files.pythonhosted.org/packages/4a/60/8ccf4512d4605a511faa57e722ccbaa060406d81b4c4f634db33f1be5633/django-googleauth-2.1.tar.gz" } ] }