LTI Integration

Phase 1 (All LMS platforms)

Generate a shared/secret key pair for use with Canvas:

  1. Browse to the Runestone Academy and log in, then select your course (you must be the Instructor).

  2. Browse to the Instructor’s Page, then click on “LTI Integration” in the Admin tab.

  3. Click on the “Create LTI Key and Secret” button. Click the “Show Secret” button. You will use these in the next phase.

Phase 2 (LMS-specific Steps)

Follow instructions for your LMS:

Canvas

  1. Follow the Canvas instructions to add an external app:

    Name

    Runestone

    Consumer key

    Enter this from Phase 1.

    Shared Secret

    Enter this from Phase 1.

    Launch URL

    https://runestone.academy/runestone/lti

    Domain

    Leave blank.

    Privacy

    Select Public; otherwise, Runestone won’t work.

    Custom Fields

    Depends on the installation type:

    • For a site-wide installation, or for installing the Runestone external app for use across multiple courses, leave this blank.

    • If installing for a single course, add custom_course_id=xxx, where xxx is the Runestone ID of the course (visible in the upper lefthand corner of each page in your Runestone course).

    Description

    Interactive textbooks from Runestone Academy

  2. Add an assignment in Canvas that uses the Runestone external tool:

    1. At Runestone Academy, create an assignment; be sure you’ve checked the “Visible to Students” box and saved that change.

    2. Still on the assignments page, copy the LTI link.

    3. In Canvas, add an assignment. For the submission type, select “External Tool.” For the External Tool URL, use the LTI link you just copied. You’ll have to manually enter the same due date/time and a similar assignment name; these aren’t copied automatically. You must be sure the Load This Tool In A New Tab checkbox is checked.

  3. Students can now click on this assignment and work it. If they don’t click on the assignment, they won’t receive a grade.

  4. When the assignment is due, go to Runestone directly from your Canvas course by using an assignment link. Otherwise, grade reporting won’t work.

  5. In the grading tab of the instructor interface, grade the assignment, then click the “Release Grades” button. Doing this will push all grades to Canvas.

Moodle

  1. The following instructions are for Moodle, but should work for any LMS with LTI Support. Please note that certain items may have naming variations (ie. Moodle External Tool / Canvas External App).

  2. In Moodle, create a new external tool called “LTI Login Link”.

    Name

    Login to Runestone

    Tool URL

    https://yourHost.blahblah.edu/runestone/lti

    Consumer key

    Enter the key you copied for consumer from Phase 1

    Shared secret

    Enter the key you copied for secret from Phase 1

    Icon URL

    https://yourHost.blahblah.edu/runestone/static/images/logo_small.png

    Share Email

    True

    Share Name

    True

    Custom params

  3. Login to your Runestone instance with the tool just created, and create your class as well as your assignments.

  4. In Moodle, create a new enrollment external app directly to your course and assignment. You will need to repeat this for each assignment. You will also need the database values for your course ID, and assignment ID. Get these from step 2.2. Please note that in order to receive roles and grades, “Accept Grades” must be checked in Moodle. In other LMS’s this may be referenced by a “Share IMS Names and Roles” or similar.

    Name

    Assignment 1

    Tool URL

    https://runestone.colorado.edu/runestone/lti?assignment_id=<ID>&custom_course_id=<ID>

    Consumer key

    Enter the key you copied for consumer from Phase 1

    Shared secret

    Enter the key you copied for secret from Phase 1

    Icon URL

    https://yourHost.blahblah.edu/runestone/static/images/logo_small.png

    Share Email

    True

    Share Name

    True

    Custom params

    Accept Grades

    True

  5. Copy the tool as many times as you need within your Moodle Course, updating the Name and Tool URL each time.

  6. Students can now click on these external tool assignments to be enrolled/logged directly into your Runestone course and assignment. The grades should appear in Moodle once they are released in Runestone through the Instructor interface.

  7. The course instructor must also be an LTI sourced user, so use the “LTI Login Link” URL. This can be hidden for users.

Blackboard Learn Original or Ultra

System Message: WARNING/2 (/home/docs/checkouts/readthedocs.org/user_builds/runestoneserver/checkouts/v6.2.1/docs/lti.rst, line 84)

Title underline too short.

Blackboard Learn Original or Ultra
------

  1. Follow the LTI instructions on help.blackboard.com for other LTI tools. You can enable this integration by approving the domain in LTI tools, then creating placements (which puts menus under Build Content), or by using “Web Link” functionality in Original courses. In Ultra courses LTI links can be added per course. Blackboard information on LTI

  2. Start by approving the LTI domain in the Admin panel of Blackboard Learn:

    Admin setup

    Approve runestone.academy as a domain in Admin -> LTI Tool Providers -> Register LTI 1.1 Provider

    Course setup

    In a course go to Build Content -> Web Link

    Name

    Runestone

    Url

    https://runestone.academy/runestone/lti

    Check the box This link is to a Tool Provider

    True (if you cannot, review the Admin step above to approve the domain)

    LTI

    Once the checkbox is selected, you will see additional fields: key, secret, Custom Parameters, Enable Evaluation

    Key

    Enter this from Phase 1.

    Secret

    Enter this from Phase 1.

    Description

    Interactive textbooks from Runestone Academy

  3. Advanced setup

    • For a site-wide installation, or for installing the Runestone external app for use across multiple courses, leave this blank. You will enter key/secret in the Admin step above.