Installation of Unicheck LTI app
Step 1: Create a Canvas integration in Unicheck account
Steps to create a Canvas integration:
Go to https://unicheck.com/login/education and log in to your Unicheck Admin account. Then go to Integration → Create New.
Click Create Integration under the Canvas LTI icon and follow the wizard to create the integration, i.e. generate Consumer key, Shared secret and Launch URL.
Note: At Step 3 of the integration wizard you will be given a Config URL - do not copy it, Launch URL will be given later, when integration wizard steps are completed. You may copy Consumer Key and Shared secret at this step. You will be able to copy them later also.
- After the integration setup is over, you will a see a newly created integration in the list of active integrations. You will need to copy Consumer key and Shared secret from this view later.
Step 2: Install Unicheck app in Canvas
Take note of the Consumer key and Shared secret from the previous step, you will need it when adding the Unicheck app to Canvas.
Unicheck LTI app, like any LTI app in Canvas, can be installed on all 3 levels: account, sub-account, specific course. In this guide we review installation steps for account level. The procedure for sub-account and course is the same, except, first, you need to navigate to specific sub-account/course in Canvas, and access level Settings from within that context.
Log in to Canvas as Administrator and select your institution’s account (in the example below ‘Unicheck’ is the name of the Canvas system account in our test environment):
Go to Settings → Apps and search for Unicheck app - Unicheck Plagiarism Checker.
Select the app to view its description and click Add App:
Tip: You may shorten app’s name to ‘Unicheck’.
Step 3: Update the Unicheck launch URL
Replace the default-generated static Launch URL with a unique Launch URL to enable the Course Copy feature in Canvas and ensure that there will be no duplicate LTI tools with identical Launch URLs in the future.
Open the app’s settings (at the same level where you installed the Unicheck app) Settings → Apps → click View App Configurations:
Find Unicheck app in the list of apps and edit its settings. Update the Launch URL to the value obtained in the Step 1, when creating a new integration:
Click Submit to finish the setup.
Enabling the grades feed
A grade is calculated automatically based on the Unicheck similarity score and maximum points for the assignment. Do this step only if instructors want to see Unicheck grades in the Canvas Grades. If this configuration step is skipped, teachers will see a T icon in the Canvas Grades (indicates Text submission).
To enable the grades feed, edit app’s configuration (account/sub-account/course): Settings → Apps → View App Configurations → Unicheck → Edit and set parameter auto_grade=1:
Click Submit to save the settings — installation is complete.
Testing the installation
Create a new assignment and change the Submission type to external tool, then select Unicheck. If you do not see Unicheck on the list of available apps, check if you are creating the assignment in the proper account/sub-account/course. Use masquerade feature to log in as a student or use a Student view (Course settings → Student View). Go to Course → Assignments and open Unicheck assignment. Add a file(s) and click Final submission:
If you see File(s) successfully submitted! notice, then everything’s has been setup correctly.
If you enabled the grade feed from Unicheck to Canvas Grades, check the Grades (it may take a minute or so to process the submission and produce a similarity report) to see that a grade was saved in Canvas. If you do not see the grade, please, refer to Enabling the grades feed.
Configuring global settings for Unicheck assignments
Upon installation of Unicheck app, default settings for new Unicheck assignments are:
Exclude submissions from the Institutional Library = OFF(recommended; controlled by instructor).
Auto Exclude Citations & References = ON (recommended).
Student precheck = OFF (recommended; controlled by instructor).
Omit sources, where percentage of similarity is less than = 0% (recommended).
Omit sources, where the number of words that match is less than = 8.
Show or hide similarity results from students = ON (recommended; controlled by instructor).
If you need to change any of these settings, open any Unicheck assignment in any course in Canvas, then open Settings:
Please refer to Configuring settings for Unicheck the assignment section of the Instructor guide for more details.
Use the integration for student precheck only
The Unicheck LTI integration can be configured exclusively for student precheck. If the student precheck mode is enabled, students will be able to perform prechecks but will not be able to make submissions to instructors within LTI assignments.
To enable the student precheck mode:
1. Go to corp.unicheck.com and log in using the details of your Unicheck Admin account. Then go to the Integration section and click Settings underneath the name of your integration.
2. Set the Student Precheck Only setting to ON (the Student Precheck setting must be also enabled).
“You do not have permission to access this page” error (iPad/Safari)
If you get an error “You do not have permission to access this page. Please reload page.” when trying to open Unicheck assignment on iPad in Safari web browser (example of the error):
In order for Unicheck app to work correctly, you need to enable cookies in Safari web browser.
Enabling cookies using Safari for iOS (iPhone/iPad/iPod touch):
From your Home screen, go to Settings > Safari.
For iOS 8 and 9: set Block Cookies to Always Allow.
For iOS 7: set Block Cookies to Never.
Please follow the steps below to reinstall the integration:
1. Log in to Canvas LMS as administrator and select the required account, sub-account or course.
2. Go to Settings → Apps and click View App Configurations.
3. Click the icon to the right of the integration name and select Delete from the drop-down menu.
4. Create a new integration as described in Integration Procedure.
Note: Unicheck Reports generated prior to reinstallation of the Unicheck app will become unavailable. If you need to keep previous reports, please contact Unicheck Support for more information before reinstalling the integration.
Tip: For any individual assignment, to restore reports generated prior to reinstallation, click Edit Assignment Settings, then click Find in Submission Type subsection and select the Unicheck app in the pop-up window.
I want to suggest a feature, provide feedback
Feel free to contact Unicheck account manager and suggest improvements or provide feedback. We’ll do our best to improve the product/service based on your suggestions.