Brightspace Integration Guide

Administrators’ Guide

This process should be completed by the Brightspace Administrator.

LTI 1.1 Integration Guide

1. Login to Brightspace
2. Click Admin Tools
3. Click External Learning Tools
4. Click Manage Tool Providers (Legacy)
5. Click New Tool Provider and enter the following:
   Launch Point: https://login.icevonline.com/LTI
   Version: Inherit Global (1.1)
   OAuth Signature Method: HMAC-SHA1
   Secret: please contact us for this information
   Check “Use custom tool consumer information instead of default”
   Key: please contact us for this information
   Name: iCEV
   Description: iCEV
   Contact Email: integrationsupport@icevonline.com
6. Under Visibility, check “Allow users to use this tool provider”
7. Under Security Settings, check each of the following:
   • Send tool consumer information to tool provider

   • Send context information to tool provider

   • Send course information to tool provider

   • Send course section information to tool provider

   • Send LTI user ID and LTI role list to tool provider

   • Send username to tool provider

   • Send user email to tool provider

   • Send system Org Defined ID to tool provider

   • Send link title to tool provider

   • Send link description to tool provider
8. Under Make tool provider available to, check the appropriate Org Units for your organization, and select the courses that will use iCEV content, making certain all applicable courses are selected

Creating a Course and Rostering Users

Part 1: Create a New Course

1. Log in to Brightspace with Administrator permissions
2. Click the Admin Tools gear icon in the navigation bar
3. Select Course, then click Create Course
4. Complete the required course information, including course name, course code, department, and semester or term, and configure any additional settings your organization requires
5. Click Save or Create

Part 2: Roster a Teacher to the Course

1. Navigate to the newly created course and click Classlist from the Course Administration menu
2. Click Add Participants, then Add Existing Users
3. Search for the teacher by name, username, or email address, select them from the results, and choose the Instructor role
4. Click Enroll Selected Users

Part 3: Roster Students to the Course

1. While in the course Classlist, click Add Participants, then Add Existing Users
2. Search for students by name, username, or email address and select one or more students
3. Choose the Learner role, then click Enroll Selected Users

Part 4: Verify Enrollments

1. Open the course Classlist and review the list of enrolled users
2. Confirm teachers have the Instructor role and students have the Student role
3. Make any corrections needed by editing user roles or unenrolling users

LTI 1.3 Integration Guide

This guide walks D2L Brightspace administrators through the process of registering the iCEV Learning Platform as an LTI 1.3 Advantage tool and creating a deployment within Brightspace.

Part 1: Register the iCEV LTI Tool

1. Log in to your D2L Brightspace instance using an administrator account
2. Navigate to Admin Tools → Manage Extensibility → LTI Advantage
3. Select Register Tool
4. Choose Standard as the registration type
5. Configure the tool using the following settings:
   Enabled: On
   Name: iCEV
   Description: iCEV Learning Platform
   Domain: https://login.icevonline.com
   Redirect URLs: https://login.icevonline.com/lti
   OpenID Connect Login URL: https://login.icevonline.com/lti
   Target Link URI: https://login.icevonline.com/lti
   Keyset URL: https://login.icevonline.com/lti/.well-known/jwks.json
6. Under Extensions, enable Assignment and Grade Services
7. Under Roles, enable Send Institution Role
8. Click Register

Information to Provide to iCEV

After registering the tool, Brightspace will generate information required to complete the integration within iCEV UMS. Please provide the following values to your iCEV representative:

• Client ID
• Issuer (Recommended)

Part 2: Create the LTI Deployment

Once the tool has been registered, create a deployment to make iCEV available within D2L Brightspace.

1. Navigate to:
   Admin Tools → External Learning Tools → LTI Advantage
2. Select New Deployment.
3. Configure the deployment using the following settings:
   • Deploy Tool Settings

   ◦ Enabled: On

   ◦ Auto Migrate Links: On

   ◦ Tool: iCEV (the tool name registered in Part 1)

   ◦ Name: iCEV

   ◦ Description: iCEV Learning Platform

   ◦ Extensions Enable:

   ▪ Assignment and Grade Services

   ◦ Security Settings Enable:

   ▪ User Information

   ◦ Configuration Settings Enable:

   ▪ Open as External Resource

   ▪ Grades created by LTI will be included in Final Grade

   ▪ Auto Create Grade Items

   ◦ Make tool available to:

   ▪ Select Add Org Units.

   ▪ Choose the appropriate organizational unit(s) where iCEV should be available.

   ▪ In most cases, customers select the entire organization.

   ▪ Availability may vary based on your institution's configuration.

   • Click “Create Deployment”.

Recommended: Provide the Deployment ID to iCEV. After the deployment is created, Brightspace will generate a Deployment ID. While the Deployment ID is optional for the iCEV configuration, it is recommended to provide it when available.

Teachers’ Guide

After the external tool has been set up by the Brightspace Administrator, please follow these steps.

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 Brightspace

1. Open Course Admin

   Go into the course and click Course Admin.

2. Access Import/Export/Copy Components

   Under Site Resources, click Import/Export/Copy Components.

3. Select Import Components

   Select Import Components, then from a course package, and click Start.

4. Upload the Common Cartridge File

   Select File and attach the common cartridge file downloaded from iCEV, then click Import All Components.

5. View Imported Content

   Once the file finishes importing, click View Content.