ClassLink Integration

KyberGate integrates with ClassLink using the OneRoster 1.1 standard to automatically sync your district's roster data — students, teachers, classes, and schools. This eliminates manual user management and keeps KyberGate in sync with your SIS.

Overview

The ClassLink integration provides:

• OneRoster 1.1 Sync — Automatic import of users, classes, schools, and enrollments
• SSO (Single Sign-On) — Students and staff log in to KyberGate using their ClassLink credentials
• Automated Roster Sync — Daily automatic sync keeps user data current as students enroll, transfer, or graduate

Prerequisites

Before setting up ClassLink integration, ensure you have:

1. A KyberGate Pro or Enterprise subscription (SSO is not available on Basic)
2. ClassLink admin access to your district's ClassLink tenant
3. OneRoster 1.1 API credentials from ClassLink (Client ID and Secret)
4. The KyberGate app registered in your ClassLink LaunchPad

Setting Up OneRoster 1.1 Sync

Step 1: Enable OneRoster in ClassLink

1. Log in to your ClassLink Admin Console
2. Navigate to Roster Server → Applications
3. Click Add Application and search for KyberGate
4. If KyberGate is not listed, click Add Custom Application
   • Application Name: KyberGate
   • OneRoster Version: 1.1
5. Generate API credentials (Client ID and Client Secret)
6. Copy the Base URL, Client ID, and Client Secret

Step 2: Configure in KyberGate

1. In the KyberGate admin dashboard, go to Settings → Integrations → ClassLink
2. Enter the following from ClassLink:
   • OneRoster Base URL (e.g., https://example.oneroster.com/ims/oneroster/v1p1)
   • Client ID
   • Client Secret
3. Click Test Connection to verify the credentials
4. A green checkmark confirms successful connection

Step 3: Configure Sync Options

1. Select Schools — Choose which schools to sync (or select all)
2. User Types — Select which roles to import: Students, Teachers, Staff, Administrators
3. Sync Schedule — Set the automatic sync frequency:
   • Every 6 hours (recommended)
   • Every 12 hours
   • Every 24 hours
   • Manual only
4. Conflict Resolution — Choose how to handle conflicts:
   • ClassLink wins (recommended) — ClassLink data overwrites local changes
   • KyberGate wins — Local changes are preserved
5. Click Save & Run Initial Sync

Step 4: Run Initial Sync

1. The initial sync imports all selected users, classes, and enrollments
2. Progress is shown in real-time with a count of imported records
3. A summary report shows: users created, updated, skipped, and any errors
4. Review the error log for any issues (usually duplicate emails or missing fields)

Setting Up SSO

Enable ClassLink SSO

1. Go to Settings → Authentication → SSO
2. Select ClassLink as the SSO provider
3. The integration uses your existing OneRoster credentials
4. Toggle Enable SSO Login to activate
5. Optionally, toggle Disable Password Login to force SSO-only authentication

Add KyberGate to ClassLink LaunchPad

1. In the ClassLink Admin Console, go to App Library
2. Search for KyberGate or add a custom SSO app
3. Configure the SAML/OAuth redirect URL provided in KyberGate settings
4. Assign the app to the appropriate user groups

Monitoring Sync Status

1. Go to Settings → Integrations → ClassLink → Sync History
2. Each sync shows: timestamp, duration, records processed, errors
3. Click on any sync entry to see detailed logs
4. Enable email notifications to receive alerts when a sync fails

Tips

• Start with one school — Test the sync with a single school before enabling district-wide
• Review before enabling SSO — Ensure all users synced correctly before switching to SSO-only login
• Check data quality — Common sync issues stem from missing email addresses or duplicate records in the SIS
• Sync timing — Schedule syncs for off-hours (e.g., 2 AM) to avoid any performance impact
• Role mapping — KyberGate maps ClassLink roles automatically: Teacher → Staff, Student → Student, Administrator → Admin

Troubleshooting

Related Articles

• Clever Integration Guide
• Managing Users and Roles
• Billing and Subscription Management