This document will walk Canvas administrators through the LTI 1.3 tool configuration to integrate Sage Vantage with Canvas. This tool will allow instructors the ability to create deep links and sync grades between Vantage and their Canvas courses.

Some configuration information is provided to you by Sage. Your Sage Technical Implementation Specialist will provide these details using a privnote link (https://privnote.com/). Please note that this link can be opened once. When you close the page, the contents of the privnote will be destroyed. Once you open the privnote, we recommend storing a copy of this information for your records.

The Developer Key must be set up at the Account level in Canvas. Once the Developer Key is configured, it can be deployed at the Account, Subaccount, or Course level depending on your school's needs or requirements.

1. Log into your Canvas LMS as an Administrator. Next, go to the Admin tab to begin. Select the account you wish to use for the integration.
   
   
   
   
2. In Account Navigation, click Developer Keys.
   
   
   
   
3. Click the + Developer Key button, followed by + LTI Key.
   
   
   
   
4. Enter the LTI settings.
   
   
   1. Key Name: Sage Vantage (* recommended)
   2. Owner Email: Enter the email address that needs to be tied to the tool setup.
   3. Redirect URI(s): The reply URL will be provided by Sage via email.
   4. Configuration Method: Select Enter URL from the dropdown menu.
   5. JSON URL: The JSON URL will be provided by Sage via email.
   6. Make a final review of the settings for accuracy. Next, click the Save button at the bottom right of the page to store your LTI key.
      
      
      
      
5. On the Developer Keys page, locate Sage Vantage in the list. In the State column, click to turn the tool On.
   
   
   
   Once the tool is enabled, you will see the state's status change.
   
   
   
   
6. A Client ID is assigned to the LTI key when it's created. It will appear in the Details column. Copy this ID as you will need it to enable the tool configuration.
   
   
   
   
7. After the LTI key is created, go to Settings in Account Navigation.
   
   
   
   

8.      Click the Apps tab, then click the View App Configurations button.

9.      Click the + App button.

10. On the Add App page, make the following changes:
    
    
    1. Configuration Type: By Client ID
    2. Client ID: Paste the Client ID you copied after creating the LTI key.
       
       
       
       
    3. Click the Submit button.
       
       

11.  To complete the tool set-up, click the Install button on the Add App confirmation.

12. Send this same Client ID and your Canvas URL (i.e. school.instructure.edu) to Sage to complete the tool set-up.
    
    
13. After you send the Client ID and Canvas URL to your Sage Technical Implementation Specialist, you will receive confirmation that the integration is complete on the Sage side. We recommend that you attempt to add a link to Vantage in a sandbox course to confirm the tool configuration is working.

a.       Choose the module where you would like to add a Vantage link. Next, click the "+" button to add new content to the module.



Note: If you are adding Vantage content through Pages instead of Modules, create or edit the Page where you wish to add content. Click the Apps icon in the toolbar and select the Sage Vantage tool. Adding links will mirror the process outlined below for Modules.

b.      In the "Add" dropdown, select External Tool. You will see a list of available tools.  Choose the one that says Sage Vantage.

3. You should see the following error message that you do not have a valid Vantage account:
   
   "Message: Your learning management system email [your_email@school.edu] does not match an existing account in Sage Vantage. Please contact collegetechissues@sagepub.com so that our support team can create or merge your accounts."
   
   
   
   Seeing this error indicates you have authenticated into Vantage to the point where it is doing a user check. Since the user check is looking for an instructor account, this message indicates the configuration is correct.