In this guide:
- Initial setup in Turnitin
- Initial setup in Canvas
- Continue setup in Turnitin
- Add the Turnitin app in Canvas
- Create a dummy assignment
Initial setup in Turnitin
- If you are part of a global institution, log in to your Turnitin account as an administrator.
- Select the name of the account and then Integrations from the side navigation.
If you are migrating from LTI 1.1 to LTI 1.3 and already have an LTI 1.1 integration set up in your Canvas test environment, please create a new Turnitin sub-account for testing how the LTI 1.3 integration works. Do not use the same account that is being used in your production environment for testing here.
If you are unsure which account is linked to your test and/or production environment, as a Canvas admin, please go to Settings, then select the Apps tab. Select View App Configurations. Select the gear icon next to your Turnitin LTI 1.1 integration and choose Edit. The Consumer key listed there is the Turnitin account ID.
- Select the LTI 1.3 button to open the configuration page.
- If this is your first LTI 1.3 registration, review the introduction page to get an idea of what you are about to do. When you're ready, select the Get Started button.
- For Canvas test environments, select Other.
- Based on your selection, the page will autofill with the information that you need to enter into Canvas to complete the integration.
- Keep this page open and open a new tab to your Canvas test environment.
Initial setup in Canvas
- Navigate to the Admin page of your Canvas environment, and then open the Developer Keys section.
- On the Account tab, select the + Developer Key button.
- From the sub-menu, select the + LTI Key option.
- A configuration screen will show. Please use the following information to fill out the fields:
| Field | Change to |
| Method | Use the drop-down to select Manual entry |
| Key Name | Create an identifiable name that will be used in the list of developer keys for your account, e.g. Turnitin |
| Redirect URLs |
https://lti.int.turnitin.com/launch https://api.turnitin.com/api/lti/1p3 |
| Title | Assign a name for the integration that Instructors will use to create a new assignment, e.g. Turnitin |
| Description | Add any information or notes you'd like to log about the integration. |
| Target Link URL | https://lti.int.turnitin.com/launch/tfs |
| JWK Method | Use the drop-down to select Public JWK URL |
- Switch to your Turnitin tab and copy the following fields. Paste them into the appropriate Canvas fields.
| Canvas language | Turnitin language |
| OpenID Connect Initiation URL | Login Initiation URL |
| Public JWK URL | Tool Public Key set URL |
Keep the Turnitin page open once you've set these fields. You'll need it during the next step to add information into Turnitin to complete the connection.
- Back in Canvas, expand the LTI Advantage Services section. Certain defaults must be set here for the connection to Turnitin to successfully pass the right data. Select the first seven options, and use the table below to ensure you have selected the correct ones.
| Toggle option | Correct toggle state |
| Can create and view assignment data in the gradebook associated with the tool | Active |
| Can view assignment data in the gradebook associated with the tool | Active |
| Can view submission data for assignments associated with the tool | Active |
| Can create and update submission results for assignments associated with the tool | Active |
| Can retrieve user data associated with the context the tool is installed in | Active |
| Can update public jwk for LTI services | Active |
| Can lookup Account information | Active |
| Can create subscription to data service data | Deactivated |
| Can show subscription to data service data | Deactivated |
| Can update subscription to data service data | Deactivated |
| Can list subscriptions to data service data | Deactivated |
| Can destroy subscription to data service data | Deactivated |
| Can list categorized event types | Deactivated |
| Can view feature flags | Deactivated |
| Can view Progress records associated with the context the tool is installed in | Deactivated |
You are now finished with the LTI Advantage Services section and it can be collapsed.
- Open the Additional Settings section. In the Domain field, enter turnitin.com. Then change the Privacy Level from Private to Public.
- Moving to the Placements section, remove of the default options by selecting the X icon in each of the pills.
- Select the now empty Placement field, and select the Course Assignments Menu option.
- On successfully setting the Placement correctly, a new Course Assignments Menu section will appear. Expand this section.
- From the Course Assignments Menu section, select the LTIDeepLinkingRequest option. All other fields can be left blank.
- Select Save and return to the Developer Keys page.
- Switch to the Account tab, if it is not already open.
- Navigate to the LTI Key that you just created. This should be identifiable by the Key Name you gave it.
- Move the switch for your LTI Key from OFF to ON.
- You'll be asked to confirm changing the state of the developer key. Select OK to continue.
- From the Details column, copy the fifteen-digit developer key you just activated.
You do not need to use the Show Key button to do this. Simply copy the fifteen-digit key.
- Keep your Canvas test tab open.
Continue setup in Turnitin
You can only complete this section if you have kept the same Turnitin page open that you used in the Initial Canvas setup section above. If you have not kept this page open, you will have to start the process again.
- Return to the Turnitin configuration page you should still have open.
- Navigate to the LMS Details section of the Turnitin configuration page and add the following data. Please note that the Canvas test environment use slightly different URLs, as outlined below.
| Turnitin field | Change to |
| Client ID | Paste the fifteen digit LTI Key that you previously copied. |
| Platform public key set URL | https://sso.test.canvaslms.com/api/lti/security/jwks |
| Issuer | https://canvas.test.instructure.com |
| Access token URL | https://sso.test.canvaslms.com/login/oauth2/token |
| OpenID connect login endpoint | https://sso.test.canvaslms.com/api/lti/authorize_redirect |
| Platform authorisation provider | Leave blank |
- Use the Save button to complete the configuration process. Next, you'll add the Turnitin app to make it available to instructors in your environment.
Add the Turnitin app in Canvas
- Go back to your Canvas test tab and switch to the Settings section of the Admin page. Then select the Apps tab.
-
Select the View App Configurations button.
- Select the + Add button.
- Change the Configuration Type to By Client ID.
- Paste the developer key you copied into the Client ID field.
- Select the Submit button.
- You'll be asked to confirm the app installation. Select the Install button to continue.
Create a dummy assignment
When configuring a new Turnitin integration within your LMS, you must run our deployment workflow before your institution can start using the integration.
The deployment workflow requires the Turnitin account administrator at your institution to link the integration to a specific Turnitin sub-account. This workflow will launch automatically when attempting to use the integration for the first time, which is why we recommend creating a “dummy” assignment to complete your configuration.
This process will only have to be done once for your account, and this will not appear for any instructors and students.
- Navigate to the course where you would like to add Turnitin.
- Select the vertical ellipsis menu icon ⋮ and select Turnitin.
- You will be prompted to log in to your Turnitin administrator account.
-
Once you have logged in to Turnitin’s deployment workflow, you will either be provided with a list of existing configurations or the option to create a new one.
If you are migrating from LTI 1.1 to LTI 1.3, we recommend that you link to the same configuration that you used for the LTI 1.1 integration.
- To link to an existing configuration, locate the name of the configuration in the list provided and select the link button. If there is a lock icon in place of the link button, that configuration cannot be used for this deployment.
- To create a new deployment - Select the Create New or Create Deployment button, depending on which you have available.
- Select the Turnitin account the configuration should be registered to and select Next.
- Enter a descriptive name for the deployment, as it may be listed for future configurations in your LMS. Select Next.
- Confirm the deployment to complete your configuration. If successful, you will be prompted to log out of the deployment workflow and return to your LMS.