Overview
This document contains the steps that an administrator will need to perform to configure LTI 1.3 when using zyBooks. This must be performed by the LMS administrator since an instructor does not have the required privileges.
We currently support LTI 1.3 in the following LMS's.
Canvas
Creating the LTI 1.3 Tool
1. On the left-hand side, click on “Admin”
2. Click on “Developer Keys” towards the bottom of the left-hand side of the page
3. Create a new LTI key by clicking the blue “Developer Key” button in the upper right and select “LTI Key”.
4. In the popup, give the tool a name and optionally provide an owner email. Fill in the following fields and click the blue save button on the lower right corner.
Key Name: You may set this to “zyBooks LTI 1.3” or whatever name you wish this key to be called.
Redirect URI: https://lti1-3.zybooks.com/v1/lti1p3/provider
Method: Enter URL
JSON URL: "https://lti1-3.zybooks.com/v1/lti1p3/canvas_config"
5. The new LTI 1.3 tool key should be automatically configured with the settings required for zyBooks.
For reference, this is what it should look like.
6. Additionally, please be sure that the Privacy level is set to "Public".
7. In the list of keys, ensure that the state of the new key is set to “ON” as shown below.
8. Record the client id of the LTI tool (in the screenshot above, this is 10000000001583).
Send this information to Support <support@zybooks.com> and your institution will have LTI 1.3 access to zyBooks.
Additionally, please send your LMS domain name to Support as well.
9. Important: Be sure to provide the tool so that instructors are able to use the tool.
Providing the LTI 1.3 Tool to Canvas Instructors
Now that the LTI 1.3 tool is configured, you may provide the client id to instructors and have them follow the steps below to add this tool to their course.
In Canvas, LTI 1.3 tools can be provided at the Account level or the Course level. We recommend adding it at the Account level to prevent having to add it to each course individually.
Adding the tool at the Account level
1. Click on Admin. Then, the account you wish to add the tool to.
2. Once inside the account, scroll to the bottom and click on "Settings".
4. Next, skip to the steps under Adding the App in View App Configurations in order to complete the process.
Adding the tool at the Course level
1. In the desired Canvas course, select “Settings” on the bottom left.
2. Next, select the “Apps” tab on the toolbar towards the top of the screen.
Adding the App in View App Configurations
1. Click “View App Configurations”.
2. Click the blue “+ App” button.
3. Under “Configuration Type”, select “By Client ID” and enter the client id provided by the canvas administrator. Then click the blue “Submit” button.
4. Finally, click “Install” to install the tool.
The tool will be installed in the desired account/course.
Blackboard
Adding the LTI 1.3 Tool to Blackboard
1. Log in as a Blackboard Administrator and go to the System Admin tab.
2. Under Integrations, click LTI Tool Providers.
3. Open the “Register LTI 1.3 Tool” tab and enter the following Client id.
c927f5f0-6ad9-4a45-8d60-2a505a9b39ae
4. You will be presented with the settings for the new LTI 1.3 tool as shown below.
5. Scroll down and ensure that the following fields are set then click the blue “Submit” button.
- User Fields to Send: “Constituency in Course”, “Name”, and “Email Address”.
- Allow evaluation service access: Yes. This is critical for grade passback to work with your zyBook.
- Allow Membership Service Access: Yes.
6. You will be brought back to the LTI Tool Providers page. Scroll through the list of tools to find LTI 1.3 tool and click on the arrow next to the tool name. Then click Manage Placements.
7. In the upper left, click “Create Placement”.
Provide a label and tag for the tool that will be displayed when adding a LTI 1.3 assignment. This will be the name shown to instructors at your institution.
8. Fill in the following fields.
- Availability: Yes
- Type: Select "Course content tool" and "Allows evaluation". Unselect all other fields.
- Launch in New Window: Optionally, set this if you want LTI launches to appear in a new tab.
- Tool Provider URL: Enter https://lti1-3.zybooks.com/v1/lti1p3/provider
9. Click Submit at the bottom.
The placement will be added and the LTI 1.3 tool will be accessible to instructors.
10. On the LTI Tool Providers page find the LTI 1.3 tool and select Edit.
Find the Deployment ID of the tool and send this information to Support <support@zybooks.com> to configure access.
Additionally, please send your LMS domain name to Support as well.
Instructors may create a new LTI 1.3 link by visiting the content pane of their course and selecting the LTI 1.3 tool as shown below. The linking process is exactly the same as with previous versions of LTI.
Brightspace
Creating the LTI 1.3 Tool (for D2L/Brightspace Admins)
1. While logged into D2L/Brightspace as an admin, click on the gear icon in the upper right-hand corner and select “Manage Extensibility”.
2. Select “LTI Advantage” at the top, then click the “Register tool” button.
3. When prompted for the type of the tool, select “Standard”.
4. In the fields below, fill out the following.
- Name: zyBooks LTI 1.3
- Domain: https://lti1-3.zybooks.com
- Redirect URLs: https://lti1-3.zybooks.com/v1/lti1p3/provider
5. Then, fill out the following fields:
- OpenID Connect Login URL: https://lti1-3.zybooks.com/v1/lti1p3/oidc
- Target Link URI: https://lti1-3.zybooks.com/v1/lti1p3/provider
- Keyset URL: https://lti1-3.zybooks.com/v1/lti1p3/jwks
-
Extensions: Make sure
Assignment
andGrade Services
are selected or grade passback will not work. Also, make sure to selectNames and Role Provision Services
. -
Roles: Make sure
Send Institution Roles
is selected.
6. Click the blue “Register” button on the bottom left.
You will see a popup that will have several pieces of information on it. Copy these values and save them. You will send this to zyBooks so we can set up your LTI 1.3 integration.
7. Close the popup and from the gear icon in the upper right-hand corner, select “External Learning Tools”
8. Select the “LTI Advantage” top on top, then click the “New Deployment” button.
9. Fill in the following.
- Tool: zyBooks LTI 1.3
- Name: zyBooks LTI 1.3
-
Under “Extensions”: Make sure
Assignment and Grade Services
,Deep Linking
, andNames and Role Provisioning Services
are selected
10. Under “Security Settings”, select all of the checkboxes except for “Anonymous”.
Note: if Auto Create Grade Items
is checked, the grade item will automatically be created with the points set to 100 as soon as the first student submits. Scores will populate this grade item instead of the one the instructor created/added themselves.
12. Make sure to add your Org Unit using the Add Org Units
button to make the tool visible to instructors.
Note: Instructors should have permission to create a new link for external tools.
13. Click “Create Deployment” then copy the deployment ID
. You will email this along with the Client ID
, public keyset URL
,access token URL
, and authentication or oidc URL
to zyBooks Support (support@zybooks.com) once the tool has been fully set up.
Moodle
1. To get started, navigate to the "Plugin" section and select "configure a tool manually".
2. Fill out the following details
- Tool name: zyBooks LTI 1.3 (or similar)
- Tool URL: https://lti1-3.zybooks.com/v1/lti1p3/provider
- Tool description: (optional)
- LTI Version: LTI 1.3
- Public key type: Keyset URL
- Public keyset: https://lti1-3.zybooks.com/v1/lti1p3/jwks
- Initiate login URL: https://lti1-3.zybooks.com/v1/lti1p3/oidc
-
Redirection URI(s): https://lti1-3.zybooks.com/v1/lti1p3/provider
- Default launch container: New window
3. Ensure that the Services settings match the following.
- IMS LTI Assignment and Grade Services: Use this service for grade sync only
- IMS LTI Names and Role Provisioning: Use this service to retrieve member's information as per privacy settings
4. Ensure that the Privacy settings match the following.
- Share launcher's name with tool: Always
- Share launcher's email with tool: Always
- Accept grades from the tool: Always
5. Once you save the details you will be provided with tool configuration details.
Please share these details with support@zybooks.com.