Set Up LTI 1.3 Platform

  • Last updated on August 5, 2024 at 9:54 AM

Publishers need to set up an LTI platform on Magic Box. The configuration needs to be done on both the Magic Box portal and the external LMS platform. Following this, the publisher needs to provide third-party tool information to establish the LTI platform configuration on Magic Box.

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: Magic Box 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 Magic Box platform. Paste this value in the Redirect URL/Domain URL (this is also known as Launch URL) on the Schoology platform from which you want to launch the Magic Box portal. 

  • Copy the " Login Initiation URL" by clicking on the "Copy URL" button. This value is auto-generated on the Magic Box platform. Paste this value in the OIDC Login Initiation URL field on the Schoology platform from which you want to launch the Magic Box 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 (Schoology)
  • Enter the "Access Token URL" from the third-party LMS platform (Schoology)
  • Enter the "Platform ID" from the third-party LMS platform (Schoology)
  • Enter the "Keyset URL" from the third-party LMS platform (Schoology)

These values can be obtained from the Schoology developers website Schoology developers website

The platform details can be found as below after clicking on this link:

The mapping between the Id's from Magicbox and Schoology Document is as below:

a. Schoology Issuer id is filled as Platform Id in Magic box as below:

b. OIDC Authorization Endpoint URL is filled as Authentication request URL in MagicBox as below:

c. OAuth 2 Access Token Endpoint is filled as Access token URL in MagicBox as below:

d. JWKS URL is filled as Keyset URL in Magicbox as below:

Below are the URL's 

7. If the school user is not rostered on the Magic Box platform, check the LTI "Auto-Roster" checkbox from "School Settings." This will allow users to be rostered on Magic Box 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.

9. Once you save the New Platform added The next step is to create the app in the third-party LMS (Schoology).

10. After you create an app on Schoology update the clientID that is generated in the app in this new platform created for Schoology as below:

a. Click on the edit button on the created platform on dashboard settings:

b. In the Client ID column update the Client ID retrieved from the app as below:

This is where in the Schoology platform the ClientID can be found. This can be retrieved when the admin will create an app on Schoology. (Click here for instructions)

To set up the LTI 1.3 integration with the Schoology platform, the admin will need to create the app on Schoology. (Click here for instructions)

Please refer to the LTI 1.3 integration with the Schoology demo video

https://drive.google.com/file/d/1DnapFthlhdEBF0J6brUbk0DvwLg47BvX/view?usp=sharing


Was this article helpful?