G Suite Integration

In this article, we will explain how G Suite customers can connect their Google Directories to Curricula learner groups to efficiently manage program users(which we call Learners). Syncing a Curricula learner group with a G Suite account requires, first, that you configure the Google Directory settings and create a Service Account Key before connecting the directory to your Curricula learners group.   

Steps 1-4 will guide you through the G Suite configuration in Googles Cloud Console. Step 4.3 Will require you to log into Googles Admin Center. Step 5 explains how to connect your directory to Curricula. 

Step 1: Creating New Project

 Begin configuring your Google Directory by creating a new project in your Google Cloud Console. https://console.cloud.google.com/
  1. Sign into your Google Cloud Console. Click the “Projects" drop-down menu in the main navigation bar, then click "New Project".

  2. Give it a Curricula related name, for example, "Curricula Integration", then click "Create". 

Step 2: OAuth Consent

  1. Select APIs & Services from the 3 bar menu in the top left corner of the screen, Then select OAuth consent screen.

  2. Under User type select Internal, then click Create.

    Step 2 12

  3. Enter "Curricula" in the app name field.

  4. Select the "admin account" in the User Supported Email* field.

  5. Scroll down to Developer contact information and enter the Administrators Email address then click Save and Continue.

    Step 2 345

You do not need to Add OR REMOVE A SCOPE at this time. Move on to Step 3.

Step 3: Enable API's & Services and Create Credentials

  1. Select Enabled APIs & service under APIs & Services

  2. Click the + ENABLE APIS AND SERVICES button at the Top of the screen

    Step 3 2

  3. Search for Admin SDK API then select it in the list

    Step 3 4

  4. Click the ENABLE button.

  5. On the next screen select the CREATE CREDENTIALS button in the Top right corner of the screen.

  6. Under Credential Type, leave Admin SDK API selected in the drop down under Select an API*

  7. Check the button next to Application data

  8. Check the button next to No, I'm not using them then click NEXT.

    Step 3 678

  9. Under Service account details > Service account name - add "Curricula" then give it a description like "Curricula Directory Integration", then select CREATE AND CONTINUE

    Step 3.9 small

  10. Under Grant this service account access to project click the dropdown, type in "viewer" then select Viewer in the list, then click CONTINUE

    Step3 10

  11. We do not need to Grant user access to this service account, select DONE

Step 4: Create Scope and .JSON file to be used in Curricula

With Steps 1 - 3 complete, you will need to define and authorize the scope of access in your Google Admin Console before connecting your Google Directory to Curricula.

  1. Navigate to IAM & ADMIN from the 3 bars in the top left corner of the screen and select Service Accounts

  2. Copy the numerical string under OAuth 2 Client ID.

    step 4 2

  3. Open a new browser tab and log into the Google Admin Account admin.google.com

  4. In the menu bar in the top left corner of the screen expand Security > Access and data control > Select API controls

    Step 4 4

  5. Select MANAGE DOMAIN WIDE DELEGATION button at the bottom of the screen

  6. Click the Add New button then paste in the numerical string that was copied in Step 4.2

  7. In the OAuth scopes field copy and paste "https://www.googleapis.com/auth/admin.directory.user.readonly" with out the quotation marks then click AUTHORIZE

    Step 4 67

  8. Navigate back to IAM & ADMIN and select Service Accounts

  9. Select the Keys tab at the top then click the ADD KEY dropdown to select Create new key

  10. Select JSON under Key type, then select Create. This will start a download which will be used in Step 5.

Step 5: Configure Google Sync in Curricula

Now, with your Google Directory configured and Security Account Key saved, you are ready to connect the directory to your Curricula learners group.

Follow these steps to connect your Google Directory to Curricula:

  1. Sign into your Curricula account and navigate to Settings > Learners > Groups > Edit Groups > Management > Management Type and choose "Google Directory" as the management type and click "Update".

  2. Enter your Google domain into the "Domain" field on the configuration tab.

  3. Enter the email address of a user with administrator privileges into the "Admin User" field on the configuration tab.

    https://support.curricula.com/hs-fs/hubfs/GSuite Integration Article.png?width=688&name=GSuite Integration Article.png

  4. Open the service account's key (.json) file downloaded from previous steps in your preferred text editor application. Copy all the text and paste it into the "Key" field. Make sure to remove any extra blank lines added at the end when pasting, then click "Update".

If your connection is successful head over to the Syncing Options page to configure your sync settings.      

    You can contact us anytime by submitting a support request using the link below: