Introduction
This document walks you through the step-by-step instructions on how to integrate the Proview LTI application with Canvas LTI.
Objective
- Minimum required canvas version
- Create LTI Key
- Create API Key
- Install the Proview LTI App
- Install Scripts in the Theme to inject Proview SDK
- List of details to be shared with Inspera
- Configure Proview LTI for the course
- View the recording of the proctored quiz
Minimum required canvas version
Proview LTI is based on LTI 1.3 and requires a canvas instance that supports LTI 1.3 protocol and LTI Advantage.
Create LTI Key
Navigate to Add LTI Key
- Login to Canvas LMS as admin
- Click on Admin and click the Main Account
- Click on Developer Keys
- Click on the Developer Key button
- Select LTI Key
Configure LTI Key
Key name: PROVIEW LTI 1.3
Owner email: Your Canvas admin email
Redirect URIs:
https://lti.talview.com/lti_launches
https://lti.talview.com/users/auth/canvas/callback
Configure
Method: Manual entry
Title: PROVIEW LTI 1.3
Description: PROVIEW LTI 1.3 Application
Target Link URI: https://lti.talview.com/lti_launches
OpenID Connect Initiation URL: https://lti.talview.com/lti_launches/init
JWK Method: Public JWK URL
Public JWK URL: https://lti.talview.com/jwks.json
LTI Advantage Service
Enable all
Additional Settings
Custom fields:
canvas_sis_id=$Canvas.user.sisid
canvas_user_id=$Canvas.user.id
canvas_course_id=$Canvas.course.id
canvas_account_id=$Canvas.account.id
custom_canvas_api_domain=$Canvas.api.domain
Privacy Level: PUBLIC
Course Navigation
Target Link URI: https://lti.talview.com/lti_launches?navigation=Course
Text: Proview
Click on Save once you entered the provided value. Make sure the created LTI key State is ON.
Create API Key
Navigate to Add API Key
- Login to Canvas LMS as admin
- Click on Admin and click the Main Account
- Click on Developer Keys
- Click on the Developer Key button
- Select API Key
Configure API Key
Key Name: PROVIEW API key
Redirect URI (Legacy): https://lti.talview.com/users/auth/canvas/callback
Once you enter the provided value click the Save button. Make sure the created API key State is ON.
Share the API Key ID and the API token with Inspera
Install Proview LTI Application
Add Proview LTI Application
- Make sure both the developer key and LTI key state in ON
- Copy the LTI key
- Goto the course or account where the app needs to be added
- Click on Settings
- Click on the Apps tab
- Click on View App Configuration
- Click on +App
- Configuration Type: By Client ID
- Client ID: Paste the LTI Key
- Click Submit
Copy Deployment ID
- Click on the Apps tab & Identify the LTI Application
- Click on the Gear icon present in the Application name (PROVIEW LTI 1.3)
- Choose Deployment ID
- Copy the deployment ID
- Share the copied deployment ID with the Inspera team
Hide Proview LTI App to Students
Navigate to the Developer Keys page and edit the PROVIEW LTI key
Select the Paste JSON option for Choose Method
In LTI 1.3 Configuration Add the field “visibility”: “admin” inside of the extensions placement and save.
Install Scripts in the Theme to inject Proview SDK
For the Proview SDK injecting during quiz a script needs to be uploaded on the current theme being used on the account. Navigate to the theme currently being used and upload the Canvas Script in the Upload tab.
List of details to be shared with Inspera
- LTI App deployment ID
- API Key ID
- API Token
- LTI Key ID
- Canvas instance URL
- Proview test admin username and password
Configure Proview LTI for the course
Choose the course you want to configure proctoring. Click on Proview in the navigation. Select the Course module in the dropdown. This will list all the quizzes available in the module. Select a quiz you want to configure proctoring.
From this page, you can:
- Enable or disable proctoring for the quiz
- Select the proctoring type
- Provide instructions for students that will be shown during the proctoring session
- Provide instruction to Proctors when it is a live proctoring session
- Add reference links that need to be shown to students during the proctoring session
- Enable Secure Browser for the proctoring session and other additional configurations to customize Secure Browser
Activating the LTI App
Once the LTI app is activated from the Inspera side. The admin should launch the LTI app from a course in which the LTI app is enabled. When the admin launches the LTI app for the first time, the app will prompt for authorization for the API token which needs to be allowed. Once the activation is complete the LTI app is ready for use.
Viewing the Proctored Session
The post-exam review process aims to facilitate exam administration and student evaluation through the LMS. This document outlines the step-by-step procedure for administrators to access and review exam results, including utilizing playback view recordings of students
View the recording of the proctored quiz
- To view the recording of a proctored session of a quiz you can navigate to the quiz and select the student you want to view the recording for.
- Click on Show student quiz results
- You will be able to see the number of attempts made by the student and view record button
- By clicking on the View Record the recording screen should open in a new tab.
LMS scheduling validations
LMS DATA SYNC
Quiz data sync:
In the integrated workflow data is synchronized upon the creation, update, or deletion of a quiz in LMS. Following are the attributes that are processed as part of integration:
- "quiz_title": Title of the quiz
- "action": Action type (0 for New quiz Creation, 1 for update, and 2 for deletion)
- "quiz_id": ID of the Quiz
- "course_id": ID of the course in which the quiz is created
- "course_module_id": Course Module ID of the quiz
- "proctoring_enabled": Proctoring status (true or false)
- "proctoring_type": Type of proctoring
- "tsb_enabled": TSB (Time Slot Booking) status
- "timeopen": Opening time of the quiz
- "timeclose": Closing time of the quiz
- "timelimit": Time limit for the quiz
- "timemodified": Last modification time of the quiz
- "timecreated": Creation time of the quiz
Enrollment data sync:
Quiz enrollment data is processed only if the quiz is marked for live proctoring. The Proview LMS integration layer pulls the data based on schedule identified for the customer. This logic can changed based on the LMS platform and its capability.
Following are the attributes that can be processed
- First name
- Last name
- Email address
- LMS user ID
- Status
- Extra time
- Candidate instruction
Note: If automated data sync is not part of the implementation then the schedule and enrollment data should be sent to Inspera in CSV file format with the below mentioned fields
VALIDATION STEPS FOR SCHEDULING INFORMATION
The validation process can be carried out by either the client or Inspera, with two distinct methods: client validation and Inspera validation.
Client validation involves the following steps:
- Quizzes Creation: The client creates quizzes tailored to their specific requirements.
- Data Sync: Once the quizzes are created, Inspera synchronizes the data.
- Bulk Data Download: Inspera then downloads the synchronized data in bulk.
Offline Validation: The synchronized data is shared with the client offline, allowing them to validate the data at their convenience
Inspera validation involves the following steps:
- Quizzes Creation: Client creates quizzes based on the specifications provided.
- Information Sharing: The client shares the exam schedule and enrollment list with Inspera as per the template provided.
- Schedule Validation: Inspera conducts validation checks on the provided exam schedule to ensure if all the quizzes are accurately created and visible in Inspera database
- Enrollment Validation: Inspera verifies the enrollment list to confirm that all intended participants are correctly registered for the quizzes.
SCHEDULE VALIDATION
Once quizzes are created in LMS by the client, and exam schedule is shared with Inspera, the following validation steps are performed:
- Quiz ID Check:
- Verify if the quiz ID is visible in the Inspera database.
- Proctoring Enabled:
- Verify if "proctoring enabled" is set to true.
- Proctoring Type:
- Verify if the correct "proctoring type" has been selected: live_proctor/ai_proctor.
- TSB Enabled (Secure Browser):
- Verify if "TSB enabled" is false if the exam is configured without the secure browser.
- Verify if "TSB enabled" is true if the exam is configured with the secure browser.
- Quiz Open Time:
- Verify if "Quiz open time" is set correctly as per the schedule, with a minimum of 30 minutes prior to the scheduled time in Proview
- Quiz Close Time:
- Verify if "Quiz close time" is set correctly as per the exam duration.
- Onboarding buffer time:
- The buffer time for onboarding can be adjusted to ensure that students join well in advance of the actual test start time, allowing them to complete pre-flight validations with the live proctor.
ENROLMENT VALIDATION (SOURCE VS INTEGRATION)
If enrolment information is shared, we can validate it against the data processed via integration.
- Validate Student Count:
- Using the quiz ID, verify that the student count enrolled matches the attendee sync count for each quiz.
- Student Identification:
- With the help of student email IDs or unique IDs, manually check if all the students in the enrolment list match the attendee sync data.
- Validation Result:
- The schedule and enrolment discrepancies are communicated to the client to enable them to make necessary corrections in the LMS platform and re synchronize the data accordingly.
Recommended validation cycle -
- The data from LMS will be synced by Inspera at an interval of 4 weeks, 2 weeks, and 48 hours from the start of each exam date.
- All Cancellations/rescheduling will be closed 48 hours prior to the test date. Any cancellation or changes to the bookings will still result in a chargeable session to the client.
- Between 2 weeks to 48 hours from the exam date, the deviation on the extra candidate volume cannot be more than 5%
Approaches to Event Scheduling
- Automated scheduling through cron jobs: Depending on the specific needs of the customer, scheduling can be automated by setting up cron jobs on a schedule. For institutional customers, like colleges and universities, it's advisable to configure the cron job to run once every 24 hours. However, this interval can be adjusted to a shorter timeframe upon customer request.
- Manual scheduling: Once the initial two steps are completed, Inspera's Managed Service Team can proceed to manually organize the live proctoring sessions.
Important Notes:
- Automatic scheduling occurs without manual intervention and is initiated 48 hours prior to the event.
- Manual scheduling requires admin portal access and involves entering event details manually.
- Once an event is scheduled and published, changes such as altering the date, time, or attendee list are restricted.