CloudApps uses the ClassLink REST API to retrieve the latest rostering data directly from your Roster Server. CloudApps automatically refreshes this data daily, or you can perform a manual sync in a specific CloudApps Class to refresh the data immediately.
Step 1: Configure Roster Server Permissions in ClassLink
First, you'll need to add the CloudApps 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, select Apps → Add App.
4. Search for itopia CloudApps → click the + Add button for the app when it appears.
5. Once it's added, open the itopia CloudApps app and specify the permissions you wish to grant:
CloudApps 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 CloudApps
In order to assign your students to CloudApps Classes using their ClassLink identities, you'll need to configure Roster Sync in CloudApps to connect to your ClassLink organization.
1. Log into the CloudApps Admin Portal as a user with Editor or Owner permissions for your CloudApps District.
2. Navigate to the District Dashboard: click on the Settings tab
3. In the Configuration card, click Configure under Roster Sync Integration.
4. In the Roster Sync wizard, select ClassLink → 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, CloudApps will read some information from your ClassLink account and display it for validation. If everything looks correct, click Save.
Step 3: Publish CloudApps in ClassLink
Once you've configured the necessary access in the previous steps, you can publish the itopia CloudApps app for your students and teachers. The CloudApps app will automatically sign users into the CloudApps User Portal, where they can launch their CloudApps sessions for their assigned classes. Detailed documentation from ClassLink is available here.
Teachers and administrators will still need to sign in to the CloudApps 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 → click Add & Assign Apps.
4. Search the App Library for itopia CloudApps. When it appears, click Add.
5. Assign the application to your desired profile or group → click Save.
6. You can repeat steps 3-5 to publish the itopia CloudApps Admin Portal app for your teachers and administrators.
Your assigned users will now be able to launch CloudApps and will be automatically signed into the User Portal.
Assign Users to Classes in CloudApps
After completing the steps above, you'll be able to use Roster Sync to assign ClassLink users, groups, classes, or courses to Classes in CloudApps. 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 Now button.
You're done!