Installing the Unicheck LTI app
In this section we will review how to install the Unicheck LTI app on top-level account in Brightspace LMS.
Part 1: Creating a Brightspace integration in the Unicheck account
Go to https://unicheck.com/login, click K-12 & Higher Ed and log in to your Unicheck Admin account. Then go to Integration → Create New.
STEP 1: Name the integration
Click Create Integration under the Custom LTI icon, then choose a name for the integration (e.g., “Brightspace”), and click Next Step.
STEP 2: Review integration settings
Review the default integration settings (only Administrator can change them).
Recommended settings are shown on the images below.
- Store original documents.
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 plagiarism.
Excluding references means highlighting them in the submitted document. Detected references will not be checked for plagiarism.
- 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 API keys
Your API credentials are generated automatically (you may copy them later). Consumer Key and Consumer Secret will be needed while adding Unicheck app in Brightspace LMS.
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).
Click Finish and then click View Active Integrations.
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.
Part 2: Adding Unicheck app in Brightspace
NOTE: Unicheck app should be installed as an LTI 1.1 Tool Provider. Other installation scenarios are not supported (i.e. remote plugin is not supported). Once tool provider is added and configured, instructors can create External Learning Tool links in their Courses.
An excerpt from BrightSpace community article:
“Next, have instructors add External Learning Tool Links to their Course. If the Tool Provider Settings are already done, this step becomes quite simple for Instructors. In the Content Tool the Instructor selects "Add Existing Activity" and then "External Learning Tools". Next, the Instructor selects "Create New LTI Link". The last step is for the Instructor to enter a Name for the LTI Link and the URL of the LTI Link and then click "Create and Insert".
This approach allows for the easy creation of multiple External Learning Tool Links within the Course. It also means that each LTI Assessment that an Instructor adds to their course will have its own grade item.”
Below are the links to official documentation as well as articles and recommendations on installing LTI in Brightspace LMS.
Configure Learning Tool Interoperability support - link
Setting Up An LTI 1.1 Integration In Brightspace - link
Configuring LTI at the org level - link
Configuring LTI at the org unit level - link
Set Up a Tool Provider (LTI 1.1) in Brightspace
- Set up a new tool provider in Brightspace (use Brightspace guide).
It is recommended to set up the Unicheck app at the Org level, and then add Org units as necessary. When you set up a tool provider, you will be asked for a Key, Secret and Launch URL, which can be found under the name of your integration in the Unicheck account (see STEP 3 of Creating a Brightspace integration in the Unicheck account).
- In BrightSpace, configure visibility and security settings as on the screenshot below:
- The last step is to add the required Org Units.
Save the configuration to finish the setup.
Increasing the height of the iFrame in Brightspace
You can increase the height of an iFrame in Brightspace to display Unicheck app in full height (Brightspace guide: Edit a configuration variable).
VARIABLE NAME: d2l.Tools.Content.ContentIFrameHeight
As a suggestion, set the value of the variable to 1200.
Configuring global settings for Unicheck assignments
Upon installation of the 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 (recommended)
Show or hide similarity results from students = ON/OFF (to be decided by institution)
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.