CN ePortfolio (Course-level) LTI 1.3 Setup Guide for Canvas

Enable LTI v1.3 for Canvas

LTI v1.3 requires that the integration between the LMS and external tools like CourseNetworking(CN) is based on a trust created through OAuth 2.0. Enabling this trust requires a 4-step configuration. This is a one-time configuration that must be done by the LMS administrator with support from CN.
 

To enable LTI v1.3 integration:

1. In the LMS, create a Client ID for CN ePortfolio (Course-level).
2. In the LMS, enable CN ePortfolio (Course-level) as an external tool.
3. In the LMS, create an API key for CN ePortfolio (Course-level).
4. Reach out to your CN account manager or contact person, and request LTI 1.3.

Create a Client ID

Note: The following are abbreviated instructions. Instructions complete with screenshots can be found here in the Canvas documentation.

1. Login to Canvas as an administrator.
2. Navigate to Admin → Developer Keys.
3. Click + Developer Key → + LTI Key.

Key Settings

4. Use the following for the required fields:

Key Name: A string that describes the external tool, e.g., “CN ePortfolio (Course-level)”.

Redirect URIs: https://www.thecn.com/program/lti1p3/tool_launch/portfolio_course

Configure

5. Use the following for the required fields:

Method: Manual Entry

Title: Any string. Preferably same as “Key Name”.

Target Link URI: https://www.thecn.com/program/lti1p3/tool_launch/portfolio_course

OpenID Connect Initiation URL: https://www.thecn.com/program/lti1p3/tool_oidc_init/portfolio_course

JWK Method: Public JWK URL, https://www.thecn.com/program/lti1p3/tool_jwks

LTI Advantage Services

6. This section determines what LTI services are available to CN ePortfolio (Course-level). Enable the settings as shown.

Additional Settings

7. Cut/paste the following field mapping into Additional Settings → Custom Fields. This mapping matches Canvas fields to the LTI v1.3 properties.

email=$Person.email.primary

user_id=$User.id

course_id=$Canvas.course.id

last_name=$Person.name.family

first_name=$Person.name.given

section_ids=$Canvas.course.sectionIds

sectionSISSourceIDs=$Canvas.course.sectionSisSourceIds

8. Set Privacy Level to Public.

9. Placements are a Canvas feature that determines where an LTI link appears in the Canvas interface. Enter the following list:

• Account Navigation
• Link Selection
• Assignment Selection
• Module Menu
• Course Navigation

Assignment & Link Selection

10. After entering the placements appear in the form Account Navigation and Link Selection, select LtiDeepLinkingRequest. (note: if the Account Navigation LtiDeepLinkingRequest is not available, you can disregard it) 
11. Click Save.
12. Note the Client ID that was created. You will need it in the next section.

------

Enable CN ePortfolio (Course-level) as an External Tool

Note: The following are abbreviated instructions. Instructions complete with screenshots can be found here in the Canvas documentation. 

1. Login to Canvas as an admin.
2. Navigate to Admin → Settings → Apps.
3. Click View App Configurations.
4. Click + Apps.
5. For Configuration Type, select By Client ID.
6. Cut/paste the Client ID that you created in the previous section.
7. Click Submit.
8. If the client is found, click Install when prompted.
9. Navigate to Admin → Settings → Navigation.
10. Ensure that the navigation link for the CN ePortfolio (Course-level) tool is not hidden. See Canvas.

Contact CN 

Establishing trust between the LMS and CN ePortfolio (Course-level) requires configuration on the CN side as well. After you have complete the steps above, please reach out to your CN account manager or contact person with the following information:

1. Locate the Client ID.

Admin -> Developer Keys -> Find CN ePortfolio(course level) key created -> Find Client ID

2. Locate the Deployment ID.

Admin -> Settings -> Apps -> Find App created -> Click setting gear icon and find Deployment ID