ClassLink Integration
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
| Issue | Solution | |-------|----------| | Connection test fails | Verify Base URL, Client ID, and Secret are correct;
check for trailing slashes in the URL | | Users not importing | Ensure the selected schools have active enrollments in
ClassLink | | Duplicate users after sync | Check for duplicate email addresses in your SIS data | | SSO login fails |
Verify the redirect URL in ClassLink matches the URL shown in KyberGate settings | | Sync runs but no new users appear |
Check the user type filters — you may have deselected the relevant role | | Stale data after sync | ClassLink may be
caching old SIS data — trigger a fresh export in your SIS |
Related Articles
- Clever Integration Guide
- Managing Users and Roles
- Billing and Subscription Management