Installation of Unicheck LTI app
Step 1: Create Canvas integration in Unicheck account
Steps to create Canvas integration:
Go to unicheck.com and click login, select tab For corporate use and use admin credentials to login. Admin credentials are provided by a Unicheck representative or account manager.
Go to INTEGRATION tab → LMS integration → click Create LMS integration button.
Click on Canvas Integration (LTI) tile and follow the wizard to create the integration, i.e. generate consumer key, shared secret and launch URL.
Note: on Step 2 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:
Copy/paste Consumer key and Shared secret from unicheck.com Admin account (see previous section “Step 1..”), and click Add App to install the app.
Tip: You may shorten app’s name to ‘Unicheck’.
Step 3: update the Unicheck launch URL
Relates to Unicheck app setup with static launch URL:
The comment below applies only to integrations which are set up with a static Launch URL:
https://corplti.unicheck.com/lti/launch. In this guide you will be directed how to setup a tool with a unique launch URL which is devoid of described limitations.
Avoid duplicate LTI tools, because Canvas will always launch the first tool it finds in the database. Canvas first looks up tool configurations by searching for an exact match between the URL that the user clicks, to the configured launch URL of the first tool it finds in the database. In the case when user has multiple Unicheck tools with the same LTI launch url, Canvas has no way of know which tool to launch, so it launches the first one it finds.
This step is optional, however, recommended. Updating launch URL to a unique value from the Unicheck account will add support for multiple app installation with no issues, and also will add support for Course Copy feature in Canvas (copying Unicheck assignments from one course to the other).
Open the app’s settings (at the same level where you installed 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 Unicheck account settings
Go to unicheck.com and log in as Administrator. Click on the profile icon → System settings.
Recommended (default) settings:
Unicheck global index is a shared database of student submissions across all Unicheck customers. You may voluntarily contribute your institution's student submissions to the database. To start sharing student submissions, set option to ON.
Recommended (default) settings:
Upload the logo of the institution to show it in the header of all Unicheck reports (exported PDF copies).
The logo will be placed on the right side of the header of the exported PDF report:
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.
Show institution’s logo in Unicheck reports (exported PDFs)
Please, refer to the of the section Configuring Unicheck account settings.
“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.
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.