diff --git a/docs/backends/google.rst b/docs/backends/google.rst index aa1c970b7..1ef2dce52 100644 --- a/docs/backends/google.rst +++ b/docs/backends/google.rst @@ -6,6 +6,11 @@ This section describes how to setup the different services provided by Google. Google OAuth ------------ +.. attention:: **Google OAuth deprecation** + Important: OAuth 1.0 was officially deprecated on April 20, 2012, and will be + shut down on April 20, 2015. We encourage you to migrate to any of the other + protocols. + Google provides ``Consumer Key`` and ``Consumer Secret`` keys to registered applications, but also allows unregistered application to use their authorization system with, but beware that this method will display a security banner to the @@ -59,69 +64,72 @@ done by their Javascript which thens calls a defined handler to complete the auth process. * To enable the backend create an application using the `Google console`_ and - fill the key settings:: + following the steps from the `official guide`_. + +* Fill in the key settings looking inside the Google console the subsection + ``Credentials`` inside ``API & auth``:: + + AUTHENTICATION_BACKENDS = ( + ... + 'social.backends.google.GooglePlusAuth', + ) SOCIAL_AUTH_GOOGLE_PLUS_KEY = '...' SOCIAL_AUTH_GOOGLE_PLUS_SECRET = '...' -* Add their button snippet to your template:: + ``SOCIAL_AUTH_GOOGLE_PLUS_KEY`` corresponds to the variable ``CLIENT ID``. + ``SOCIAL_AUTH_GOOGLE_PLUS_SECRET`` corresponds to the variable + ``CLIENT SECRET``. + +* Create a new Django view and in its template add the Google+ Sign-In button::