How do I integrate my domain with LTI 1.1 and 1.3 tools (like Turnitin and Google Assignments) with Buzz?
Note: If you are trying to integrate with Publish Anywhere, use the instructions here.
Buzz allows you to integrate entire domains with LTI tools (like Turnitin and Google Assignments), so that teachers and other course authors can link to LTI activities.
This article covers how to integrate your domain:
Configure LTI 1.1 tools
Note: Buzz has actively supported IMS Global's LTI specification since it was created in 2010. Buzz is an 1EdTech-certified (formerly IMS) LTI 1.1 learning platform, which allows you to access other LTI-certified tools from within Buzz.
In 2019, 1EdTech (formerly IMS announced that its LTI 1.3 and LTI Advantage specifications, which provide additional functionality and security, would replace the soon-to-be deprecated LTI 1.1 specification. Buzz continues to support LTI 1.1, and is also now an 1EdTech-certified (formerly IMS) platform for LTI 1.3 and LTI Advantage.
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.
- Open the vertical menu in the toolbar of Domain Details.
- Select Domain Settings.
- On the LTI 1.1 tools card, click Add.
- 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.
- The Hostname; use the URL that matches your location:
If you administer multiple Buzz domains, you must configure this tool in each domain from which you launch the tool links.
A course author/instructor can also configure a tool on a single activity by providing a key and secret directly on the activity. This lets the instructor use a personal account for the tool without having to contact an administrator to configure a domain-wide credential.
Configure LTI 1.3 tools
Domain administrators configure Buzz for LTI 1.3 tools in Domain settings:
- Click Add on the LTI 1.3 tools card.
- Provide the following:
- Tool Title as you want it to appear.
- A Description of the tool.
- A DNS Tool hostname (such as api.turnitin.com).
- The following fields provided by the LTI provider (search their help documentation for instructions on how to access this information):
- OpenID connect login URL
- Tool key set URL
- Tool redirect URL
- Deep-linking redirect URL (if selected in the LTI services field, below)
- 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
- 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 (if selected, you need to get the Deep-linking redirect URL from the LTI Provider and enter it in the field that appears)
- 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).
- 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.
- Scroll down and 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.)
- 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.
- Click Done and Save the new settings.
Note: As each LTI provider has a different LTI setup process, you will need to review their help documentation to find find the information you need to provide in Buzz, and where to use the information you copied from Buzz.
If you're integrating with Google Assignments, you can find links to their steps in our article: How do I integrate Buzz with Google Assignments (LTI)?
Resizing iframes from an LTI tool
This is an API task that requires coding and should be done by a content developer with that knowledge.
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 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.
Since Buzz and the LTI tools are hosted on different domains, we use the postMessage API to communicate between Buzz and the tool. The LTI tool calls
postMessage on the top level window using
window.top.postMessage with the target origin of ‘*’. This table summarizes the messages that the Buzz LTI Tool API defines:
|LTI frame posts this message to resize the iframe. The
You can set
window.logLtiMessages = true from the browser console to log messages to the console.