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
Log in to your Canvas Admin account.
Open the Admin tab in the left-hand sidebar.
Navigate to Developer Keys.
Click + Developer Key → + API Key.
Configure the Developer Key
Enter the following values:
Key Name: Edlink
Owner Email: support@ed.link
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
Click Save.
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
Open the integration link above.
Create an Edlink account or sign in to an existing account.
Enter your Canvas domain, including
https://.
Example:
https://yourdistrict.instructure.com
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.
Click Connect.
You will then be redirected to Canvas to authorize the connection.
Select Authorize to continue.
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:
Open Advanced Options
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:
USA Domains | Canada Domains |
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.
