Set Up LTI 1.3 Platform
- Last updated on February 20, 2024 at 12:23 PM
Publishers need to set up an LTI platform on Magicbox. The configuration needs to be done on both the MagicBox portal and the external LMS platform. Following this, the publisher needs to provide the third-party tool information to establish the LTI platform configuration on MagicBox.
The configuration includes:
- The information needed to securely communicate with the third-party LMS.
- What user and class data needs to be shared with the LMS.
Note: Magicbox will generate a unique platform (LTI Service) private and public key pair for each tool we integrate as per the IMS’s recommendation.
Follow the below steps to create an LTI platform on MagicBox and link with the third-party LMS.
1. Log in to the portal.
2. Click "Setting" on the left-hand side portal.
3. Click " LTI 1.3 Tool." You will see the below screen.
4. Click " Add Platform." You will see the below screen.
5. Select the "Global" radio button if you want the user to be registered on the portal as an individual user, or individual teacher (these users are not associated with any school)
OR
Select the "School" radio button if you want the user to be associated with a specific school in Magic Box.
If you select the "School" radio button, you will see the below section added to the screen.
- Select the "School" radio button.
- Select the "District" from the dropdown list. This is an optional field.
- Select the "School" from the dropdown list.
- Enter the name of the LTI platform in the "Name" field.
- Click on the "Generate" button to auto-generate the Client ID or Enter the "Client ID" third-party LMS tool.
Copy the "Launch URL" by clicking on the "Copy URL" button. This value is auto-generated on the MagicBox platform. Paste this value in the Redirect URL (this is also known as Launch URL) on the canvas platform from which you want to launch the MagicBox portal.
Copy the "OIDC Login Initiation URL" by clicking on the "Copy URL" button. This value is auto-generated on the MagicBox platform. Paste this value in the OpenID Connection Initiation URL field on the canvas platform from which you want to launch the MagicBox portal.
- Click on the "Generate" button to auto-generate "Tool Public Key." As per the LTI norms, this value is important and authorizes the user to access the platform on which we are creating the LTI credentials.
Do not add "Tool Private Key." The "Tool Private Key" is an auto-generated value that is automatically updated in this field at the time of the successful launch of the tool.
6. Enter the below "Platform Details":
- Enter the "Authentication URL" from the third-party LMS platform (Canvas)
- Enter the "Access Token URL" from the third-party LMS platform (Canvas)
- Enter the "Platform ID" from the third-party LMS platform (Canvas)
- Enter the "Keyset URL" from the third-party LMS platform (Canvas)
Note: Initially, this field is blank and must be updated upon completion of the Canvas setup. Below are the URL links that require updating.
Authentication request URL: https://magicbox-canvas.getmagicbox.com/api/lti/authorize_redirect
Access token URL: https://canvas.instructure.com/login/oauth2/token
Keyset URL: https://canvas.instructure.com/api/lti/security/jwks
Issuer (Platform ID) : https://canvas.instructure.com
7. If the school user is not rostered on the MagicBox platform, check the LTI "Auto-Roster" checkbox from "School Settings." This will allow users to be rostered on MagicBox at runtime on accessing content via LTI.
8. When the LTI auto user creation checkbox is checked, you will see an additional field of "PO" added on the Platform Details section, as shown below. This will show the list of all the active POs assigned to the selected school. Select one or multiple POs from the list.
Note: The above step is to add an LTI tool to Magicbox in order to create an external account on the Canvas account.
The next step is to create the app in the third-party LMS (Canvas).
For example: If you want to set up the LTI 1.3 integration with the Canvas platform, the admin will need to create the app on Canvas. (Click here for instructions)