Prerequisites
- Admin access to your RansomLeak tenant
- Canvas account admin rights
- Permission to add Developer Keys
- Canvas email matches each user's RansomLeak email
Setup is a two-way exchange. You paste RansomLeak's tool URLs into a Canvas Developer Key, then paste Canvas's identifiers back into RansomLeak. Keep both admin tabs open. For help during setup, email support@ransomleak.com.
Get your RansomLeak tool details
In RansomLeak, open Admin → Integrations → LTI. Copy the three tool URLs and your public key. These are unique to your tenant.
https://<your-domain>/api/lti/login https://<your-domain>/api/lti/launch https://<your-domain>/api/lti/.well-known/jwks.json <your-domain> is your RansomLeak address, either
your-subdomain.ransomleak.com or your custom domain. The LTI page shows the exact
URLs for your tenant, so copy them from there rather than typing them by hand.
Create an LTI key in Canvas
-
In Canvas, go to Admin → Developer Keys, then choose + Developer Key → + LTI Key.
-
Set Method to Manual Entry and fill in:
- Key Name: RansomLeak
- Redirect URIs: your Launch URL
- Target Link URI: your Launch URL
- OpenID Connect Initiation Url: your Login URL
- JWK Method: Public JWK URL, then paste your Public JWK URL
-
Under LTI Advantage Services, turn on the gradebook scopes so scores can post back:
- Can create and view assignment data in the gradebook associated with the tool
- Can view submission data for assignments associated with the tool
- Can create and update submission results for assignments associated with the tool
-
Under Placements, add Course Navigation for a simple launch. Click Save.
-
Set the key's state to ON, then copy its Client ID (the long number in the Details column).
Install the app and get the Deployment ID
-
Go to Admin → Settings → Apps, then View App Configurations → + App.
-
Set Configuration Type to By Client ID, paste the Client ID, and submit to install.
-
Open the installed RansomLeak app's settings (the gear icon) and copy its Deployment ID.
Connect Canvas back to RansomLeak
-
Return to Admin → Integrations → LTI in RansomLeak and choose Register a platform.
-
Enter your Canvas Client ID and Deployment ID, plus the Canvas platform endpoints:
Issuerhttps://canvas.instructure.comAuthentication URLhttps://sso.canvaslms.com/api/lti/authorize_redirectToken URLhttps://sso.canvaslms.com/login/oauth2/tokenJWKS URLhttps://sso.canvaslms.com/api/lti/security/jwks Save and enable the registration. The connection is now live.
These endpoints are for Canvas hosted cloud. On a regional host or self-managed Canvas, confirm the issuer and the authentication, token, and JWKS URLs for your instance before you save.
Add training to a course
-
Open a Canvas course, go to Settings → Navigation, move RansomLeak into the enabled list, and save. The tool appears in the course menu.
-
To grade it, add an Assignment with Submission Type: External Tool and pick RansomLeak. Set the points so the gradebook column is created.
-
Learners launch RansomLeak over single sign-on. When they finish, the score posts back to the Canvas gradebook through Assignment and Grade Services.
Troubleshooting
| Symptom | Fix |
|---|---|
| "Invalid client" or launch fails | Confirm the Developer Key is set to ON and the Client ID in RansomLeak matches the key. |
| Launch works but no grade appears | Confirm the AGS gradebook scopes are enabled on the key, and that the assignment uses the External Tool submission type with points set. |
| "User not found" or a second login prompt | The Canvas account email must match the user's RansomLeak email. |
| "Invalid deployment" in RansomLeak | Recheck the Deployment ID copied from the installed app, and that the app is installed at the right account or course level. |
Frequently asked questions
Does RansomLeak support Canvas LTI 1.3?
Yes. RansomLeak registers as an LTI 1.3 tool through a Canvas Developer Key, launches over single sign-on, and posts completion and score back with LTI Advantage Assignment and Grade Services (AGS).
Does this work on Canvas Cloud and self-hosted Canvas?
Both. The steps are the same. On self-managed or regional Canvas, confirm the platform issuer and the authentication, token, and JWKS URLs for your instance before you register it in RansomLeak.
Where do scores land in Canvas?
In the Canvas Gradebook column tied to the RansomLeak assignment or external tool. When a learner finishes an exercise, the score posts back automatically over AGS, with no CSV export.
Can I deliver RansomLeak as SCORM instead?
Yes. You can export any course as a SCORM 1.2 or 2004 package and upload it to Canvas rather than using LTI. The LMS integration page covers both delivery methods.
Need a hand?
Email support@ransomleak.com and we will help you connect Canvas to your tenant.