Canvas Integration Guide

Administrators’ Guide

This process should be completed by the Canvas Administrator.

LTI 1.1 Integration Guide

1. Login to Canvas with an Administrator account
2. Click Settings
3. Click Apps
4. Click View App Configurations
5. Click +App
6. The Add/Edit App window will appear. Enter the following:
   Configuration Type: Manual Entry
   Name: iCEV
   Consumer Key: please contact us for this information
   Shared Secret: please contact us for this information
   Launch URL: https://login.icevonline.com/LTI
   Domain: login.icevonline.com
   Privacy: Public
   Custom Fields:
   • courseId=$Canvas.course.id
   • assignmentId=$Canvas.assignment.id
   • duedate=$Canvas.assignment.dueAt
   • lockAt=$Canvas.assignment.lockAt.iso8601

Adding an Administrative Access Token

1. Login to Canvas with an Administrator account
2. Click Account
3. Click Settings
4. Click +New Access Token
5. Purpose: iCEV API Application
6. Expires: leave blank
7. Click the Generate Token button
8. Send an email to Integration Support with:
   1. The token key
   2. The Canvas domain name — example: https://{domain_name}.instructure.com/

LTI 1.3 Integration Guide

1. Login to your Canvas instance as an administrator and select Admin from your left-hand menu
2. Go to [Organization Name] → Apps → Manage tab
3. Click the Install a New App button
4. In the Install App modal, select 1.3 for the LTI Version and Install Method JSON
5. Paste in your Canvas JSON Configuration: please contact us for this information
6. Click Next through the registration steps below

LTI 1.3 Registration

These fields and options populate automatically based on the JSON configuration.

Install App Permissions

Make sure the following are enabled at minimum:

• Can create and view assignment data in the gradebook associated with the tool
• Can view assignment data in the gradebook associated with the tool
• Can view submission data for assignments associated with the tool
• Can create and update submission results for assignments associated with the tool
• Can retrieve user data associated with the context the tool is installed in
• Can view the content of a page the tool is launched from
• Can view LTI registrations associated with the tool

Data Sharing

Make sure the following is enabled at minimum:

• User data shared with this app: All user data

Placements

Make sure the following are enabled at minimum:

• Submission Type Selection
• Tool Configuration

Override URL’s

These fields and options populate automatically based on the JSON configuration.

• Submission Type Selection: LtiDeepLinkingRequest
• Override URL: https://login.icevonline.com/lti
• Tool Configuration, Message Type: LtiResourceLinkRequest
• Override URL: https://login.icevonline.com/lti

Nickname

• Administration Nickname: iCEV
• Description (optional): With over 33 years of experience, iCEV specializes in providing quality Career and Technical Education curriculum and education resources for several major subject areas, including Agricultural Science and Technology, Family and Consumer Sciences, Business Education, Marketing Education, Trade and Industrial Education, Health Science, Law Enforcement, and Career Exploration
• Placements Names (optional)
• Submission Type Selection (optional)
• Tool Configuration (optional)
• Tool Icon URL (optional)

Click Install App once you’ve reviewed all the steps. You should be redirected to your new app, or you can access it from the manage list.

Click Copy Client ID. This copies the client ID to your clipboard, and this information will need to be shared with iCEV.

The Deployment ID is optional and available on the app management screen. If you wish, copy that value and send it to iCEV. This is only necessary to distinguish between multiple instances.

Ensure the app is turned On and is Available for the organization. You may have to add or edit the exception. To do this, click Apps on the left-hand side, then click Manage, and verify the iCEV app is toggled on.

Base URL

This information will need to be shared with iCEV.

1. Login to your Canvas instance as an administrator
2. Go to [Organization Name] → Settings, then scroll down
3. Copy the URL shown and provide it to iCEV. This field acts as the suffix for the Authentication, Access Token, and JWKS endpoint fields

How to Generate the Access Token (Optional)

1. Click on your account image
2. Click Settings
3. Click + New Access Token
4. Email the information to integrationsupport@icevonline.com

