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.

  1. The Google Developers Console page is displayed.

  1. Click the Create Project button.
  2. The New Project page is displayed.

  1. Enter a Project Name. This should be a name that students will recognize, such as your company name, since it is displayed on the page students see when they first log in to DigitalChalk using Google.
  2. The value in the Project ID field is created by Google. You do not need to change it.
  3. Check the I have read and agree to all Terms of Service for the Google Cloud Platform products checkbox.
  4. Click the Create button.
  5. The Project Dashboard for your new application is displayed. This may take a minute or two.

  1. Click APIs & Auth from the task list on the left, then, click APIs from the expanded list.
  2. The APIs page is displayed.

  1. Make sure that Google+ API is turned ON. If it is OFF, click the OFF button to turn it on.
  2. Make sure that all other APIs are turned OFF.
  3. Click Consent screen from the expanded APIs & auth list.
  4. The Consent screen page is displayed.

  1. Choose an Email Address from the drop down list. Google will use this email to communicate any issues with this application.
  2. Enter a Product Name. The Product Name is displayed on the page the students see when they first log in to DigitalChalk using Google.
  3. The following fields are optional, but if you enter information in any of these fields, it is displayed on the page the students see when they first log in to DigitalChalk using Google.
    1. Enter the URL of your primary website (not your DigitalChalk website) in the Homepage URL field. The website is displayed as a link on the page the students see when they first log in to DigitalChalk using Google.
    2. Enter the URL to your company logo in the Product Logo field.
    3. Enter the URL to your company’s privacy policy, your company’s terms of service, and your company’s Google+ page if you have these.
  4. Click the Save button.
  5. Click Credentials from the expanded APIs and auth list.
  6. The Credentials page is displayed.

  1. Click Create new Client ID in the OAuth section.
  2. The Create Client ID page is displayed.

  1. Click the Web Application button for Application Type.
  2. Enter the following URL for Authorized Javascript Origins: https://[myvirtualhost].digitalchalk.com
  3. Replace [myvirtualhost] with your DigitalChalk virtual host (for example, https://wayne.digitalchalk.com).
  4. Enter the following URL for Authorized Redirect URIS: https://[myvirtualhost].digitalchalk.com/dc/signin/google
  5. Replace [myvirtualhost] with your DigitalChalk virtual host (for example, https://wayne.digitalchalk.com/dc/signin/google).
  6. Click the Create Client ID button.
  7. The Credentials page is displayed again, with your Google client ID.

You don’t need to enter any information here, but be sure to note the values of the Client ID field and the Client Secret field, as you will need them when you return to DigitalChalk to complete the setup of your Google application.

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 Social Apps from the task list.

  1. The Social Applications page is displayed.
  2. Click on the Google logo.

  1. The Edit Social Application for Google page is displayed.

  1. Enter the Client ID and the Client Secret from the Google Credentials page. Leave Project Namespace blank.
  2. Select Yes for “Would you like to active this social app for login?”. (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.
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.