Step 1- Creating your LTI 1.3 registration

The registration process for LTI 1.3 in Sakai requires you to follow several steps in sequence. The steps require you to input information from Turnitin into Sakai, and then fill in several fields in Turnitin with information from Sakai.

The 'LTI configuration light' won't show as activated on the Integration Configuration screen when you have completed the configuration.

  1. If you are part of a global institution, log in into your Turnitin account via turnitin.com. Alternatively, log in to turnitinuk.com if you are part of a UK institution.
  2. Ensure that Administrator view is enabled from the drop-down menu at the top of the screen. If Instructor or Student is selected, please change to Administrator.

  3. The Unconfigured or Configured button will appear in the Integrations column on the administrator homepage.
    1. If an integration has already been configured, select the Configured button and check that all integration details are correct.

    2. If the integration has not been configured, select the Unconfigured button, then follow steps 4 to 7.
  4. Select the LTI 1.3 button to open the configuration page.

    Unconfigured integrations will have an unlit status button. A yellow status button indicates a partially configured integration. A green status button indicates a fully configured integration.

  5. If this is your first LTI 1.3 registration, review the introduction page to get an idea what you are about to do. When you're ready use the Get Started button to do just that!

    1. If you already have a pre-existing registration, select the Create new registration button from the registration dashboard.

  6. Choose the LMS provider relevant to your configuration from the LMS Provider drop-down. Some LMS providers configure differently to others.
  7. Based on your selection the page will automatically update with the data most relevant to you. For Sakai, the set-up process has multiple phases. To begin, navigate to the Turnitin Feedback Studio section.

    The information found in this section needs to be transferred to Sakai. When prompted in the following steps, use the Copy button for the relevant field to guarantee it is copied correctly.

  8. Open a new window or tab, and log in to Sakai as an administrator.

  9. From the administrator dashboard, navigate to Site administration > Plugins > Activity Modules > Manage Activities > External Tool > Manage External Tools

  10. Open the Administration Workspace site.

  11. Access the Worksite setup for the Administrator Workspace site.

  12. Open the External Tools tab.

  13. Select the Install LTI 1.x Tool link.

  14. Start by giving the tool registration a title by filling the Tool Title field. We'd recommend something identifiable as you'll need to remember it in later steps. Change the Allow tool Title to be changed to Allow.
  15. Choose an icon to associate with the registration. This can be any that Sakai supports that will make it more identifiable for your instructors. We're partial to fa-file-text. Set Allow custom icon to be changed to Do not allow.
  16. Change the Button Text to be the same as the Tool Title. Set Allow button text to be changed to Allow.
  17. [Optional] Add a description to the registration if needed.
  18. Set the Tool Status to Enabled.
  19. Set the Tool Visibility to Visible.
  20. Switch back to Turnitin and copy what is shown in the Launch URL field into the equivalent field in Sakai.
  21. Set Allow Launch URL to be changed to Allow.
  22. Skip the Launch Key and Allow launch key to be changed (Do no allow) fields.

  23. Copy the Launch Secret from Turnitin, and paste it into the equivalent field in Sakai. Do not allow this field to be changed.

  24. Leave the Frame Height and Tool Order blank, or customize them to the needs of your Site.
  25. Set Configuration dialog when tool is selected to Bypass configuration dialog.
  26. For the following settings, select the correct state for the provided checkbox.
    SettingSelection
    Send User Names to External ToolChecked
    Send Email Addresses to External ToolChecked
    Allow External Tool to return gradesChecked
    Allow External Tool to create grade columnsChecked
    Provide Roster to External ToolChecked
    Allow External Tool to store setting dataUnchecked
    The tool can receive an LTI launchUnchecked
    The tool can receive a Content-Item or Deep-Link LaunchChecked
    Allow the tool to select from LessonsChecked
    Allow the tool to be one of the assignment typesChecked
    Allow the tool to be used from the rich text editorUnchecked
    Tool supports the privacy launch message (experimental)Unchecked
    Allow the tool to provide a common cartridgeUnchecked
    Allow the tool to provide a fileUnchecked
  27. Add the following to the Custom Parameters text box.

    originality_callbacks_enabled=1

  28. Skip the next two text boxes.

  29. Change the LTI 1.3 Support radio button to select Tool Supports LTI 1.3.

  30. Copy the LTI 1.3 Platform URL from Sakai to the relevant field within Turnitin.

  31. Switch back to Turnitn and copy the following items from the configuration screen into Sakai: LTI 1.3 Client ID, LTI Tool Keyset URL, LTI 1.3 Tool OpenID Connect/Installation Endpoint, and LTI 1.3 Tool Redirect Endpoints.

    There may be multiple LTI 1.3 Tool Redirect Endpoints. Copy them individually, and separate them with a comma.