Technical Prerequisites

Classera Educational Partners

Integration

Technical Prerequisites and Options for Third-Party Partners

Data Sync

API Integration

Secure SSO

Executive Summary

Integration Goal

Enable secure data synchronization and seamless Single Sign-On (SSO) between Classera and partner platforms for enhanced educational experiences

Three Integration Paths

IMS Global Standards

• OneRoster CSV 1.1 (Certified)

• OneRoster API 1.1 (Certified)

• LTI 1.0 & 1.3 (Certified App)

• Includes Deep Linking, NRPS, AGS

Custom API Sync

• Auto & Manual sync modes

• JSON or GraphQL support

• Webhook status notifications

• Batch inquiry & tracking

Content Provider API

• JWT-based authentication

• Content ingestion API

• Digital Library integration

• Audience-targeted delivery

SSO Authentication Options

LTI Core (1.0 & 1.3 certified)

SAML with metadata generation

Login with Classera (mobile optimized)

Standard SSO redirect flows

Key Outcomes

Faster partner onboarding

Secure roster & grade exchange

Scalable content launch experiences

Standards-based interoperability

IMS Global Standards: Overview

Classera offers three certified IMS Global integration methods for seamless interoperability

✓ IMS Certified

OneRoster CSV 1.1

Batch-based roster exchange via IMS-compliant CSV files

Classera generates CSV files per school with all roster data

Partner provides secure upload mechanism

Optional SSO via SAML or LTI

Ideal for scheduled provisioning and simple onboarding

✓ IMS Certified

OneRoster 1.1 API

Certified REST API for real-time roster synchronization

API endpoints for get, update, and insert roster events

Standards-based interoperability with near real-time updates

SSO provided via SAML or LTI with user claims

Best for dynamic rosters and continuous sync needs

✓ IMS Certified App

LTI 1.0 & 1.3

LTI Core (1.0 & 1.3 certified)

Deep Linking (1.0 & 1.3) for seamless content launch

Names & Role Provisioning Services (NRPS 1.3)

Assignment & Grade Services (AGS 1.3)

Standards-based SSO and tool provider integration

OneRoster 1.1 API – Deep Dive

✓ IMS Global Certified

What It Is

OneRoster 1.1 API is an IMS Global-certified REST API integration that enables real-time roster synchronization between Classera and partner systems. Classera exposes standardized API endpoints that partners can consume to retrieve, update, and insert roster data, supporting core roster objects and tracking changes over time.

How It Works

API Endpoints: Classera provides RESTful endpoints for GET, POST, PUT, and DELETE operations on roster resources

Standards-Based: Supports core OneRoster entities (orgs, users, courses, classes, enrollments, academic sessions)

Event Tracking: Partners can query roster changes and incremental updates over time

SSO Integration: Optional authentication via SAML or LTI with standard user claims

Key Benefits

Near Real-Time Updates: Immediate synchronization of roster changes as they occur

Standards-Based Interoperability: Certified compliance ensures seamless integration

Flexible Data Access: Query specific resources or retrieve complete roster datasets

Change Tracking: Monitor and sync only modified records for efficiency

SSO Claims Provided

UserId

UserFirstName

UserLastName

UserEmail

UserRole

Key Considerations

Handle pagination and rate limiting according to partner policies

Implement retry logic with exponential backoff for resilience

Ensure idempotency for PUT/POST operations to prevent duplicates

Map OneRoster entities to partner\'s internal data model accurately

LTI 1.0 & 1.3 – Deep Dive

✓ IMS Global Certified App

Certified Capabilities

Learning Tools Interoperability (LTI) provides standards-based authentication and content launch between Classera and partner tools. Classera is certified for both LTI 1.0 and 1.3 with advanced features:

LTI Core (1.0 & 1.3)

Deep Linking (1.0 & 1.3)

NRPS (1.3)

AGS (1.3)

Partner Requirements

Initiate Login URL – OIDC authentication endpoint

Public JWK Set URL or Public PEM Key for token validation

Target Link URI – Tool launch destination

Public Key ID (KID) – If using JWKS URL

Deep Link URLs – If sharing content (Launch URL & URI)

Accept Type: ltiResourceLink; Target: iframe

Classera Configuration

Platform ID

https://partners.classera.com

Parnter Client ID (Generated from Classera)

633bee3627bc5

JWKS URL

https://partners.classera.com/.well-known/jwks

Access Token URL

https://qa-api-1.classera.com/login/oauth2/token

OICD Auth URL

