Upgrading from 1.1 to 1.3 in Agilix Buzz - User guidance

In this guide:

• Update LTI 1.1 integration to facilitate the upgrade to LTI 1.3
• Configure LTI 1.3 Integration
• Deploy LTI 1.3 Integration

Update LTI 1.1 integration to facilitate the upgrade to LTI 1.3

1. Log in to Buzz as an Admin. In Domain settings, scroll down to LTI 1.1 tools, find the Turnitin LTI 1.1 tool, and select edit.

   

2. Make note of the Turnitin account listed in the key field and select Remove this LTI tool.
3. In a separate tab, log in to turnitin.com as an administrator, find the corresponding account ID, and select the configured button at the end of the row.
4. Select LTI API.
5. Note the shared key. Select Account list in the left corner and keep it open.

6. Navigate back to the browser tab that contains the Domain Settings in Buzz, scroll down to LTI 1.1 tools, and select Add.

   

7. In the host name field, enter turnitin.com (it was previously api.turnitin.com), then enter in the same key (Turnitin Account ID) and secret (shared key) that was used for the LTI 1.1 integration.
8. Confirm access to past LTI 1.1 assignments and submissions.

Configure LTI 1.3 Integration

1. Log in to Buzz as an Admin. In Domain settings, scroll down to LTI 1.3 tools, and select Add.
2. Navigating back to turnitin.com, locate the same Account ID used for the LTI 1.1 integration and select the account name, then select Integrations from the side navigation.
3. Select LTI 1.3 and then Get Started.
4. Select Other from the LMS provider dropdown menu.

5. Name your registration.

   

6. Copy the Login Initiation URL and navigate back to the LTI 1.3 tool configuration in Buzz. Give the tool a title (we recommend Turnitin) and enter turnitin.com in the tool hostname field.
7. Paste the Login Initiation URL into the OpenID Connect login URL field.
8. Navigate back to turnitin.com and copy the Tool Public Key Set URL and paste it into the Tool key set URL field in the LTI 1.3 tool configuration in Buzz.

9. Navigate back to turnitin.com and copy the Launch URL/Tool Redirect URLs and paste them into the Tool redirect URL field in the LTI 1.3 tool configuration in Buzz. Separate these with a comma and no space between them.

   

10. In the User data sent at launch field, make sure all options are checked.
11. In the LTI services field, make sure all options are checked.
12. Navigate back to turnitin.com and copy the Target Link URI and paste it into the Deep-linking redirect URLs field in the LTI 1.3 tool configuration in Buzz.
13. Now, copy the Client ID and navigate back to the LTI 1.3 configuration page in turnitin.com. Scroll down to LMS details and paste the Client ID into the corresponding field.
14. Copy the Issuer from the LTI 1.3 configuration field in Buzz and paste it into the corresponding field in LTI 1.3 configuration page in turnitin.com.
15. Copy the Platform key set URL from the LTI 1.3 configuration field in Buzz and paste it into the Platform public key set URL field in LTI 1.3 configuration page in turnitin.com.
16. Copy the OpenID connect auth URL from the LTI 1.3 configuration field in Buzz and paste it into the OpenID connect login endpoint field in LTI 1.3 configuration page in turnitin.com.

17. Copy the OAuth2 access token from the LTI 1.3 configuration field in Buzz and paste it into the Access token URL field in LTI 1.3 configuration page in turnitin.com.

    

18. Then select save.
19. Navigate back to the LTI 1.3 configuration page in Buzz and make sure that the Domain-wide and Enabled boxes are checked. Then select Done.
20. Select Save and then OK.

Deploy LTI 1.3 Integration

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.

1. Navigate to a course and choose Editor.

2. Select Add Activity.

   

3. Then choose the External tools tab. You should see your new Turnitin LTI 1.3 option there.
4. You will be prompted to log in to your Turnitin administrator account.

5. 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.

   1. 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.
   2. To create a new deployment - Select the Create New or Create Deployment button dependent on which you have available.
      1. Select the Turnitin account the configuration should be registered to and select Next.
      2. Enter a descriptive name for the deployment as it may be listed for future configurations in your LMS. Select Next.
6. 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.
7. Once you've linked your account and finished creating your assignment, the dummy assignment can be deleted. Your registration has been initialized.