Note on LMS Grade Passback

• Assessments taken using LTI 1.1 require the same 1.1 configuration to remain active to perform grade passback for those assessments
• New assessments taken using LTI 1.3 require the same 1.3 LTI configuration they were completed with to continue to properly perform grade passback
• Deactivating, disabling, or removing the LTI configuration an assessment was taken with will likely prevent grade passback from working

Submitting Integration Details to iCEV

Your integration will not be considered complete until the required information has been submitted to iCEV and a confirmation email has been received.

Please email integrationsupport@icevonline.com with the following details:

• Client ID (required)
• Base URL (required)
• Deployment ID (optional)
• Service Access Token (optional)
• Service URL (optional)

Completion and confirmation from iCEV will officially finalize your integration setup.

Teachers’ Guide

NOTE: These steps assume that the Canvas Administrator has setup the external tool (integration) in Canvas. If they have not, please send the Administrators Section to the Canvas Administrator.

Step 1 - Export Lesson from iCEV

NOTE: It’s recommended to only export one lesson at a time.

1. Navigate to Your Course

   Go to the Courses page in iCEV and locate the lesson you want to export. Click the blue View button next to that lesson.

2. Review Lesson Materials

   Inside the lesson, review all materials. Make sure everything you want to include in the export is marked Visible to Students, including:

   • Presentations

   • Instructional materials

   • Interactive assignments
3. Click “Export Common Cartridge”

   Click the green Export Common Cartridge button in the upper-right corner of the lesson page.

4. Select Your LMS

   A pop-up window will appear. From the dropdown menu, select the Learning Management System used by your school district.

5. Start the Export

   Click the green Export button to begin the process.

6. Download the IMSCC File

   An IMSCC file (Common Cartridge format) will be created and downloaded to your computer.

   ⚠️ Do not open this file—it’s designed to be imported directly into your LMS.

Step 2 - Import into Canvas

1. Open Your Canvas Sandbox Course

   Navigate to your Canvas Sandbox Course.

   ⚠️ Do not import content into a published course—this can lead to data loss that may not be recoverable without help from your Canvas Administrator.
2. Start the Import Process

   On the course Home page, click Import Existing Content from the right-hand menu.

3. Choose the Content Type

   In the Content Type dropdown, select Common Cartridge 1.x Package.

4. Upload the Common Cartridge File

   You have two options:

   • Drag and drop the file from your desktop

   • Or click Browse your files and select the file from your computer
5. Set Import Options

   Under Content, select All content (recommended). You may adjust this if you have specific import needs.

6. Begin the Import

   Click Add to Import Queue to start the upload.

7. Monitor Import Status

   The Import Content page will display the status of your upload. Wait for it to show as Completed.

8. View Imported Content

   Once the import is complete, click Modules in the left-hand sidebar to view your lesson.

9. Confirm Lesson Visibility

   Your lesson—and any content marked as visible to students at the time of export—will now appear in your Canvas Sandbox Course

Step 3 - Copy the Lesson into Course

1. Access Your Sandbox Course

   After importing iCEV content into your sandbox course, open it to begin the transfer process.

2. Locate the Lesson to Copy

   Find the specific lesson you want to move into your published course.

3. Open Lesson Options

   Click the three dots (⋯) to the right of the lesson header. From the dropdown menu, select Copy To.

4. Choose the Destination Course

   A search bar will appear. Type the name of your published Canvas course where you want to send the content.

5. Confirm the Copy

   After selecting the destination course, click the Copy button.

6. Copy Confirmation

   You’ll see a message confirming that the copy operation has started successfully.

7. Verify the Lesson in the New Course

   Go to your Canvas Dashboard, open the destination course, and click on Modules. You should now see the lesson successfully copied over.

Features

NOTE: The user interface shown in these videos may look different from the current iCEV platform. While the visual design has been updated, the steps and functionality demonstrated remain the same.

Lesson Visibility

Assignment Visibility Settings

Student Feedback Options

Attempt Threshold Options

Canvas Course Assessments