Overview
To set up Wonda with Canvas using manual registration, you need to:
Add a developer LTI® key in Canvas
Install the Wonda tool into Canvas
Register the Canvas provided details into Wonda
Do a test launch
Step 1. Add a developer key in Canvas
Login to your Canvas LMS as an administrator.
Navigate to 'Admin' -> [your account name] -> 'Developer Keys'
Click the '+ Developer Key' button followed by the '+ LTI® Key' dropdown
Canvas add LTI® key button inside admin menu
In the resulting form, enter the following information:
Key name: WONDA
Method:
Manual Entry
Redirection URI(s):
https://crud.spaces.wondavr.com/api/lti13
https://crud.spaces.wondavr.com/api/lti13/login
https://crud.spaces.wondavr.com/api/lti13/deeplink
Title:
Your Title
Description:
Your Tool Description
Target Link URI:
https://crud.spaces.wondavr.com/api/lti13
OpenID Connect Initiation Url:
https://crud.spaces.wondavr.com/api/lti13/login
JWK Method:
Public JWK URL
Public JWK URL:
https://crud.spaces.wondavr.com/api/lti13/keys
Further down in the form, select the services your tool needs. The screenshot below shows an example of a tool that uses assignments, grades, and the launch context (i.e. the course ID).
Toward the bottom of the form, add placements for your tool. These are the locations in the LMS where your tool can be added. If you are using Deep Linking, select
LtiDeepLinkingRequest
. Otherwise, selectLtiResourceLinkRequest
for a basic LTI® launch.Click the 'Save' button at the bottom when the form is filled.
After saving, find the newly registered tool's key on the list of keys and make sure the State is switched to 'ON'.
Note the number in the details column. It will be used as the
Client ID
in the next steps.Canvas developer keys table with client ID highlighted
Step 2. Install the Wonda tool into Canvas
In the Canvas Admin menu, navigate to 'Settings' -> 'Apps'
Click the '+ App' button
In the resulting form choose:
Configuration Type:
By Client ID
Client ID:
[The Client ID number you found in the previous series of steps]
Click the 'Submit' button
In the resulting dialog, click 'Install'
The tool will now show up in the 'External Apps' table.
Step 3. Register the Canvas provided details into Wonda
Open your hub settings in the top right corner (available for admins only)
Go to Integrations Tab and Select LTI, then enable the LTI for your Hub
Click Add New LTI 1.3 Platform, then go to the LTI Platform Information tab
Wonda Registration API Name | Canvas Provided Name (Instructure Cloud) | Canvas Provided Name (Self Hosted) |
name | Any name you would like that helps you identify your LMS |
|
Client ID | The client ID found in the first sequence of steps |
|
URL | https://[YOUR_CANVAS_URL] | |
Authentication Method | JWK_SET |
|
Authentication Key | https://[YOUR_CANVAS_URL]/api/lti/security/jwks | |
Access Token Endpoint | https://[YOUR_CANVAS_URL]/login/oauth2/token | |
Authentication Endpoint | https://[YOUR_CANVAS_URL]/api/lti/authorize_redirect |
If a registration is not working, one of the likely causes is an incorrect URL
. Please try both https://canvas.instructure.com
and https://[YOUR_CANVAS_URL]
.
Click submit when you have made the necessary changes. Also, you can edit these values at any time.
Step 4. Do a test launch
tip
You may need to add placements for the newly installed tool before adding it to certain places within the LMS.
Follow the instructions on the Canvas website to add an external tool assignment to a course: How do I add an assignment using an external app?
When choosing an external tool, choose the newly registered tool from step 1.