In this guide:
Before you begin
This guidance is relevant to administrators who have a Turnitin Originality, Similarity or SimCheck license.
If you access Turnitin via a URL unique to your institution (for example: https://universityofturnitin.turnitin.com), you've found the correct guidance.
If you access Turnitin via turnitin.com or turnitinuk.com, check out our LTI 1.1 configuration guidance for Feedback Studio users.
Set up in Turnitin
Create an API scope and key
You must create a separate scope and key for every integration you create. If you have various environments in your organization, such as a development or sandbox environment, create a Scope for each of them.
Give each scope a unique name to easily identify it at a later date i.e. 'University of Turnitin Sandbox'.
- From the administrator area, select the
Integrations tab. In this area, you'll find all of the current integrations active on the account. - To set up a new integration, select the Generate API Scope button in the top right.
- Name your integration and select Next.
- Name your API Key and select Create and View. Another modal will appear confirming the creation of your key.
Your API key is presented in the form of a ‘Secret’. This string of alphanumeric characters is unique to your institution. You will need this ‘Secret’ to finish setting up your integration in your LMS. You will not be able to access your ‘Secret’ again so please make a note of it now
Manage existing setups
You can create multiple keys for your scope. To create more keys, select Create New Key to the right of your scope.
Once your scope has a key or keys, you can view them by selecting the arrow to the left of your scope.
You can change the status of your key using the switch.
If you turn the status of your key to ‘Off’, then you will no longer be able to set up an integration with this key. Any existing integrations using this key will no longer work while this key remains disabled.
Select the trash can to permanently delete a key.
Once you have deleted your key you cannot restore it. Any integrations you have set up using this key will no longer work.
Set up in Sakai
- Open the Sakai.properties file in your Sakai installation.
- Change the following information to suit the needs of your institution.
Curious about what configuration options you can change? View our README file on Github.
- Once you've chosen your options, add the following information to your Sakai.properties file:
#Turnitin OC
turnitin.oc.serviceUrl=https://[your institution].turnitin.com/api/
turnitin.oc.apiKey=Your API Key from Step 1
contentreview.enabledProviders=TurnitinOC
contentreview.defaultProvider=TurnitinOC
assignment.useContentReview=true
turnitin.oc.may_view_submission_full_source.student=false
turnitin.oc.may_view_match_submission_info.student=false
turnitin.oc.may_view_submission_full_source.instructor=true
turnitin.oc.may_view_match_submission_info.instructor=false
turnitin.option.institution_check=true
assignment.useContentReview=true
turnitin.accept.all.files=true
turnitin.oc.auto_exclude_self_matching_scope=abc
See below for an example of a correct entry:
#Turnitin OC
turnitin.oc.serviceUrl=https://universityofturnitin.turnitin.com/api/
turnitin.oc.apiKey=8785436P2g22b4a7p69p3k504rr7mo3e6 contentreview.enabledProviders=TurnitinOC
contentreview.defaultProvider=TurnitinOC
assignment.useContentReview=true
turnitin.oc.may_view_submission_full_source.student=false
turnitin.oc.may_view_match_submission_info.student=false
turnitin.oc.may_view_submission_full_source.instructor=true
turnitin.oc.may_view_match_submission_info.instructor=false
turnitin.option.institution_check=true
assignment.useContentReview=true
turnitin.accept.all.files=true
turnitin.oc.auto_exclude_self_matching_scope=abc
- Save your changes and restart the server your Sakai installation is on.
Be sure to configure the Process Content Review Queue job and the Process Content Review Reports job to run every five minutes within the Job Scheduler tool in the Administration Workspace site.