Get help with LibApps, LibAuth, & LTI Tools

The Single-Course LTI tool (formerly known as the Manual LTI tool) allows you to embed Guide content, Database links, and/or E-Reserves Courses into Brightspace / Desire2Learn (D2L).

As with most instructions for other vendors' products, instructions may be a bit different, depending on the version of Brightspace you're using. The general idea of the thing holds true, though:

• First, you need to get the LTI tool's configuration information from LibApps.
• From within Brightspace, you need to register the Tool.
  • Note: If an LTI tool has already been registered in Brightspace, you should not create another tool--additional LibApps LTI tools will have their details (specifically, their Redirect URL) amended to the first tool registered.
• Then you need to create a Deployment for the Tool, and define which Org Units can use it.
• Next, you need to set up the Link for the Deployment to use within the system.
• Finally, you can set up a link (or several) to the tool within a master course, if you wish. Or just let course authors/editors know the link is available to them to use.

LibApps: Get the Configuration Information

The LibApps LTI Tool is available to CMS and E-Reserves subscribers. You must be a LibApps Admin to get the configuration information for your system.

You'll need to provide your Brightspace / D2L admins with this configuration information for the Single-Course tool or create them an account in one of your Springshare apps and make them a LibApps Admin.

1. Go to the LibApps Dashboard.
   • Log in using your LibApps login URL, or
   • Log into any of your Springshare products, click the blue menu on the left, and choose LibApps.
2. Go to Admin > LTI Tool Builder.
   • LibApps Admins can access this area. If you are on the LibApps dashboard and do not see an Admin menu, you are not a LibApps Admin.
3. Click the Add LTI 1.3 Tool button.

4. Set the Tool Name.
   • ​This field will not update in Brightspace after this tool is installed, so choose wisely! If you choose to change the tool after installing it in Brightspace, you'll need to reinstall it, which will break all existing connections.
5. Set the Tool Description.
   • ​This field will not update in Brightspace after this tool is installed, so choose wisely! If you choose to change the tool after installing it in Brightspace, you'll need to reinstall it, which will break all existing connections.
6. Choose to enable the Custom Header/Footer (or keep it disabled).
7. Choose to enable the Custom JS/CSS (or keep it disabled).
8. Select Brightspace from the LMS dropdown.
9. Enter your LMS Hostname.
   • The hostname must start with http:// or https://, without a path or trailing slash. For example: https://school.brightspace.com
10. Select Single-Course Setup for the Tool Type.
11. Click Save.

12. Click on the Configuration tab. Record/copy the following values that will be used in Brightspace:
    • Domain
    • Redirect URLs
    • OpenID Connect Login URL
    • Target Link URI
    • KeysetURL

Use an existing Version 1.3 Single-Course tool

1. Go to the LibApps Dashboard.
   • Log in using your LibApps login URL, or
   • Log into any of your Springshare products, click the blue menu on the left, and choose LibApps.
2. Go to Admin > LTI Tool Builder.
   • LibApps Admins can access this area. If you are on the LibApps dashboard and do not see an Admin menu, you are not a LibApps Admin.
3. Click the View/Edit Tool () icon for the Version 1.3 Single-Course tool for Brightspace.

4. Click on the Configuration tab. Record/copy the following values that will be used in Brightspace:
   • Domain
   • Redirect URLs
   • OpenID Connect Login URL
   • Target Link URI
   • KeysetURL

Register the Tool in Brightspace

After creating the LTI tool in LibApps, the first step to make within Brightspace is to register the tool.

Note: If an LTI tool has already been registered in Brightspace, you should not create another tool. Instead, you should edit the existing tool within Brightspace and add the Redirect URLs value for the new LibApps LTI tools to the first registered tool's Redirect URLs field (clicking the + Add Redirect URL link to add the new value). 

1. Go to Admin Tools (the cog icon in the top right corner) and select Manage Extensibility from the menu.
2. From the LTI Advantage tab, click on the Register Tool button.

3. Select a Standard registration.
4. Give your tool a Name to be used in Brightspace.
5. Enter the Domain value for the tool using the Domain from LibApps.
6. Enter the Redirect URLs value for the tool using the Redirect URLs from LibApps.
   1. If attempting to add a second (or third) LibApps LTI tool to D2L/Brightspace, click +Add Redirect URL link and enter the additional LTI tool's Redirect URLs value. 
7. Enter the OpenID Connect Login URL value for the tool using the OpenID Connect Login URL from LibApps.
8. Enter the Target Link URI value for the tool using the Target Link URI from LibApps.
9. Enter the Keyset URL value for the tool using the Keyset URL from LibApps.
10. Leave the remaining fields untouched and click the Register button to complete the registration for the tool.

Create a deployment and its link

Upon registering the LTI tool, your next step is to create a Deployment for the registered tool, define which Org Units can use it, and create a link for the deployment.

1. Return to the LTI Advantage tab (from Admin Tools > Manage Extensibility from the menu), and click on your newly created tool from the list of available tools.

2. Scroll to the bottom of the page and click on the tool's View Deployments link.

3. Click on the New Deployment button.

4. Select your newly created Tool from the dropdown list.
5. Give the deployment a Name.
6. In the Security Settings section select the following checkboxes.
   • Org Unit Information
   • Email
   • Link Information, Title, and Description
7. Add any Org Units that should have access to this deployment.
   • If adding a high-level org unit with sub-org units, be sure to indicate that all sub-units should also have access to this deployment.
8. Click the Create Deployment button.

9. After creating the deployment, you will be returned to the Deployments page for your tool. From here find your newly created deployment and click its link.

10. Scroll to the bottom of the page and click on the deployment's View Links link.

11. Click the New Link button.

12. Give the link a distinctive Name.
13. Enter the URL value for the tool using the Target Link URI value from LibApps.
14. Click the Save and Close button.

Find and add the LTI tool to a module

Using the link that was created for our deployment, the final step is to add and configure the link (to choose the content to display) in a course.

Add it to the Content Area

1. In a module in the Content area, click the Existing Activities dropdown and select External Learning Tools.

2. From the Add Activity modal, select your single-course tool.

3. Click the down arrow next to the tool's name and select Edit Properties In-place.

4. Rename the tool and customize the description as needed.
   • Consider using the name of the content you'll select, or something like "Research Guide", etc.
5. Check off Open as External Resource. (Must be checked in order to view content.)
6. Click the down arrow again > View Topic.

7. Select the content you'd like to display when students click the link.
   • See our FAQ on displaying content with a Single-Course tool for more information on what content is available.