If you are ready to set up Roster Server to pull data from the Aeries API, you’ll need to retrieve your URL to Aeries, the key, and secret.
Step 1: Aeries API Set Up
Aeries administrators can access the API Security page in the Security node of the navigation menu.
On this page, click Add to create a record for a 3rd party product. Name the product and check the OneRoster box.
After saving the record, check the box to Display Consumer ID & Secret Keys for OneRoster. Make note of the Consumer ID and Consumer Secret Key values that display.
Next, setup the permissions for the newly created record. To grant a permission, click the box next to the appropriate table/program area under the Read column, and the box will become checked with a green background. To remove a permission, click the box again, and the check mark and green background will go away. The following is a list of permissions that are needed for the complete set of OneRoster API endpoints that Aeries currently supports.
- Student Data
- Student Data
- Gradebook Scores
- Gradebook Category
- Gradebook Assignment
- Teacher Data
- Master Schedule
- Course Data
- School Information
For more information, refer to Aeries' official documentation.
Step 2: Connection to ClassLink Roster Server
Log into ClassLink, click on your Roster Server app (or click on your ClassLink Management Console app, then click on “Roster Server” from the left frame). You can also access the Roster Server Console by logging in through https://console.oneroster.com.
Go to Settings>General
Click “Connector Settings”
Click on Settings > General.
Under SIS Connector Settings, click “Choose” to select your SIS (Aeries).
For the URL field, use the base URL for your Aeries Web application. If you are uncertain of the base URL, simply browse to your Aeries login page, then copy everything before the last slash (“/”) in the browser’s address bar.
For the KEY field, use the Consumer ID from Step 1.
For the SECRET field, use the Consumer Secret Key from Step 1.
Click “SAVE” in the bottom right corner.
Click “Test Connection” and a message of success will appear.
Turn the “Enabled” switch on.
Click “Run Connection” (This may take a while)
Above, under Importer Settings, turn the “Sync” button on and choose a sync schedule.
Click on Import Rosters > Import Now and your files will appear. This document will help as well.
Go back to the left frame menu and click Applications to choose the applications to roster. This document will help as well.
After setup, your settings page should look similar to this: