In order to enable a Vocareum Course to be accessible through LTI 1.3, refer to the LTI 1.3 Vocareum Course Configuration guide.
Canvas Setup Guide
1. Creating a LTI Key
NOTE: In order to create an LTI Key, 'Developer Keys - Manage' and 'LTI - add/edit/delete' permissions are required. Contact your account admin about setting up an LTI Developer Key if permissions are not met.
On Canvas, go to 'Admin' then select the Account the LTI Key will be under.
Go to 'Developer Keys' on the left navigation menu which will then bring up a list of Pre-existing Developer Keys. On the top right, click '+ Developer Key' then select '+ LTI Key'.
The Key Settings Form should then show up. Name the Key to any name you'd like and set an owner email. Now, Set the 'Method' to 'Enter URL' and enter the following URL:
https://labs.vocareum.com/lti1.3/config.json and save it.
Using the configuration URL above enables the following placements:
- Assignment Selection
- Link Selection
- Course Navigation
(enabling 'Show All Assignments' is ideal for Course
Ensure the key was set up properly editing the newly created key. The Key settings should look similar to the following image:
The 'OpenID Connect Initiation Url', 'Redirect URIs'/'Target Link URI', and 'Public JWK URL' should have automatically been filled with the details previously seen within the 'LTI Details' window during the initial Course Configuration.
After verifying that the LTI Key was correctly set up, change the key's state to "ON". The Client ID will be used to add Vocareum as an external tool (Tool Provider) to Canvas Courses. Save the Client ID somewhere as you'll need it again.
2. Adding Vocareum as an external Tool to a Canvas Course
We can use the Client ID in order to add Vocareum as a tool provider by first creating/going to a desired course, then 'Settings'->'Apps'->'View App Configurations'.
Click '+ App', set the Configuration Type to 'By Client ID' and enter the Client ID from the LTI Key.
A new External App titled 'Vocareum LTI 1.3 Content' will show up. Click the cog icon on the right of the External App and click 'Deployment Id'. Similar to the Client ID, save the deployment Id somewhere safe as both the Client ID and Deployment ID will be required.
Vocareum Setup Guide
Once we have both Client ID and Deployment ID, go back to Vocareum and go to
Organization Settings (Org Admins only) and under the 'LTI' section, click 'Issuers' to the right of the 'LTI 1.3' label.
Click 'New Issuer' on the top-right hand side of the page and fill in the Issuer entry form with the following information.
• Issuer: https://canvas.instructure.com/
• Client ID: The Client ID copied from Canvas Developer Keys
• Platform KeySet URL: https://canvas.instructure.com/api/lti/security/jwks
• OIDC Authentication: <your organization canvas URL>/api/lti/authorize_redirect
• OAuth Token URL: <your organization canvas URL>/login/oauth2/token
• OAuth Server URL: <Leave Blank for Canvas Issuer Registration>
• Name/Identifier: <name of your choice>
After saving, click 'Deployments' on the top-right of the page. Click 'New Deployment' and enter the deployment ID from Canvas and save it. Vocareum can now be used as an LTI 1.3 Tool Provider within Canvas!