Amira Learning works with ClassLink’s roster export and LTI single sign-on (SSO) features to support account provisioning and seamless logins for students and staff. This guide walks you through the steps required to configure ClassLink for use with Amira.
Step 1: Activate Your Amira Account
Before you can begin rostering, you’ll need to activate the Amira account that will be used to manage the SFTP connection.
-
Look for an email prompting you to set a password for your Amira account.
-
Once your password is set, go to secure.app.amiralearning.com and log in using that account.
-
During your first login, you’ll be asked to accept the Privacy Agreement, this must be completed before the account can be used for rostering.
Didn’t receive the email? You can reset your password using the "Trouble Logging In?" link on the login page.
Step 2: Configure ClassLink for Rostering (SFTP)
Amira requires roster files to be pushed from your ClassLink system in IMS Global OneRoster v1.0 or v1.1 format (7 to 8 CSV files). These files include students, teachers, classes, enrollments, and more.
SFTP Setup
To automate roster syncing, configure an export from ClassLink to the following secure SFTP destination:
-
Host:
sftp.rosters.app.amiralearning.com -
Port:
22 -
Username: Use your Amira district manager account, in the format
username_admin_district_state -
Password: Use the password you set for your Amira account
If preferred, you may create a new district-level manager account in Amira specifically for this connection.
Once your SFTP export is configured and a job has been sent, please notify the Amira team, we’ll finalize the connection and trigger the first import on our end.
Need help with SFTP setup? ClassLink Support is the best resource for guidance on configuring exports.
Canada - STFP Setup Guidance
To automate roster syncing, configure an export from ClassLink to the following secure SFTP destination:
-
Host:
sftp.rosters.ca.amiralearning.com -
Port:
22 -
Username: Use your Amira district manager account, in the format
username.admin.district.state-
-
Please note that the Canadian SFTP ONLY accepts periods in the username, no underscores
-
-
-
Password: Use the password you set for your Amira account
If preferred, you may create a new district-level manager account in Amira specifically for this connection.
Sharing Rules
We recommend limiting sharing to only the classes and users that will be using Amira Learning. This typically includes homeroom and/or Reading classes, but you’re welcome to adjust based on your district's structure.
Step 3: Set Up ClassLink LTI Single Sign-On (SSO)
Once your first roster sync has been completed, students and staff can log in to Amira directly from ClassLink using LTI v1.0-based SSO.
Steps to Configure SSO:
-
In the ClassLink Management Console (CMC), navigate to Applications.
-
Select Add & Assign Apps, then click Add.
-
Enter the following details:
-
Application Name: Amira Learning
-
Description: Optional, your choice
-
Icon: We recommend using the Amira logo
-
Category: Education
-
-
Toggle on Single Sign-On.
-
For Type, select LTI v1.0, then click Add.
-
Enter the following LTI credentials:
-
LTI Launch URL:
https://sso.app.amiralearning.com/dwe-lti-sso/Launch/lti -
oAuth Consumer Key and oAuth Consumer Secret:
These can be found in your Amira admin portal under SSO Settings -
Resource Link ID:
SSO -
User ID Type:
UserSourceID, this is the unique identifier used to authenticate users between ClassLink and Amira.
-
Reminder: SSO will only function after your first successful roster sync, and it requires that each user in your roster includes a Third-Party ID. (This corresponds to the Sourced ID field in ClassLink.)
Need Support?
If you have questions about any of the steps above, or if you’d like to set up a meeting to walk through the process together, don’t hesitate to reach out to support@amiralearning.com, we’re here to help ensure a smooth start to the school year.