Documentation:Basic LTI on Blackboard Learn 9

From UBC Wiki

There are two ways to integrate Basic LTI- (BLTI) enabled tools into Blackboard Learn 9 (aka Connect).

Build-in Basic LTI Support

BLTI is partially supported (not extension support) by Blackboard Learn 9 out of box. The built-in BLTI implements the standard BLTI function - Single Sign On (SSO). It provides students and instructors a way to integrate external tools with the standard protocol.

Installation

No installation is needed for the built-in BLTI

Setup

As Administrator

  • Click on the "System Admin" tab
  • Click on "Building Blocks" under the "Building Blocks" section
  • Click on "Basic LTI Tool Providers"
  • Click on "Manage Global Properties" and change the global settings as needed and save
  • Click on "Register Provider Domain" to add a new tool
    • Fill in the form
    • The "Tool Provider Key" and "Secret" have to match the ones set up in the external tool
    • Click "Submit" to save

As Instructor

  • Go to any course where you wish to set up a link to an external tool
  • Click on "Content" on left hand side menu
  • Hover on "Build Content" and select "Create Web Link" to add the link
    • Fill in the form
    • Make sure the checkbox for "This link is to a Tool Provider" is checked
    • URL: This has to match the URL that administrator has set up in the system. Otherwise, an additional information box will show and ask for the key/secret pair. If you know them, you can set it up. If not, please consult with your administrator
    • Click "Submit" to save

Once you get back to the "Content" page, there will a new link. Click on the link and it will issue a BLTI launch request to the external tool. If everything is setup properly, you should be able to automatically login to the external tool as expected.

Basic LTI Building Block

There is a BLTI implementation as a building block for Blackboard Learn 9 by Stephen Vickers on OSCELOT (http://projects.oscelot.org/gf/project/bb-basiclti/news/?action=NewsThreadView&id=264). It implements the Single Sign-On as well as extension services, such as membership, outcomes, and settings.

Installation

To install the Basic LTI building block, you need system administrator access on Blackboard Learn server. Download the file from: http://projects.oscelot.org/gf/project/bb-basiclti/frs/

  • Note: You may need to unpack the package and repack it as Blackboard may have some trouble accepting the original package from OSCELOT.
unzip bb-basiclti-1.2.3.zip
cd bb-basiclti-1.2.3
jar -cf ../bb-basiclti-1.2.3.war .

Setup

As Administrator

As an administrator, you will need to set up the building block for instructors to use:

  • Enable the building block: Change the Availability from Unavailable to Available and enable the course/org default as well.
  • Configuring the building block settings: Click on the "Settings" button for the building block on the same page.
    • Click on "Edit System Settings" to set up global settings.
    • Follow the step to set up global settings. If you only need SSO, you can disable extension services.
    • Click "Submit" to save.
  • Add a new tool: Click on the "Add a new tool" button to add an external tool (tool provider) you wish to connect to.
    • Follow the instructions and fill in all the required fields.
    • Tool GUID and Tool Secret: these are also known as the tool provider key/secret pair. The tool provider will use Tool GUID/secret pair to identify the LTI consumer.

As Instructor

Once the administrator has set up the building block, you can use the building block in your course.

  • Enter any course in which you want to use the building block
  • Select "Course Tools" under "Course Management"
  • Select "Basic LTI Tools"
  • You should be able to see a list of Basic LTI tools that the administrator has set up
  • Click on the chevron to the right-hand side of the tool you want to configure to bring up its Action Menu
  • Change the configuration as needed

The Link for students to access the tool:

  • Select "Tools" in the left menu
  • Click on "Basic LTI tools"
  • You should be able to see one or more buttons for the tools you or the administrator have configured available here.
Retrieved from "https://wiki.ubc.ca/index.php?title=Documentation:Basic_LTI_on_Blackboard_Learn_9&oldid=413369"