Skip to main content

How to set up the Engageli LTI External Tool in Schoology

Overview

This article will walk you through the process of making Engageli available as an LTI tool within Schoology. Much of this article is based off Schoology's document for adding LTI Apps. You can review that article here for additional details: https://developers.schoology.com/app-platform/lti-apps/

Adding Engageli App to Schoology

The below steps will walk you through adding Engageli as an app to Schoology.

  1. As a Schoology Admin, click on the "Show Apps" icon (3 squares and a diamond in a grid pattern) in the top navigation bar. This will expand a dropdown containing an "App Center" button. Click on this button to be taken to the App Center page. Below is a sample screenshot of the "App Center" button:
  2. From the App Center page, click on the "My Developer Apps" link near the top of the page, as shown below:
  3. From the My Developer Apps screen, click on the "+ Add App" button, as highlighted in the below image:
  4. You'll now be on the "Add Schoology App" screen, where you'll configure a new app for the Engageli LTI tool. Below is a screenshot of the Add Schoology App page:
  5. Fill in the configuration fields are indicated below:
    • App Name - This is the label associated with this app and is what other users in your organization will see. We recommend using something like "Engageli" or "Engageli Classroom".
    • Description - You can use whatever description you prefer.
    • Category - We recommend choosing "Other", though you may select any option that best aligns with your needs. This choice does not affect which courses the app appears in; it simply helps organize the app within Schoology's overall list of available apps.
    • Level - Similar to the Category selection, you may select any option that be aligns with your needs. This choice has no impact on the functionality of the tool; it simply helps organize the app within Schoology's overall list of available apps.
    • Recommended For - Similar to the Category selection, you may select any option that be aligns with your needs. This choice has no impact on the functionality of the tool; it simply helps organize the app within Schoology's overall list of available apps.
    • Available for - Set this to "Only people in my school".
    • Type of App - Set this to "LTI 1.3 App".
    • Launch app in Schoology - This box should typically be checked unless your Engageli representative advises otherwise based on your intended workflow.
    • Can be installed for - We suggest enabling Engageli only in "Course Materials Selection" and "Rich Text Editor". If you'd like it available in other Course‑related placements, your Engageli representative can advise you. Avoid enabling Engageli in sections such as "Groups" or "Standard user visibility", since Engageli functions specifically within course environments and isn't meant to appear as a general‑purpose tool.
    • Configuration Type - This should be set to "Manual".
    • Privacy - This should be set to "Send Name and Email/Username of user who launches the tool".
    • LTI Advantage Extensions - Ensure "Deep Linking" and "Names and Roles Services" are checked.
    • JWKS URL - Your Engageli representative will provide this to you.
    • Domain/URL - This is the launch URL used by the LTI tool. Engageli will supply the appropriate value, which varies based on whether you'll be using deep linking workflow or a standard resource link workflow.
    • OIDC Login Init URL - This field holds the OpenID Connect Login Initiation URL. Engageli will provide this value.
    • Redirect URLs - Engageli will provide these. Caution: If you need to include multiple entries, separate them with commas only. Adding spaces or line breaks may cause the configuration to fail.
  6. At the bottom, mark the "This application meets the Schoology Terms of Use" checkbox, then hit "Submit".
  7. Once the submission is successfully processed, you'll be taken to the app's details screen, as shown below:
  8. From this screen, select the "Options" button and within the dropdown that appears, select "API Info". We've provided a screenshot below for reference:
  9. In the pop-up that appears, copy down the "Client ID" value, as seen in the example screenshot below. You will need to provide this to Engageli.

Enabling The Engageli App for your Organization

Once you have added the Engageli app, you'll need to make it available to your organization. Follow the below steps to complete this process.

  1. Navigate back to the "My Developer Apps" page, locate your Engageli app in the list, and click its "Install LTI 1.3 App" button. If you're still viewing the app's details from the previous section's steps, the same button will be available there as well. Below is a reference image of the "My Developer Apps" page, highlighting the location of this button:
  2. Upon clicking the button, you will encounter a consent prompt. Click "I Agree" to this.
  3. You'll then see a description of the LTI Advantage extensions associated with the app. Click "Continue" on this prompt.
  4. The final prompt will have you select between installing this app at the organization level or just for yourself. Select the "Add to Organization" option, as highlighted in the below image:
  5. Once the app is installed, you'll be redirected to the "Organization Apps" page, where you'll see your app listed, as shown below:
  6. Click on the app's "Install/Remove" button.
  7. In the pop-up that appears, check the "All Courses" option. This will ensure the Engageli app is available for use within all your courses. If you wish to restrict the app to only course admins, then also select the "Course admins only" box. Below is a screenshot showing the pop-up and referenced options:

Values to Provide to Engageli Team

The Engageli team will need to configure Schoology on their end. Below are the values to provide to Engageli so that they can complete their end of the setup:

  • URL/Issuer - https://schoology.schoology.com
  • Client ID - This will be the Client ID value you copied earlier.
  • Authentication Endpoint - https://lti-service.svc.schoology.com/lti-service/authorize-redirect
  • Access Token Endpoint - https://lti-service.svc.schoology.com/lti-service/access-token
  • JWKS URL - https://lti-service.svc.schoology.com/lti-service/.well-known/jwks

Related articles