Testing - District SSO

Prerequisites

Read Testing Your SSO Integration

Testing District SSO integrations

What to look out for

  • Are the user's name and email visible in your UI?
  • If there is an existing user session in your application, does a new authentication request from Clever override that session?
  • Is there a logout button?

Ways to test

  • SSO Test Plan (RECOMMENDED)

  • Developer app dashboard shortcut

    As a feature that's only available with a developer account, you can simply type in a test user's name when in the context of a district. Once you select the user, you should find a "Log in as.." button in the top right corner.

    NOTE: This only works in your developer account and will not work in production if you don't have Secure Sync access.


  • Through impersonation of your sandbox district admin
    See the section below for more information about managing your sandbox district.

  • FOR SECURE SYNC SUBSCRIBERS ONLY
    You will have access to the Data Browser in your developer dashboard. From there, you can quickly test logins through the UI.
    Just click on a user's name in the Data Browser to pull up the "Detail View". In this view, you should find a "Log in as.." button in the top right corner of the pop-up modal.

Sandbox District

Default Sandbox District

📘

Have a sandbox district request?

Reach out to [email protected] with the following information:

  • Subject:
    • Request for access to default sandbox district
  • Body:
    • Development Account Client ID
    • App Name
    • An email address that is not yet associated with a Clever account.

Your developer account comes with an auto-generated sandbox district. By default, you will not have access to manage this sandbox district. While not required to actually test your integration, we can provide access to this sandbox district. All we'll need is an email address that is not yet associated with a Clever account. Once you have access, you can manage your sandbox district and test out the end-user experience of Clever using the following documentation:

User impersonation: https://support.clever.com/hc/s/articles/360000406146
Data browser: https://support.clever.com/hc/s/articles/202483068
Custom data: https://support.clever.com/hc/s/articles/360035757332
Uploading data: https://support.clever.com/hc/s/articles/202494408

The data set used for your default sandbox district can be downloaded here .

Custom Sandbox District

We do not create custom sandbox districts for non-Secure Sync integrations. If you need to customize your test data, please refer to the documentation above.


What’s Next

Once you're done testing, you can prepare for certification on the next page.