Generate a key and secret
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 an API key for each of them.
Give each scope a unique name to easily identify it at a later date i.e. 'University of Turnitin Sandbox'.
To set up your LTI integration, you will need to generate your key and secret. If your LMS uses terms other than "key" and "secret" for LTI configurations, see the information below with equivalent terms. Then, check out the quick steps for how to generate your keys and secrets.
- From the administrator area, select the
Integrations tab. In this area, you'll find all of the current integrations active on the account. - On the Integrations page, select the Generate LTI Scope button in the top right. A Generate new LTI Scope modal will pop up.
- In the modal, type the name you'd like to use to identify the Turnitin LTI tool in the Administrator settings page. Then, select Next. A Create API Key modal will appear.
Please note that the LTI scope and key names you pick in Steps 4 and 5 will only appear on your Administrator settings page, so you can use different names to identify the Turnitin LTI tool in your LMS, if you'd like.
- In the Create API Key modal, type the name you'd like to use to identify your Turnitin LTI tool key in the Administrator settings page. Then, select Create and View. Another modal will appear containing your new key and secret.
For your security, the secret will only be shown once. Be sure to copy and save your secret in a safe location.
- Now, with your new key and secret ready, log in to your LMS and proceed to the next section to finish configuring your Turnitin LTI tool.
Managing 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 icon 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 your LMS
Setting up a new tool or plugin differs for each integration, but what is required from Turnitin is the same.
- Log in as an administrator for your LMS.
- Access the settings for adding a new tool or plugin.
Enter the following URL into an appropriate field for launch/configuration:
https://{your-tenant}.turnitin.com/lti/launch/inbox
Be sure to replace the text in the brackets with your institution's tenant. See the tip below if you're unsure of your tenant.In the custom URL your institution uses to log in to Turnitin, your tenant is the text that is after the "https://" and before ".turnitin.com." For instance, if your URL is https://southwestern-place-university.turnitin.com, your tenant is southwestern-place-university.
- Continue the final steps of your configuration in accordance to your LMS's guidance.