https://partners.classera.com/oidc/login

OIDC Parameters

login_hint: Passes Partner ID for authentication context

lti_message_hint: Recognizes message type (LtiDeepLinkingRequest or LtiResourceLinkRequest)

iss: Issuer identifier (Platform ID)

target_link_uri: Final destination after authentication

Custom API: Authentication & Data Sync

Auto Sync Mode

Manual Sync Mode

1

Authentication API

Partner provides Classera with an authentication API endpoint for secure access and token generation.

Required: API endpoint, authentication method (OAuth 2.0, JWT, API Key)

2

Data Sync API

Partner provides an API endpoint where Classera posts roster data (schools, students, teachers) in JSON or GraphQL format.

Supports: JSON arrays, GraphQL mutations, batch processing

3

Webhook for Sync Status

Classera offers a webhook API to notify partners about sync batch status, completion, and errors in real-time.

Provides: BatchId, status updates, error details, timestamp

4

Batch Inquiry Endpoint

Partner provides an endpoint for Classera to query the status and processing results of sync batches sent in Step 2.

Returns: Processing status, success/failure counts, error logs

5

User Redirection URL (SSO)

Partner provides a redirect URL enabling seamless Single Sign-On from Classera to the partner platform.

Includes: User claims (ID, name, email, role), session token, return URL

6

Synced/NotSynced Objects

Partner provides an endpoint returning synced and not-synced object details by BatchId, including object counts and identifiers.

Enables: Reconciliation, retry logic, audit trails, data validation

Benefits: Maximum Flexibility

Custom API integration offers bespoke workflows, flexible data formats (JSON/GraphQL), detailed batch status tracking, and rapid iteration for unique business requirements. Ideal for partners with specific data schemas or complex sync logic.

Content Provider API Integration

Content Ingestion

Purpose

The Content Provider API enables educational content partners to seamlessly integrate their resources into Classera\'s Digital Library. This integration allows partners to push their content catalog with metadata, making it discoverable and accessible to students and teachers based on school context and user roles. Content is automatically organized and presented in the Digital Library with partner-specific branding and configuration.

How It Works

Authentication: Partner provides an Authentication API with JWT token support for secure access

Content Sync: Classera calls partner\'s Get Content API with JSON payload containing school data and user level (student/teacher/admin)

Response: Partner returns content catalog with metadata (title, description, grade level, subject, resource type, thumbnail, access URL)

Audience Targeting: Content can be filtered by user role, grade level, subject area, and school context

Delivery Mechanism

Content appears in Classera\'s Digital Library interface with organized categorization

Partner-specific configuration supported (branding, featured content, custom sections)

Real-time or scheduled updates to keep catalog fresh and relevant

Users click content to launch in iframe or new window based on partner preference

Use Cases

Catalog Ingestion: Import entire content library with searchable metadata

Dynamic Recommendations: Context-aware content based on user role, grade, and subject

Licensed Resources: Access control for premium or subscription-based content

Interactive Content: Games, simulations, videos, assessments, and interactive activities

OER Resources: Open educational resources and free learning materials

SSO Methods: Comparison

Choose the authentication method that best fits your integration needs

Feature / Method

LTI 1.0 & 1.3

IMS Certified

SAML

Enterprise SSO

Login with Classera

Mobile SSO

Standard SSO

Redirect-based

Standards-Based

Content Launch

Deep Linking

Grade Passback

Enterprise IdP

Best Use Case

Education tool providers needing rich integration (content, rosters, grades)

District/organization-wide SSO with centralized identity management

Mobile app authentication with optimized user experience

Simple partner-specific redirect SSO flows

Technical Requirements & Config Details

Complete checklist of technical inputs and configurations for each integration method

LTI 1.3 Partner Inputs

Initiate Login URL: OIDC authentication initiation endpoint

Target Link URI: Landing page after authentication

Public JWK Set URL or PEM Key: For signature verification

Public Key ID (KID): If using JWKS URL

Deep Link Launch URL/URI: For content sharing (if applicable)

Accept Type: ltiResourceLink

Presentation Target: iframe

Classera LTI Configuration

Platform ID

https://partners.classera.com

Parnter Client ID (Generated from Classera)

633bee3627bc5

JWKS URL

https://partners.classera.com/.well-known/jwks

Access Token URL

https://qa-api-1.classera.com/login/oauth2/token

OICD Auth URL

https://partners.classera.com/oidc/login

OneRoster CSV Requirements

Upload Endpoint: Secure mechanism for CSV file uploads

