Google Application Guide

Last modified on September 11, 2023 at 5:55 pm

Overview

This guide shows you how to create a login application on Google that allows students to log in to DigitalChalk with their Google account.

Create a Google Application

  1. Go to http://code.google.com/apis/console  and log in with your normal Google account.  Your account must have permission to create application for your Google Domain.
  1. The Google APIs Console page is displayed.
  1. If necessary, change your organization from “No Organization” to your Google Domain organization by selecting your organization in the organizations dropdown list.
  1. Click the Create Project button.
  2. The New Project page is displayed.
  3. Enter a name for your project in the Project Name field.
  4. Verify that the Organization and Location fields match your Google Domains account.
  5. Click the Create button.
  6. The Manage Resources page is displayed.
  1. Click on the name of your new project in the list.
  2. The Details page for your new project is displayed.
  1. Click on the Navigation Menu button (the three lines in the top left corner next to “Google APIs”).
  2. Click APIs & Services from the task list on the left, then, click Credentials from the expanded list.
  3. The Credentials page is displayed.
  1. Click on the Create Credentials button.  Select OAuth Client ID from the dropdown list.
  2. The Create OAuth Client Id page is displayed.
  3. Click on the Configure Consent Screen button.
  4. The Consent screen page is displayed.
  5. Select a contact email from the Email Address list.
  6. Enter a name of your choosing in the Product Name field.  This name is shown to users when they log in to DigitalChalk with their Google account.
  7. [Optional] Fill out the Homepage URL, Product Logo, and Privacy Policy URL fields if you wish.
  8. Click on the Save button.
  9. The Create OAuth Client Id page is displayed.
  1. Select Web Application under Application Type.
  2. Enter a name for this client in the Name field.  This name is for your analytics tracking and is not displayed to students.
  3. Under Restrictions > Authorized Javascript Origins, enter “https://[your virtual host].digitalchalk.com”, replacing “your virtual host” with your DigitalChalk host name.  For example, https://wayne.digitalchalk.com.  Be sure to press enter after you fill out this field.
  4. Under Restrictions > Authorized Redirect URIs, enter “https://[your virtual host].digitalchalk.com/dc/signin/google”, replacing “your virtual host” with your DigitalChalk host name.  For example, https://wayne.digitalchalk.com/dc/signin/google.  Be sure to press enter after you fill out this field.
  5. Click the Create button.
  6. The OAuth Client popup will be displayed.
  1. Copy the Client ID and Client Secret displayed.  You will need them later when you configure the login on DigitalChalk.
  2. Click the OK button to finish the setup.
 
 

Configuring DigitalChalk to Use Your Google Application

In DigitalChalk, do the following:

  1. Click the Administration tab, then click My Organization from the System Management list.
  2. The Edit Organization Details page is displayed with a task list.
  3. Select Login/SSO from the task list.
  1. The Login Settings page is displayed.
  2. The button under Form Login should say Activated.  If not, click the Activate button under the Form Login section.  Form Login is activated by default.
  3. Click on the Configure link under the Form Login section.
  1. The Form and Social Login page is displayed.
  2. Click the Configure link under the Google section.  (Note: If you have previously configured Google, the link will say “Settings” instead.)
  1. Enter the Client ID from the Google OAuth Client popup for the Application ID, the Client Secret from the Google OAuth Client popup for Application Secret.
  2. For descriptions of other settings shown here, see Configuring Social Sites for Your Organization.
  3. Click the Save button when you finish entering information for your Google application.
  4. The Form and Social Login page is shown again.
  1. Click the activation toggle in the Facebook section of the Form and Social Login page.  This enables students to use your new Google application to log in to DigitalChalk
You have completed creating Google login for your DigitalChalk organization. Your students can now log in to DigitalChalk using their Google account. If you have any questions, please contact DigitalChalk support for assistance.

How Your DigitalChalk Google Login Looks to a Student

When students first log in to your DigitalChalk site with Google, they must approve the application through Google. The page shown here is a sample of what students see the first time they log into DigitalChalk from Google. The red boxes show how your settings are displayed on the Google approval page.