Administrator

For LTI 1.1 tool links, domain administrators configure Buzz by adding an LTI 1.1 Tool in Domain settings. The tool definition includes a DNS hostname (such as api.turnitin.com), a public key, and a shared secret.

1. Open the vertical menu in the toolbar of Domain Details.  
2. Select Domain Settings.

3. On the LTI 1.1 tools card, click Add.
4. Provide:
   • The Hostname; use the URL that matches your location:
     • UK users: api.turnitinuk.com
     • All other users: api.turnitin.com
   • The LTI Key (your Turnitin account number)
   • The account Secret (configured by your Turnitin administrator in the Turnitin LTI integration setup).
   • Note: To integrate other LTIs, follow these same steps using the proper information. Consumer Keys and Shared Secrets are generated for individual institutions. Your institution should have the necessary information. 
5. Save.

Domain administrators configure Buzz for LTI 1.3 tools in Domain settings:

1. Click Add on the LTI 1.3 tools card. 

2. Provide the following:
   • Tool Title as you want it to appear.
   • A Description of the tool (optional).
   • A DNS Tool hostname (such as api.turnitin.com if you are integrating with Turnitin).
   • The following fields (provided by the LTI provider; you can search their help documentation for instructions on how to access this information):
     • OpenID connect login URL
     • Tool key set URL
     • Tool redirect URL (You can enter multiple URLs using comma-separated lists.)
   • In the User data sent at launch dropdown, check the boxes next to the user data you want included:
     • Given name
     • Family name
     • Display name
     • Email
3. In the LTI services dropdown, check the boxes next to the services included in the tool:
   • Assignment and grade
   • Names and role provisioning
   • Deep linking (You can enter multiple URLs using comma-separated lists.)
     • To use deep linking, you need to get the Deep-linking redirect URL from the LTI Provider for the field that appears below. From some LTI Provider's, like Turnitin, this is called the Target Link URI.
4. This section provides the values that the LTI provider needs; copy them with the Copy icon, and provide what is requested (review the LTI provider's help documentation to find out where to provide this).
5. Some tools require additional POST parameters. You can add those using Add custom parameter during setup. Click the button and add the Parameter name and Value for each.
6. Check the Domain-wide box to apply the integration to subdomains.
   • Example: If you administer a district domain that has several child domains that are schools, you can configure the tool in the district domain, check this box, and all courses in all the school domains can use the tool without manually configuring the tool in each school domain. (Note: This feature is not available in 1.1 tools.)
7. Check the Enabled box to make the integration live; if this box is not checked, Buzz ignores the tool when launching links.
   • Note: Disabling and enabling an integration is not available in 1.1 tools.
8. Click Done and Save the new settings.

Buzz hosts LTI tools in iframes. By default, Buzz creates an iframe that is a few pixels shorter than the height of Buzz's content area to maximize the viewing area for the tool while also giving a visual indicator that more Buzz UI appears below the LTI tool's iframe (navigation, peer-help, learning objective information, etc.)

Depending on the user's browser and monitor size, this may cause two vertical scrollbars to appear in Buzz, one in the iframe and one outside of it.

Buzz supports a postMessage Web API that allows an LTI tool to communicate with Buzz to change the height of the iframe so that the tool's content can be rendered without a scrollbar inside the iframe.