SSO and Rostering Setup

Overview

Schools on the Campus plan can connect their identity provider (IdP) to LearnSpace for single sign-on (SSO) and automated class rostering. This reduces manual account management and ensures kaiako and tamariki can log in with their existing school credentials.

Prerequisites

Before you begin, ensure the following:

• Your kura is on the Campus plan
• You have admin access to your school's identity provider (e.g. Microsoft Entra ID, Google Workspace for Education)
• You have admin access to your LearnSpace dashboard

Setting Up SSO

Supported Protocols

LearnSpace supports SSO via:

• SAML 2.0 — for Microsoft Entra ID and other SAML-compliant providers
• OpenID Connect (OIDC) — for Google Workspace for Education

Configuration Steps

1. Navigate to Settings > Integrations > SSO in your LearnSpace admin dashboard
2. Select your identity provider from the list
3. Download the LearnSpace service provider metadata file
4. In your IdP admin console, create a new enterprise application (or OIDC client) and upload the metadata
5. Copy the IdP metadata URL (or upload the IdP metadata XML) back into LearnSpace
6. Click Test Connection to verify the integration
7. Once verified, enable SSO for your kura

Troubleshooting SSO

• Ensure your IdP metadata URL is publicly accessible or that you have uploaded the XML file directly
• Check that user email addresses in your IdP match the emails used in LearnSpace
• If login fails, review the error code shown on the login screen and consult our SSO troubleshooting guide

Automated Class Rostering

How Rostering Works

Once SSO is configured, you can enable automated rostering to sync classes and student assignments from your school management system (SMS) into LearnSpace.

LearnSpace pulls roster data on a nightly schedule, so changes made in your SMS are reflected the following day.

Enabling Rostering

1. Navigate to Settings > Integrations > Rostering
2. Connect your SMS or directory source (supported: Microsoft School Data Sync, Google Classroom)
3. Map your school's class structure to LearnSpace year groups
4. Select which classes and year groups to sync
5. Click Enable Sync

What Gets Synced

• Kaiako assignments to classes
• Tamariki names and class memberships
• Year group mappings

Roster sync does not overwrite any custom groups or app assignments you have created manually in LearnSpace.

Support

If you need assistance configuring SSO or rostering, contact our technical team at support@learnspace.nz. We can arrange a screen-sharing session to walk through the setup with your IT administrator.