Setting up an SFTP connection

 Note

You can use SFTP for roster creation, but you don't have to use SFTP for SSO as well.

 Caution

Your district SIS is the authoritative source for your synced data. If you sync data from your district SIS with Imagine Learning products, it overrides any previously synced data. If you manually add data to your Imagine Learning products, that data is not overwritten when you sync with the district SIS.

Setting up an SFTP connection allows you to transfer rostering files directly to Imagine Learning's Secure File Transfer Protocol (SFTP) server. Imagine Learning supports the OneRoster® 1.1 format, Traditional rostering format for Literacy and Math, and other file formats (as directed by Imagine Learning).

Before you begin

You should have received an email from sftp@imaginelearning.com containing a link for you to set up your own personal, private password. If you did not receive an email, please contact your Imagine Learning Technical Systems Engineer so that they can send you an access email.

You must reset your password before you can log in to sftp.imaginelearning.com for the first time and connect to the Imagine Learning SFTP server.

 Note

If you need to use a different email address, please contact your Imagine Learning Technical Systems Engineer so that they can send access to the email address you specify.

To set up an SFTP connection for rostering

  1. Go to sftp.imaginelearning.com.
  2. Log in using your username (the email address that you provided to the Imagine Learning Experience Operations team), and password.

    Remember, you must reset your password before you can log in for the first time.

  3. Once you are logged in, set up file sharing with the following settings:
    Setting Description
    IP Address or Hostname sftp.imaginelearning.com
    Upload Path

    imagine/<site code>-<name of your district>/product

    For example: imagine/1234567-districtname/product

     Note

    Depending on your operating system, you may need to escape the entire string in double quotes to avoid any issues that arise from the path containing spaces.

    Username Enter the email address that you provided to the Imagine Learning Experience Operations team
    Password

    Enter your own personal, private password

    If you need to reset your password, go to sftp.imaginelearning.com.

    SFTP Enabled
    Date and Time

    Specify the date and time that you want to transfer files.

    Imagine Learning recommends that you transfer your files nightly, prior to 3 am Mountain Daylight Time.

    Supported Format

     Note

    Ensure that the files you upload match the OneRoster or traditional rostering file specifications.

    Please keep in mind that the name of the file you upload should always stay the same. For example, if the file you uploaded was named OneRoster.zip, that filename should never change in any subsequent uploads.