Summon: Configuring a Summon LTI Tool in Canvas

This article provides information on how to create an LTI (Learning Tools Interoperability) tool that enables Canvas to integrate with Summon. When you are finished in Canvas, complete Summon's side of the integration. For configuration details, see the LTI section in Summon Administration Console > Settings.

1. In the Canvas Admin panel, select Developer Keys to open the Developer Keys page.

   

2. Select + Developer Key > LTI Key to define a new LTI key.

   

3. On the Key Settings page, specify the parameters listed in the table below.

   

   Field	Description
   Key Name	Specify a name for the Summon LTI tool.
   Method	Select Manual Entry from the drop-down menu.
   Title	Specify a title for the Summon LTI tool.
   Description	Specify a description for the Summon LTI tool.
   Target Link URI	Use the following syntax to construct the Target Link URL: <Summon API domain>/2.0.0/user-service/lti/validate-login?redirect=<% encoded Summon Base URL> Example for a Production environment: http://api-svc-eu.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com Example for a Preview environment: http://api.preview.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com Online tools are available to % encode your URLs—for example, https://www.url-encode-decode.com/.
   OpenID Connect Initiation Url	Use the following syntax to construct the login URL: <Summon API domain>/2.0.0/user-service/lti/login-init Example for a Production environment: https://api-svc-eu.summon.serialssolutions.com/2.0.0/user-service/lti/login-init Example for a Preview environment: https://api.preview.summon.serialssolutions.com/2.0.0/user-service/lti/login-init
   Redirect URIs	Specify a list of uris separated by new lines that include queries or bookmarks to allow end users to link their courses. Use the following syntax to construct each redirect URL: <Summon API domain>/2.0.0/user-service/lti/validate-login?redirect=<% encoded Summon URL> Examples for a Production environment: http://api-svc-eu.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com http://api-svc-eu.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com%2F%23%21%2Fsearch%3Fho%3Dt%26include.ft.matches%3Dt%26l%3Den%26q%3Dhouse http://api-svc-eu.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com%2F%23%21%2Fsearch%3Fho%3Dt%26include.ft.matches%3Dt%26l%3Den%26q%3Dcats Example for a Preview environment:   http://api.preview.summon.serialssolutions.com/2.0.0/user-service/lti/validate-login?redirect=https%3A%2F%2Frla.summon.serialssolutions.com   Online tools are available to % encode your URLs—for example, see https://www.url-encode-decode.com/.
   JWK Method	Select Public JWK from the drop-down menu.
   Public JWK	Enter the following JSON object: {     "e": "AQAB",     "n": "nRcQF-lbvU-KsAlw9SOUD6ZuY6luXJPLkQ1LKvj5lwvlOl9H-0Rjyhq6OByZnMjhNV2YdvK-kfZ44IGhzgXCSVnCUNvibPo7NLd1vnPkAatGZVbwRwQIqC8-PQDhL3tc2DwMLKvYtoy2c7ynCr2LPcTjevCBlCcGeswMSpECEOvBfp0nXzgdX-QGnllSGzpXsq9Q81WGQQlc_c0-EprRBTwyc9aSYFIW1PWBYBAzcANVqtLrD7NEWJsuH43Hq4gTfKYbwclGZilojYX6d_rWolF-HTCPEL_75R7k6NULANF2xy3XszTSzc-W2_dAzpNOHXw0GxAEhQNEhBr1EJa0zQ",     "alg": "RS256",     "kid": "9cb7dda1-4bbc-4a38-ae08-dbab6f8df4e2",     "kty": "RSA",     "use": "sig" }

4. Save your settings. You will need to remember the Client ID for later configurations.

   

5. Open External Apps page (Settings > Apps > View App Configurations).

   

6. Select + App.

   

7. In the Add App dialog box, set Configuration Type to By Client ID, paste the Client ID saved in a previous step into the Client ID field, and then select Submit.

   

8. Remember the auto-generated Deployment ID for a later configuration in Summon.

   

9. Configure the LTI settings in the Summon Admin Console to finish the integration with Canvas. For more information, see LTI Settings in Summon.

10. To verify the integration, open the Modules section for a Canvas course and select the + button for an existing module or first create a new module (using the + Module button).

    

11. In the Add Item dialog box, specify the following fields:

    

    • Add drop-down menu – Select External Tool.

    • Tool drop-down list – Select the LTI tool that you created earlier in this procedure.

    • URL – By default, this field is populated with the first entry of the LTI tool's Redirect URIs field. If a different URI is needed, specify one of the other redirection URIs specified during the creation of the LTI Tool.

    • Page Name – Type the name that you would like your users to see for this External Tool (for example, Summon Catalog). It can be any name, but try to choose a name that your users will recognize and understand.

    • Load in a new tab – Select this checkbox if you want to open the Summon site in a separate tab rather than embedded in the course.

12. Select Add Item.

13. Repeat steps 10 - 12 if you want to configure links for other redirection URIs defined in the LTI Tool.