This guide describes the steps required to integrate Unicheck into any LMS that supports LTI 1.1 (external tool) protocol.
Integration procedure comprises two parts:
- Creating integration in Unicheck Admin Account.
- Adding Unicheck app in your LMS.
PART 1: Creating Integration in Unicheck Admin Account
STEP 1: Name the integration
Click Create Integration under the Custom LTI icon, then choose a name for the integration, and click Next Step.
STEP 2: Review integration settings
Review the default integration settings. Instructors can change some of these settings for each individual assignment.
Recommended settings are shown on the images below.
- Store files in original format.
If the setting is ON, instructors will be able to download originally submitted files. If the setting is OFF, originally submitted documents will be unavailable, but their content (text) will still be stored in the user’s local database and used by Unicheck for comparison with other submissions.
- Show custom logo in Unicheck Reports.
Click Upload to upload a logo to be displayed in Online and PDF similarity reports. Recommended file formats: PNG or JPG. You do not need to crop or resize the picture before uploading it.
- Exclude quotes & references.
If this option is enabled, Unicheck will search and highlight in-text citations and references (APA, MLA, Chicago/Turabian, Harvard).
Excluding quotes means highlighting them in the submitted document. Detected quotes will not be checked for similarity.
Excluding references means highlighting them in the submitted document. Detected references will not be checked for similarity.
- Exclude sources.
This filter allows to automatically exclude matched sources based on the set parameters. The minimum value for “Words” is “8” (set a higher value to omit sources with longer matches). Sources with combined matched word count less than the set value will be excluded.
- Student's precheck.
If this option is enabled, the default student precheck setting will be set to ON. Instructors will be able to allow draft submissions. With this option, students can check their submissions before submitting the final version. Instructors will still be able to switch the setting OFF.
- Number of drafts to check.
Set the maximum number of draft submissions prior to final submission. Instructors can change this value.
- Precheck only.
Enable this setting to let instructors configure any particular assignment exclusively for student precheck.
- Show similarity reports to students.
Enable this setting to let students access their similarity reports.
Click Next Step.
STEP 3: Generate keys
Your credentials are generated automatically (you may copy them later). Consumer Key and Consumer Secret will be needed while adding the Unicheck app in your LMS.
Click Finish and then click View Active Integrations.
After the integration setup is over, you will see a newly created integration in the list of active integrations. Take note of Consumer key, Consumer secret (Shared secret) and Launch URL (you may return to this view to copy these keys later).
STEP 4: Review instructor permissions
Click Permissions under your integration's name and review the default instructor permissions. Recommended settings are shown on the images below.
Important: Set Grade submissions from Unicheck Report interface to ON to allow grading student submissions directly in Unicheck Assignment and Unicheck Report without going to the grading section in your LMS.
PART 2: Adding Unicheck App in Your LMS
Depending on your LMS interface and configuration, the process may vary. Usually, the Unicheck LTI app can be installed on different levels (e.g., for all courses or for a specific course).
1. Log in to your LMS as Administrator and select placement for the Unicheck LTI app (institution’s account, specific course, etc.).
2. Find an option to add an external LTI tool and fill in the required fields. You will need to copy/paste Consumer key and Shared secret, which were generated during STEP 3 of creating the integration. The keys can be found in the list of active integrations in your Unicheck account.
Example 1 (Canvas LMS):
Example 2 (Blackboard LMS):
Note: If there is a field for custom parameters, copy/paste auto_grade=0 (recommended) into the field if you do not want to enable Unicheck Auto-Grading. If auto_grade=1, Unicheck will automatically calculate a grade (originality coefficient) based on similarity score and total points available for the assignment.
3. Copy Launch URL, which can be found in the list of active integrations in your Unicheck account (see STEP 3 of creating the integration), and paste it into the Tool Provider URL field or a field with a similar name.
Note: If the field has been automatically filled with a short URL (https://corplti.unicheck.com/lti/launch), it is recommended to replace it with a unique Launch URL from your Unicheck account.
Example (Canvas LMS):
TESTING THE INTEGRATION
STEP 1: Create a Unicheck assignment in your LMS
- In your LMS, follow the procedure to create an LTI / external tool assignment.
- Enable the Unicheck app for the assignment.
STEP 2: Open the newly created assignment
If you can see the assignment pafge as shown on the image below, then the Unicheck app is working!
Go to https://unicheck.com/login, click K-12 & Higher Ed and log in to your Unicheck Admin account, then go to Integration → Active.
Click Disable if you want to disable any particular integration. Such integration will appear under Disabled tab and can be enabled at any time.
To adjust integration settings, click Settings.
To adjust instructor permissions, click Permissions.