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

  1. As a Schoology Admin, go to https://app.schoology.com/apps/publisher and click "Add App" to open the Add Schoology App page.
  2. Once the page loads, populate the below fields:
    • App Name - This is the tool's name as it will appear for other users of Schoology. We recommend something like "Engageli" or "Engageli Classroom".
    • Description - Similar to the app name, this should contain something that references Engageli. 
    • Category - Make any necessary selections or changes here based on your organization's preference.
    • Available for - Select the group of users who will have access to this tool.
    • This app uses cookies - Mark this box. The LTI 1.3 workflow is reliant on usage of 3rd party cookies.
    • Type of App - Select "LTI 1.3 App" from this dropdown.
    • Launch app in Schoology - Mark this box. Depending on how you plan to use the Engageli tool, you may be able to unmark this later.
    • Can be installed for - The Engageli tool is designed to be associated with courses. We recommend making the tool available only within the context of a course. Thus, select only the options under the "Courses" group. You may select whichever placements are applicable to your use case or based on organization preference.
    • Configuration Type - Set this to "Manual".
    • Privacy - Set this dropdown to "Send Name and Email/Username of user who launches the tool".
    • LTI Advantage Extensions - Mark all the options seen here; Engageli supports all of them.
    • JWKS URL - This is the JSON Web Key Set URL. Engageli will provide this.
    • Domain/URL - This is the launch URL used by the LTI tool. Engageli will supply the appropriate value, which varies based on whether the integration uses a Deep Linking workflow or a standard resource link.
    • 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.
  3. Apply any other necessary configurations, then click "Save Changes" at the bottom of the page.
  4. When you are directed back to the "My Developer Apps" page, look for the Engageli tool that you've just created and select "Options" > "API Info".
  5. In the pop-up window, copy "Client ID" value and temporarily place it somewhere, like in a text document or Notepad.

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 - This value will be "https://schoology.schoology.com"
  • Client ID - This will be the Client ID value you copied earlier.
  • Authentication Endpoint - This value will be "https://lti-service.svc.schoology.com/lti-service/authorize-redirect"
  • Access Token Endpoint - This value will be "https://lti-service.svc.schoology.com/lti-service/access-token"
  • JWKS URL - This value will be "https://lti-service.svc.schoology.com/lti-service/.well-known/jwks"