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 # Click on *+ Enable APIs and Services*
  16 ## Search for *People API* and click on *Enable API*.
  17 # Navigate back to the main "APIs & Services" page
  18 # On the sidebar, click on *OAuth consent screen*
  19 ## On consent screen settings, enter your identifying details
  20 ## Under *Authorized domains* add @example.com@
  21 ## Click on *Save*.
  22 # On the sidebar, click on *Credentials*; then click on *Create credentials*&rarr;*OAuth Client ID*
  23 # Under *Application type* select *Web application*.
  24 # You must set the authorization origins.  Edit @auth.example.com@ to the appropriate hostname that you will use to access the SSO service:
  25 ## JavaScript origin should be @https://ClusterID.example.com/@ (using Arvados-controller based login) or @https://auth.example.com/@ (for the SSO server)
  26 ## Redirect URI should be @https://ClusterID.example.com/login@ (using Arvados-controller based login) or @https://auth.example.com/users/auth/google_oauth2/callback@ (for the SSO server)
  27 # Copy the values of *Client ID* and *Client secret* from the Google Developers Console and add them to the appropriate configuration.