Schedule: Define upload frequency (daily, weekly, on-demand)

File Validation: CSV structure and data validation rules

Error Reporting: Feedback channel for processing errors

OneRoster API Requirements

Endpoint Access: Consume Classera REST endpoints

Operations: Support get, update, insert events

Pagination: Handle large datasets with proper pagination

Entity Mapping: Map OneRoster entities to partner system

Custom API Sync Requirements

Auth API: Partner authentication endpoint

Data Sync API: Accept JSON or GraphQL arrays

Webhook: Receive sync status from Classera

Batch Inquiry: Endpoint for batch status queries

Redirect URL: SSO user redirection endpoint

Sync Status: Synced/NotSynced objects by BatchId

Integration Process & Next Steps

A streamlined 7-step journey from initial request to production deployment

1

Submit Integration Request

Complete the online integration request form to initiate the partnership process.

https://portal-stg.classera.com/en/cpartners/integration-request

2

Discovery & Scoping

Work with Classera team to select the best integration method for your needs.

Options: IMS Global Standards, Custom API Sync, or Content Provider API

3

Sandbox Setup

Exchange authentication keys, metadata, and configure API endpoints in a test environment.

Includes: LTI keys, JWKS URLs, SAML metadata, webhook endpoints

4

Build & Configure

Implement data sync logic and SSO integration according to technical specifications.

Implement: Roster sync (CSV/API), SSO (LTI/SAML), error handling, logging

5

Test & Validate

Verify roster data accuracy, SSO launches, user roles, and grade passback functionality.

Test: Data integrity, role mapping, AGS (if applicable), error scenarios

6

Pilot Deployment

Conduct limited rollout with selected schools for real-world validation and monitoring.

Monitor: Sync performance, webhook notifications, batch status, user feedback

7

Go-Live & Support

Launch to production with full documentation, operational runbook, and ongoing support channels.

Deliverables: Runbook, technical contacts, SLAs, escalation procedures

Partnership Success

Our structured integration process ensures smooth onboarding, minimizes risks, and provides continuous support. Average integration timeline: 4-8 weeks depending on complexity. Dedicated technical account manager assigned throughout the process.

Benefits by Integration Method

Compare the advantages and ideal use cases for each integration approach

Comparison

OneRoster CSV

Batch Upload

OneRoster API

Certified

LTI 1.0/1.3

Certified

Custom API Sync

Auto/Manual

Content Provider API

Digital Library

Key Benefits

Simple, low barrier, predictable batches

Near real-time, standards-based interoperability

Seamless SSO, Deep Linking, NRPS, AGS for richer experiences

Maximum flexibility (JSON/GraphQL), bespoke workflows

Streamlined content ingestion with audience targeting

Best Use Case

Scheduled provisioning with low change frequency

Dynamic rosters requiring frequent updates

Educational tools needing content launch and grade exchange

Rapid iteration, custom data models, detailed batch status

Content catalog ingestion to Digital Library

Update Frequency

Batch (daily, weekly)

Near real-time

Session-based launch

Configurable (auto/manual)

On-demand

Complexity

Easy

Medium

Advanced

Easy

Key Advantage

Quick setup, minimal technical requirements

IMS Global certified, industry standard

Rich features: content, rosters, grades in one

Unlimited customization, detailed tracking

Partner-specific Digital Library configuration

Get Started with Classera Integration

Ready to connect? Follow these simple steps to begin your integration journey

Submit Your Integration Request

Complete our integration request form to get started. Our technical team will review your submission and guide you through the setup process tailored to your needs.

Start Integration Request

Contact & Resources

Technical Contact: [email protected]

IMS Global Certifications: Search "Classera" on IMS Global certifications site

Helpful Resources:

LTI Documentation

Webhook API Guide

Flow Diagrams

OneRoster Specs

Your Next Steps

1

Choose Your Path: Select IMS Global Standards, Custom API Sync, or Content Provider API based on your technical needs

2

Submit Request: Complete the integration request form with your organization details and preferred method

3

Discovery Call: Schedule a technical kickoff meeting with our integration team

4

Sandbox Setup: Receive sandbox credentials and configure endpoints for testing

5

Build & Test: Develop integration, validate data sync and SSO functionality

6

Go Live: Launch to production with full support from Classera team

IMS GLOBAL CERTIFIED

Classera is certified for OneRoster CSV 1.1, OneRoster API 1.1, and LTI 1.0 & 1.3 with Deep Linking, NRPS, and AGS