In this guide:
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 Blackboard
- Log in as a Blackboard administrator the same way you normally do.
- Navigate to your Administrator Panel.
- In the Integrations section, select LTI Tool Providers. This will take you to your available LTI tool providers page.
- Select Register Provider Domain.
- Under Provider Domain Status, use this as the Provider Domain: https://{your-tenant}.turnitin.com
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.
- For the Provider Domain Status, make sure Approved is selected.
-
No Secondary Hostnames are needed, so you can leave that box blank.
-
For the Default Configuration, select Set globally.
-
Next, type the Key and Secret that you or another admin at your institution generated in Turnitin.
-
Then, no custom parameters are required, so you can leave that box blank.
-
For Send User Data, select Send user data over any connection.
-
For User Fields to Send, check all the boxes (role in course, name, and email address).
-
For Allow Membership Service Access, select Yes.
-
Select Submit. Your Turnitin LTI tool has now been added. Continue to the next section of this guide to complete your LTI configuration.
Manage your LTI placement
Make sure you've completed all the steps above to add the Turnitin LTI tool to your LMS before starting the steps below.
- As a Blackboard admin, navigate to your list of available LTI Tool Providers.
- If you just completed the steps in the guides section above, you are most likely still on the available LTI Tool Providers page.
- If you navigated away, here's how to get back: Admininstrator panel > Integrations > LTI Tool Providers.
-
From the LTI Tool Providers page, check the box next to the Turnitin LTI tool you created. A downward arrow will appear.
-
Select the downward arrow to reveal the tool's menu.
-
From the tool's menu, select Manage Placement. This will take you to the Manage Placements page.
-
On this page, select the Create Placement link.
-
In the Label field, please type whatever name you would like your instructors and students to see (e.g., Turnitin).
-
Add a Description for the tool if you'd like.
-
Type a handle to help identify the placement (e.g., turnitin-similarity).
-
For Availability, select "Yes."
-
For Type, select Deep Linking content tool. Leave the box for Allow student access unchecked.
Selecting "Deep Linking content tool" allows instructors and course builders to launch the LTI tool and add content from the tool provider, rather than adding content through the Blackboard Learn interface. If the tool provider is configured so that the instructor can select multiple pieces of content in a single import, this tool can save time and simplify the workflow.
- For Tool Provider Information, use this as the Tool Provider URL:
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.
- Your Tool Provider Key and Tool Provider Secret should be filled in already, if you added them while adding the Turnitin LTI tool. If they aren't filled in, you can add them here now.
- No custom parameters are needed, so you can leave that box blank.
- Select the Submit button.