Testing Clever Library SSO as an End User

Use this page to test your Clever Library SSO integration and confirm the Library-specific user flows work as expected.

Before you start

Read Testing Your SSO Integration first.

What to verify

As you test your Clever Library integration, confirm the following:

• the user’s name and email, when available, appear correctly in your UI
• a new authentication request from Clever overrides any existing session in your application
• your application includes a logout button
• if you support a student experience, teachers have a way to sync students
• student SSO works after a teacher authorizes the connection

Ways to test

Dashboard integration guide

Your developer dashboard includes an integration guide specifically for Clever Library testing.

You can find it at:

apps.clever.com/{app_short_name}/library/integration_guide

Replace {app_short_name} with your app’s short name.

This is the recommended place to start because it walks through the expected Clever Library flow step by step.

SSO Test Plan

Use the SSO Test Plan for a Library-specific testing checklist.

Test with a direct authorization link

You can also test with a direct authorization link:

https://clever.com/oauth/instant-login?client_id={YOUR_CLIENT_ID}&district_id=5b2ad81a709e300001e2cd7a

Test credentials:

• Teacher
  • Username: teacher1
  • Password: clever
• Student
  • Username: student1-1
  • Password: clever

Test native iOS callback handling

If you support a native iOS app for Clever Library, test the Safari-to-app handoff on iPadOS and iOS.

1. Test with your native app installed.
2. Test again without your native app installed.
3. Confirm the installed-app case opens your native app already authenticated.
4. Check your backend logs for duplicate exchanges of the same authorization code.

If you see the same code processed twice and the second attempt returns invalid_grant, both Safari and the native app may be handling the same callback URL. Make your callback handling duplicate-safe before certification.

Sandbox districts

Only test Clever Library against the Clever-managed sandbox district used for Library testing.

The test options above already use the correct sandbox context. Do not test your Clever Library integration against other sandbox districts.