Skip to main content

Setting Up OIDC Authentication

This guide covers setup for both OIDC (OpenID Connect) and Schoolbox Authentication systems.

Clipboard now supports authenticating users with OpenID Connect (OIDC). This will allow you, where platforms support it, to remove the need for Students & Guardians to login each time they click a Clipboard link from within another platform you may be using - like Schoolbox.

Setting Up OIDC Authentication in Clipboard

  1. Navigate to the Configure SSO Tab in your Clipboard Settings

  2. Scroll to the bottom and select Add Portal SSO Configuration

  3. Select OIDC

  4. Choose who it will be Enabled for

    • An optional label will be shown on the Portal login page

  5. Fetch your OIDC Provider's Issuer URL and paste it into the Issuer URL field. Do not include a / at the end of this URL (Schoolbox example further down)

  6. You should then be prompted with an autofill - confirm the details and agree

    • If we couldn't provide an autofill, search for the details at [Issuer URL]/.well-known/openid-configuration or contact your OIDC provider

  7. Test: A user can visit the portal and click the button

Set up steps in SchoolBox for OIDC Authentication.

  1. In Schoolbox admin mode, search for "OIDC" - it's the first result

  2. Click Add OAuth Client on the right (see screenshot below)

  3. For direct login to Activity Selection, we recommend using the name "Activity Selection"

  4. Add the redirect URI from the blue pop-up box shown when configuring OIDC in Clipbboard (see screenshot below).

Option to Bypass Login Screen for Users when Signing into the Portal

To provide your students and guardians with a streamlined login experience, use the login URL that appears on the configuration card after clicking Save.

This URL will allow Students and Guardians to skip the standard login screen and go directly to your school's authentication system.

If you want your users to be redirected to the Activity Selection Tab, add: &returnUrl=%2Factivity-selection to the end of your URL.

Frequently Asked Questions

Which platforms has Clipboard successfully set up OIDC Authentication with?

So far, we have successfully tested OIDC Authentication with Schoolbox, Cloudwork and Google.

While this feature is expected to work with any platform that supports OIDC Authentication, it still needs to be tested with each specific platform to confirm compatibility.

Are there any known requirements for OIDC Authentication?

Yes, the requirement is that the email stored in the Identity Provider's details must match the student's or guardian's email in Clipboard.

Did this answer your question?