Overview

itopia Labs supports integration with ClassLink, a leading identity platform for K-12 education! With our integration, you can configure Labs Roster Sync to automatically assign students to specific Labs classes, and students can easily access their Labs sessions from their ClassLink LaunchPad.

Labs uses the ClassLink REST API to retrieve the latest rostering data directly from your Roster Server. Labs automatically refreshes this data daily, or you can perform a manual sync in a specific Labs Class to refresh the data immediately.

Setting up ClassLink integration is quick and easy! Follow the steps below to get started.

Step 1: Configure Roster Server Permissions in ClassLink

First, you'll need to add the itopia Labs app to your ClassLink Roster Server and grant the necessary permissions. Detailed documentation is available from ClassLink here.

1. Access your ClassLink LaunchPad with an administrator account
2. From the LaunchPad, open your Roster Server.
3. On the Roster Server navigation bar, click Apps.
4. Click the Add App button
5. Search for itopia Labs and click the + Add button for the app when it appears
6. Once it is added, open the itopia Labs app and specify the permissions you wish to grant:
   • Labs only needs permissions to the students, teachers, and other users you plan to assign using Roster Sync. You can also select the Course or Classes that contain the students and teachers; ClassLink will automatically grant permission to the users enrolled in those classes.

Step 2: Enable Roster Sync in Labs

In order to assign your students to Labs Classes using their ClassLink identities, you'll need to configure Roster Sync in Labs to connect to your ClassLink organization.

1. Log into the Labs Admin Portal (labs-admin.itopia.com) as a user with Editor or Owner permissions for your Labs District.
2. Navigate to the District Dashboard: Open the navigator (in the top-center of the screen), select the correct District from the drop-down menu (if you have access to more than one District), and click Manage District
3. In the Configuration card, click Configure under Roster Sync Integration
4. In the Roster Sync wizard, select ClassLink and click Next.
5. If you have already completed Step 1 in this article, you can simply click the Sign In With ClassLink button and sign into the popup window as a ClassLink administrator
6. Once you've signed in, Labs will read some information from your ClassLink account and display it for validation. If everything looks correct, click Save.

Step 3: Publish Labs in ClassLink

Once you've configured the necessary access in the previous steps, you can publish the itopia Labs app for your students and teachers. The Labs app will automatically sign users into the Labs User Portal (labs.itopia.com), where they can launch their Labs sessions for their assigned classes. Detailed documentation from ClassLink is available here.

Teachers and administrators will still need to sign into the Labs Admin Portal using a Google or Microsoft account.

1. Access your ClassLink LaunchPad with an administrator account
2. Launch your ClassLink Management Console (CMC) app.
3. In the Management Console navigation, expand Applications and click Add & Assign Apps.
4. Search the App Library for itopia Labs. When it appears, click Add.
5. Assign the application to your desired profile or group, and click Save.

Your assigned users will now be able to launch Labs and will be automatically signed into the User Portal.

Assign Users to Classes in Labs

After completing the steps above, you'll be able to use Roster Sync to assign ClassLink users, groups, classes, or courses to Classes in Labs. Once Roster Sync has been configured, you'll see the ClassLink interface in the New Class wizard, allowing you to select one or more ClassLink items to which the Class can be assigned:

Once you've created the Class, you'll see your ClassLink students listed in the Class Roster.

Roster Sync periodically updates the roster data from your Roster Server, but you can trigger a manual sync using the Sync button.