(NEW)Guide: How to Install the Enhanced Portfolio LTI in Canvas

[#1]

Overview

This document describes how Canvas admins can install the Enhanced Canvas Portfolio LTI tool into their Canvas instance. After installation, instructors/course designers and learners will be able to start using the new Portfolio tool.

Prerequisites

Before you begin, make sure you have:

• Admin access to your Canvas environment (or permissions to manage External Apps / Developer Keys).
  
  

• Remove Previous LTI Installations

  • Before installing the new Portfolio LTI, you must remove any older versions from your Canvas environment.

    1. In Account or Course Navigation, click Settings.

    2. Click the Apps tab.

    3. Click View App Configurations.

    4. Locate any existing Portfolio LTIs in the list and click the settings icon and click Delete.

    This ensures that the new installation will not conflict with previous configurations.

    

Step-by-Step Installation

1. View inherited developer keys
In Account Navigation, click on the Developer Keys. To view inherited keys, click the Inherited tab.

2. Show All Keys
Scroll to the bottom of the list and click the Show All Keys button. Locate the Portfolio API (e.g. Portfolio <Region code>) and LTI keys (e.g. Portfolio <Region code> LTI Client) in the list.

3. Enable the Portfolio API Key and LTI Client
To enable both the Portfolio API key and LTI Client, click the On toggle.

4. Confirm Key State
A prompt displays asking you to confirm changing the key's state for both the API Key and the LTI Client. To confirm the change, click the Switch to On button. 

5. View App Configurations
You can install the Portfolio LTI at the account, subaccount, or course level. In Account or Course Navigation, click the Settings link. Click the Apps tab. To view app configurations, click the View App Configurations button.

6. Add App
Click the Add App button.

7. Installing the Portfolio LTI
In the Configuration Type dropdown, select the By Client ID option. Type the client ID (this needs to be the LTI Client that you previously toggled ON) for your regional server into the Client ID field.

• Portfolio US I.(IAD) – 170000000001967
• Portfolio US II. (US PDX) – 170000000001973
• Portfolio Canada(CA YUL) – 170000000001969
• Portfolio Singapore(SG SIN) – 170000000001972
• Portfolio Sydney (AU SYD) – 170000000001975
• Portfolio EU I. (EU FRA) – 170000000001977
• Portfolio EU II. (EU DUB) – 170000000001980

Click the Submit button.

Note: If you attempt to install the LTI before enabling the API and LTI keys, you will encounter an error stating that the client ID is disabled.

8. Confirm Installation
When the Add App prompt appears, click the Install button.

9. Select Placements
After installation, you must choose where the Portfolio LTI should appear in Canvas.

In the Placements modal, select one or more of the following:

• Account Navigation – adds Portfolio access at the admin/account level
• Course Navigation – adds Portfolio access in the course navigation menu
• Global navigation - adds Portfolio access to the global navigation
• User navigation - adds Portfolio access to the user navigation under “Accounts”
  
  

Click “X” to enable one or more placements.

[ldavenport4015]

@Dalma_Schnell Thank you so much for this! As one who has to install it in the test environment every month, I am excited to see it in the Inherited Keys list now! 

Looking forward to continued development of this feature in Canvas! 

[suzanne_pathki1]

Hi @Dalma_Schnell I am trying to delete the existing LTI and receiving an error message. See the recording I made: https://app.screencast.com/GZjTUH26bZYXg.

I was able to delete the developer key API without problem.

/Sue

[DavidSchlater]

I am confused here and could use some help - is Folio (accessed from the User Profile for us) going away? It still works today on our server.

We never promoted this widely, but we do have 22 users and I will need to let them know their work is going to be inaccessible and on what date and there is no way to migrate any projects they made, if this is true.

I am talking about folio projects kept here https://portfolium.com/davids4/portfolio

[jmagee1]

@Dalma_Schnell We still have "ePortfolios" in our user account menus and I could not find anywhere to delete this in beta. It's not in apps or developer keys that I can see. I installed Portfolio in beta and it's now showing in the user account menu as well, but this message comes up when the Portfolio link is clicked: 

Is this because the old ePortfolio LTI is still installed? We didn't install that one to my knowledge; it was already there when we transitioned to Canvas 6 years ago.