Admin Guide for Schoology

The admin will need to set up an external LTI tool and create an LTI app on Schoology and launch the Magic Box portal. Follow the below steps to complete the configuration.

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

Set up external LTI tool in Schoology.

Step 1

Review LTI Apps Developer Documentation at https://developers.schoology.com/app-platform/lti-apps 

 Step 2

You will need your OAuth key and secret and Client ID to build your app with Schoology Learning. To get these, you need to add an app in the App Center > My Developer Apps section. Don't worry if you don't have all the details for the app creation form yet. Add the app to get this information and then you can update all the details later. To add your app...

1. Login to Schoology Learning and navigate to the Tools section as below:
2. Navigate to App Center > My Developer Apps
3. You'll see a screen like this if your company has never submitted an app before.
   Press Add App Button If you have submitted an app before, you'll want to add a NEW App. If your new app will be replacing your current one, you can tell us that when you publish it.
4. Add placeholders for the app details, or if you know the details, go ahead and fill them in as below:
5. Choose the App logo, here I have used the Magic Box logo as an example,
6. Select LTI 1.3 App for the Type of App
   
7. Select User, Courses, configuration, and privacy as below:
   
   
8. Enter the info for the following URLs from the Magic Box portal a. Go to the Magic Box Portal, Navigate to Settings from the super-publisher login, and open the LTI 1.3 tool as below:b. Click on view mode of the Platform or LMS as below:c. Capture the below details to fill the info in the above URL's section on the Schoology app:i. The Key set URL is filled in the JWKS URL section in Schoology. ii. The Launch URL will be filled in the Domain URL section in Schoology. iii. The Login initiation URL will be filled in the OIDC Login Init URL in Schoology.iv. The Launch URL will be filled in Redirect URLs in Schoology as below:v. Users can add custom parameters as well for the product launch at the time of setup of the app on the Schoology dashboard. Custom parameters can be added as per the below screenshot.

9. Now click on agree and submit button to generate the client Id as below:

10. You will be redirected to the below screen where install the app and capture your Oauth key and secret on the Success message at the top of the screen after submitting. 

The Client ID details can also be found after clicking Info display and select API Info from the Options menu after you install the app as shown below from point 11.

11. Click on I Agree button and later continue button as below:

11. Click on add to organization or Individual as below and you can see the app added as below:

12. Once the app is added following screen will appear with an option to install/remove. Click on Install again as below:

13. Check the below boxes and then click on submit as below for All Users, all courses, and All groups and click on submit.

14. Update the Client ID from Schoology as explained above in the Magic Box as shown below:

a. Login to the Magic Box super publisher and click on Edit Button

b. Replace the Client ID copied from Schoology in the below place and click on update.

15. Now when the user goes to the Schoology app one can navigate through the courses and launch the user from Schoology as below: