Library SSO + Classroom Rostering

☝️

Please Note

The Library integration can only exist for a user if there is no district-level integration. Similarly, if a user belongs to a district that is connected with your application, that district-level connection will take precedence over the Library connection. There are workarounds to this, though. If you're interested in exploring these concepts, please reach out to [email protected].

The Library integration is initiated at the classroom level, meaning teachers can explore the Clever Library and add Library applications for themselves as well as the students they teach. This gives you an opportunity to get your product directly into the hands of teachers and students!

Check out the Clever Library here! If you're curious about how teachers and districts interact with the Clever Library, you can take a look at this Help Center article

📘

Not sure if you're in the right place?

This page describes the specific integration type Library SSO/Rostering. If you are looking for an overview of how SSO works with Clever, see https://dev.clever.com/docs/sso-overview.

Library SSO/Rostering will work for your application if:

• You have an existing user registration/signup flow.
  • The Clever Library authorization flow can be seamlessly integrated into your registration steps, automating most of the field entry and creating a one-step (or near one-step) sign-up process.
• You have a way for teachers to create classes with rosters in your application and to provision accounts for their students.
  • This functionality would fit perfectly with the Library use case. You would just need to introduce an option to "Sync Classes via Clever". You could also choose to do this automatically!
• Your application can authenticate users based on limited information. Please note that student email is not available with this integration type.
  • You can refer to https://clever.com/schema to see which fields you have access to with the Library integration type
• You sell your product directly to teachers.
  • If you sell to districts or schools, the Library integration might not be a good fit for you since it is considered a "bottoms-up" integration where the teachers are authorizing connections instead of district administrators.
• You have a student experience.
  • Apps in the Clever Library are usually geared towards the classroom experience. While it is not a requirement to serve teachers and students, it is certainly an expectation with apps in the Library.
  • Please note that admins do not have access to Library integrations.

📘

Library must be free-ish!

Please note that it is a requirement for Library integrations to offer a free trial, demo, or freemium access.

What features are available with Library SSO/Rostering?

Testing Suite and Integration Guide

For the Library integration, you will find an Integration Guide along with a step-by-step testing wizard that allows you to quickly validate your integration.

Marketing Collateral

As part of your Library application listing, you'll have the opportunity to include some marketing collateral, including screenshots of your product. Please note that this marketing collateral is a requirement for Library Certification.

• A Library page that includes marketing collateral and teacher reviews. Check out the Clever Library here to see what this looks like.

Dashboard

• As a Clever application, you will be granted a developer dashboard where you can access basic SSO settings, credentials and application profile description fields
• You will not have access to SSO troubleshooting tools
  • With this access tier, you will not have the ability to troubleshoot SSO issues for production users through your dashboard. If you need assistance with troubleshooting for your users, you can rely on the Clever support team at https://support.clever.com.

Scopes and Field Access

One benefit of the Library integration is that you can receive rostering data free of cost, albeit in a limited capacity. This means, as long as the teacher has authorized the connection, you will receive access to the following:

• teacher first name, last name, email address, and Clever ID
• all sections associated with the teacher
• section names, subjects, and grades
• all students associated with a teacher
• student first name, last initial, and grade

🚧

Do you require emails?

Student email address is NOT available through the Library integration. If this is a requirement for your application, one workaround is to have students provide their email addresses upon the first login.

How much does it cost?

• Library SSO/Rostering is free of cost.

What's next?

If you are interested in setting up a Library integration, see Setting up Library SSO and Rostering.