doc/install/google-auth.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: installguide
   4 title: Setting up Google auth
   5 ...
   6 {% comment %}
   7 Copyright (C) The Arvados Authors. All rights reserved.
   8
   9 SPDX-License-Identifier: CC-BY-SA-3.0
  10 {% endcomment %}
  11
  12 In order to use Google for authentication, you must use the <a href="https://console.developers.google.com" target="_blank">Google Developers Console</a> to create a set of client credentials.
  13
  14 # Go to the <a href="https://console.developers.google.com" target="_blank">Google Developers Console</a> and select or create a project; this will take you to the project page.
  15 # On the sidebar, click on *APIs & auth* then select *APIs*.
  16 ## Search for *Contacts API* and click on *Enable API*.
  17 ## Search for *Google+ API* and click on *Enable API*.
  18 # On the sidebar, click on *Credentials*; under *OAuth* click on *Create new Client ID* to bring up the *Create Client ID* dialog box.
  19 # Under *Application type* select *Web application*.
  20 # If the authorization origins are not displayed, clicking on *Create Client ID* will take you to *Consent screen* settings.
  21 ## On consent screen settings, enter the appropriate details and click on *Save*.
  22 ## This will return you to the *Create Client ID* dialog box.
  23 # You must set the authorization origins.  Edit @auth.your.domain@ to the appropriate hostname that you will use to access the SSO service:
  24 ## JavaScript origin should be @https://auth.example.com/@
  25 ## Redirect URI should be @https://auth.example.com/users/auth/google_oauth2/callback@
  26 # Copy the values of *Client ID* and *Client secret* from the Google Developers Console and add them to the appropriate configuration.