Canvas

Ex Libris Developer Network Leganto Documentation Integrations LTI 1.3 Configure your LMS Canvas

General

Before you begin this step, ensure you have three URLs from the Integration Profile in Alma.

These links are generated in the step of creating an integration profile.

In this step you will:

Create a new “Developer Key”
Create a new “LTI application”
Copy 2 parameters (Client Id and Deployment ID) to be used in the next step

Create a Developer Key

Go to Admin->Developer Keys-> + Developer Key -> + LTI Key

Fill out the configuration screen as described below:

Key Name – any name you choose. This name will only be seen by the LMS administrator

Method = Manual Entry

Title – Any title you choose. This title will be seen by instructors when adding LTI links (as seen in the screenshot below)
(Think about the student experience. What will students be looking for when you want them to click on the Leganto link, and what language will prompt them to click in the right place? We recommend naming Leganto something that ties directly to the student need, such as “Course Materials,” “Course Resources,” “Course Readings,” or “Reading List.”)

Description – Any description you choose. This description will be seen by instructors when adding LTI links (as seen in the screenshot below)

How instructors see title + description

Target Link URI – The 1st link from the integration profile (Launch URL)

OpenID Connect Initiation Url – The 2nd link from the integration profile (Login URL)

JWK Method = choose Public JWK

Public JWK – Delete the existing {} and place the following value instead:

Place the 3rd URL in your browser but modify it by adding 2 to the jwk string. You should see a value like this:

Copy this value to the Public JWK field.

Redirect URIs – The 1st link from the integration profile (Launch URL)

Continue to the “Additional Settings” and set the following

Custom Fields –

In the Custom Fields set 3 parameters to send over to Leganto the course code and the username:

lis_course_code=$com.instructure.contextLabel
(you can configure other values than $com.instructure.contextLabel to act as course codes. If so, you can turn on in Alma a flag under Configuration->LTI->settings: allow_lti13_default_course_and_user to default to $com.instructure.contextLabel when lis_course_code is empty)

lis_user_username=$User.username
canvas_masq=$Canvas.masqueradingUser.id

lms_user_roles=$Canvas.membership.roles (used for automatically adding the Instructor role to users when arriving to Leganto)

In addition you should configure the following mapping for role to be added.

(Inspect the LTI parameters to be sure what value/s needs to be configured. see here LTI 1.1 or here LTI 1.3):

lms_course_start_date=$Canvas.course.startAt (used for creating courses on the fly)
lms_course_end_date=$Canvas.course.endAt (used for creating courses on the fly)

lis_course_name=$Canvas.course.name (Only needed if you are using the Automatic Course Creation feature)

In the example above we are sending the Canvas course “Context Label” as the course code (most Canvas Leganto customers use this as the course code).

If you want to send a different value, take look here for other placeholders.

canvas_masq (optional) – Used to detect “Student View”. If “Student View” is used when clicking the LTI link, an error message will be displayed. You can configure the text of the message under this leganto label: lti.user.error.studentView

Banner users

For users which are using the Banner ERP, there might be some exceptions to the above.

If the integration is not workingfor you, try the following changes

- In the “Add Custom Field“, use the following fields instead of what is documented:
  - lis_course_code=$Canvas.course.sisSourceId
  - lis_user_username=$Person.sourcedId

Privacy Level –

Set the value to PUBLIC

Placements –

Leave the Link Selection placement.

Think of adding the Course Navigation placement if you want an LTI link to automatically appear for all of your courses