Clever Integration

In this guide, we will walk you through the Clever Sync process and content assignment.
 
Help Video:  Watch the Help Video

Steps to Configure Clever Integration on the Studio Platform:

  • Login as Administrator
  • Access the Studio platform using your administrator credentials.

  • Create a Customer Group:
  • Navigate to the Customer tab.

  • Click on the +Group option.

  • Fill in the metadata, ensuring that the Client Group ID is unique and does not start with the word “clever” (must be alphanumeric).

  • Set Up SSO Source:
  • Select SSO Source as “Clever (Beta)”.

  • Enter the Clever data obtained from the Clever site, including:

    • District ID

    • Auth Token

    • Client ID

    • Client Secret

  • Add the Group:
  • Once all the required data is correctly filled, click the Add button.

  • Sync Data:
  • Return to the Customer tab.

  • Filter the data by Group and select the recently created district from the list.

  • Click on Sync all data-API. To track the synchronization status, check the Status option.

  • Generate Licenses:
  • After the data is properly synced, you can generate licenses for specific schools.

  • Distribute Content:
  • District/School administrators can now log in and distribute content to users.

Configure Redirection URL on Clever Site:

  1. On the Clever site, configure the redirection URL as follows: 
  2. URL, i.e. (https://microservices.kitaboo.com/v1/clever-management/clever/KITABOO_CLIENT_ID/CLEVER_CLIENT_ID/CLEVER_CLIENT_SECRET/clever/redirect)
  • Access Content:
  • Copy the Instant Login URL and provide it to students and teachers to access all assigned content.

District Guide:

Login as District Administrator

  • Access the Studio platform using your district administrator credentials.

Select School Account:

  • Select the school from the top right corner.

Assign Content:

  • Navigate to the Distribute Content tab.

  • Click on User or Class to distribute the respective content.

  • Select the users and Order ID.

  • Click on the Distribute button.

  • Revoke Content:
  • Navigate to the Users tab.

  • Select the user or class from which you want to revoke the content.

District/School FAQ:

Q1: Can district/school admins add new users or classes directly in Studio?

No, as it’s a Clever sync, user creation and updates need to be done in the Clever portal. You must request the main admin to resync the data in Kitaboo so that the district admin can see the latest roster changes.

 

Q2: Can district/school admins set/reset passwords for users in Studio?

No, since we use single sign-on with Clever, password management needs to be performed in the Clever portal. In Studio, they can only assign or remove content to/from users or classes and view the analytics reports for the content.

 

Q3: Can district admins delete users/classes using Studio?

Yes, but whenever an auto sync occurs, the users and classes will be recreated.

 

Q4: Can district/school admins assign content to users beyond the license limit?

No, they can only distribute content within the limits allocated by the main admin. If additional licenses are needed, they should reach out to the main admin to increase the license count.

 

Q5: Can district admins control the license count school-wise?

 

Yes, district admins can manage license counts from the “Distribute Content” tab by selecting the title from the order and managing it under the “More” section.

 
  • API Endpoints Used
  • /v3.0/schools

  • /schools/{schools_ID}/sections

  • /schools/{schools_ID}/users?role=teacher

  • /schools/{schools_ID}/users?role=student

What Roles Kitaboo Supports: