With this integration, institutions can now take advantage of using Single Sign On (SSO), Google Drive, Google Meet and Google Calendar functions from inside Classe365.
To enable this feature follow these steps :
STEP-1: Login to Developer's Console.
Go to https://console.developers.google.com. Login with your Google Workspace or Google Account.
STEP-2: Create Project
Click on "New Project" to add a project.
Select the Project Created and use the button - "Open" to make it selected by default.
STEP-3: Enable API's
Ensuring that you have selected the project that you have just created. Click on "Library", and browse (filter) for API below and enable them.
Enable the following APIs
Calendar API
Picker API
Drive API
Google Classroom API
Example:
Similarly, find the "Calendar API" and enable it for calendar integration.
Google Classroom API to sync Google Assessments and Courses.
To know more about synchronizing courses in Google Classroom to Classe365's LMS use the below button.
STEP-4: Generate API Key
Go to Credentials tab and click on Create Credentials > API Key. Copy the API Key. This will be used later,
Copy the API key generated into another text document, we'll add this to Classe365 Apps Setting later.
After generating the API Key, if you find the warning icon as in the snapshot below, click on the API key.
Update the key restrictions to "Website", and "Add" URL of your domain.
Add your account link, and click "Save".
Ensure, there's a checkmark icon on the API Key.
STEP-5: Generate O-Auth Client ID
Click on Create Credentials > OAuth client ID
If you're creating O-Auth Client ID for the first time, then you need to configure consent screen. Google redirects you to the configure screen button.
In the next screen, you'll be asked to select "User Type" you need to choose either "Internal" or "External".
Internal - No verification required, but only the G-Suite emails (user emails) registered in your domain can use the project integration.
External - Emails registered by other domains (external users) can use the integration. Since, a school has users outside the domain, Classe365 recommends enabling this.
You'll have to select "External" for users to access your integration when the users are not in your contacts list.
5-A) Register an application in your project.
App Information
App Name - Can be the name of the application of your choice.
User Support Email - Organization support email or the email logged in.
App Logo - Optional
App domain
Application Home Page - the Classe365 account link (https://yourDomain.classe365.com)
Application Privacy Policy - https://www.classe365.com/classe365-privacy-policy
Authorized domains
Add "classe365.com" as your authorized domain.
For white-label subscribed users, you need to add your domain as well.
Developer Contact Information
Add "[email protected]" as the developer contact information.
5-B) Adding Scopes
When you ask users for permission to access their Google Account, Scopes let you specify the types of private data that your project will be able to access.
Click on "Add or Remove Scopes"
Add the following scopes:
Google Calendar/Google Meet:
Google Drive:
Google Class Room:
Google SOS Login
Here's a video demo on adding scopes
That's it, finally proceed to "Summary" tab and navigate back to dashboard.
Now, that the OAuth Consent Screen is set up, we'll have to submit the app for "Verification".
Just in case Google asks for "Justification" and a YouTube video explaining how scopes are being used in the application you can use the following link:
How will Scopes be used? | Classe365 needs to use scopes in Google Workspace because scopes define the level of access and permissions that an application has within a user's Google Workspace account. By using scopes, Classe365 can ensure that it only requests the necessary access to perform its intended functions, while also maintaining the security and privacy of user data. Scopes help Classe365 to adhere to Google's API policies and guidelines, providing a more seamless and secure integration with Google Workspace. |
YouTube Video Link |
Next, we'll need to generate the O-Auth Client ID.
STEP-6 Continue with Creating O-Auth Client ID
Go to Credentials > Create O-Auth Client ID
Authorized Javascript Origins
URL 1: https://<your_subdomain>.classe365.com
URL 2: Place your custom url here if you have enabled White Label
Authorized Redirect URI's should be "https://<your_subdomain>.classe365.com/users/login
For White Label enabled accounts, you can keep both "Classe365 URL" and "White Label URL", so Google SSO works fine in both the URLs.
After creating the O-Auth Client ID you'll get the Client ID and Secret Key
Consent Screen Configuration
Application Name: Classe365
Authorised domain - classe365.com
Use your https://tenant_name.classe365.com as your Homepage URL
STEP-7: Integrate in Classe365 App Settings
Login to Classe365 as admin and go to the Accounts > Organization Settings.
Apps > Google Apps
Insert the API Key, Client ID and Client Secret copied from Google Apps API Section and enable SSO, Calendar and Google Meet integration.
That's it for now, If you need any help on this please write us to [email protected]