Skip to main content

Setting up single Sign-On (login with Google/Microsoft) (CSV schools)

Updated over 3 months ago

This article is intended for schools that import their classes and students via CSV (see this article if your school uses MIS import).

Single Sign-On (SSO) enables teachers and students to log in to multiple websites using one set of login details.

The main benefits of using SSO are:

  • It's simpler to get your students started with Sparx Maths, as they won't need to go through the process of setting up a new username and password

  • Password reset requests are likely to reduce, as students won't need to remember another username and password. This reduces interruption for students and saves you time.

Requirements

Before setting up SSO, ensure:

  • Your school provides Microsoft Office 365 or Google accounts to teachers and/or students

  • You have student emails ready to upload via CSV

  • Your school's technical contact will need to be involved in the setup process as they will be asked to approve our request to enable SSO for your school. Many schools provide their technical contact with a login in Staff Manager to help manage SSO settings.

Setup guide

Add your student email data

  1. Download our CSV template from the Sparx Maths site

  2. Ensure student email addresses are included in column 5 of your CSV

  3. Upload the CSV following our standard import process

  4. Check for any import errors and correct them as needed

Configure SSO settings

  1. Go to Management > School Settings > Single Sign-On (SSO)

  2. You will see a "problems found" message if any students are missing school addresses. Download the report to identify affected students so you can update your CSV with any missing or incorrect email addresses and re-upload

  3. Choose your SSO provider (Microsoft or Google)

  4. Enter your school's SSO domain (e.g., if [email protected] is your email format, enter example.com)

  5. Optionally enter a different domain for students if needed

  6. Enable SSO for teachers first and click 'Save'

Test teacher access

  1. Log out of Sparx Maths

  2. Attempt to log in using SSO

  3. Teachers will need to verify their email address the first time they use SSO (students will not need to do this step)

  4. The first SSO login attempt will trigger an approval request through your SSO provider - your school's Google/Microsoft administrator will need to approve this.

Enable Student Access

  1. Once teacher SSO is working, return to School Settings

  2. Enable SSO for students

  3. Choose whether to allow both SSO and username/password login, or SSO only

    • We recommend only allowing SSO to simplify the process for students and reduce teacher workload

Frequently Asked Questions

Will enabling SSO create new accounts for my students?


No, SSO simply provides another way to log in to existing accounts.

Can students still use their existing Sparx usernames and passwords?


Yes, unless you choose to disable username/password login.

What should we do if our SSO domain changes?


You'll need to:

  1. Temporarily disable SSO

  2. Update the domain in School Settings

  3. Update teacher emails in Staff Manager

  4. Update student emails by uploading a CSV with the new details

  5. Wait for the next sync or perform a manual sync

What does this look like from the student's perspective?


If you are only using SSO, students will see a screen similar to this one. Clicking the login button will direct them to a Google/Microsoft login page where they will need to enter their school login details. If they are already logged into their school account on their device, they will be directed straight to their account:
​

If you have both SSO and Sparx Maths logins enabled then students and teachers will be able to choose how they log in:
​

Did this answer your question?