Skip to main content

Canvas Rostering Setup

Magma Math supports automatic rostering through Canvas using Edlink. This integration allows classes, teachers, and students to sync directly from Canvas into Magma Math.

Written by Stephanie

Before You Begin

To complete setup, you will need:

  • Canvas Administrator access

  • permission to create Canvas Developer Keys

  • access to your district’s Canvas environment

Canvas rostering is connected through Edlink.

Note: If your district has already connected Canvas to Edlink for another application, some setup steps may already be completed.

Step 1: Create a Canvas Developer Key

  1. Log in to your Canvas Admin account.

  2. Open the Admin tab in the left-hand sidebar.

  3. Navigate to Developer Keys.

  4. Click + Developer Key+ API Key.

Configure the Developer Key

Enter the following values:

Redirect URIs

Add each URI on its own line:

https://ed.link/api/authentication/canvas https://ed.link/sso/administrator

Leave all other fields blank unless your district requires additional configuration.

Enable the Developer Key

  1. Click Save.

  2. Toggle the Developer Key State to ON.

After saving, Canvas will generate:

  • a Developer Key ID (long numeric value)

  • a Developer Key Secret (shorter secret value)

You will use both values during the Edlink onboarding process.

Step 2: Connect Canvas Through Edlink

Integration Link

Use the following integration link:

https://ed.link/integrate/531cae99-8f54-4708-9114-58f799b67d3b

Complete the Edlink Onboarding Flow

  1. Open the integration link above.

  2. Create an Edlink account or sign in to an existing account.

  3. Enter your Canvas domain, including https://.

Example:

https://yourdistrict.instructure.com
  1. In the Edlink onboarding flow, enter:

    • Developer Key ID

    • Developer Key Secret

The Developer Key ID is the long numeric value generated in Canvas.

The Developer Key Secret is the shorter code shown underneath the ID.

  1. Click Connect.

You will then be redirected to Canvas to authorize the connection.

  1. Select Authorize to continue.

  2. Once redirected back to Edlink, click Validate Your Configuration.

After validation is complete, the Canvas integration will begin syncing data

Important Note About Scopes

Edlink does not currently recommend scoped Canvas Developer Keys unless your district specifically requires them.

Scoped keys may cause:

  • onboarding issues

  • API limitations

  • future integration problems

If possible, leave Enforce Scopes disabled.

If Your District Requires Scoped Keys

If scoped keys are required:

  • enable Allow include parameters

  • select Read-only scopes

Additional write scopes may also be required depending on district workflows.

During Edlink onboarding:

  1. Open Advanced Options

  2. Enable Scopes

Important: Scoped configurations should be tested before district-wide rollout.

LTI 1.3 Setup

Canvas API rostering and Canvas LTI setup are separate processes.

The API connection must be completed first before configuring LTI 1.3.

If your district plans to launch Magma directly from Canvas using LTI, an additional LTI key setup process will be required after the API integration is complete.

Allowlist Magma Math Domains

To avoid connectivity or firewall issues, ensure the following domains are allowlisted on your network and content filters:

If your district uses filtering systems such as:

  • GoGuardian

  • Lightspeed

  • other web filtering tools

please ensure these domains are allowlisted there as well.

Prepare Student Devices

iPads

If your district uses an MDM solution such as:

  • Jamf

  • Mosyle

  • another device management platform

deploy the Magma Math app to student devices before launch.

If no MDM is used, students can download the app directly from the App Store.

Laptops and Chromebooks

For the best experience, students should access Magma Math using Google Chrome.

Other browsers may not fully support all platform features.

Important Notes

  • Ensure teachers and students can access Magma Math from within Canvas.

  • Canvas roster syncs run nightly.

  • SIS updates such as enrollments and class changes will automatically sync into Magma once shared through Canvas and Edlink.

Did this answer your question?