This LTI® v1.3 Reference Implementation Test Tool is provided by IMS Global Learning Consortium. Limited functionality is provided free of charge. IMS Members have access to the complete functionality of the tool including services and message types. Join now to experience full functionality of the tool, technical support and certification. If you are an existing member login here for full access.

Instructions

We will open various configuration pages in new tabs as part of these instructions. These instructions will guide you through setting up a Tool and Platform, culminating in a launch from RI Platform to RI Tool.

If you wish to setup only a Tool or Platform for use with your software, it is still recommended to set up both in RI and verify setup is good. Once verified, you can replace the Tool or Platform in the RI with your own.

  1. Open Generate Keys in a new tab

    • Keep this page open while configuring both the Tool and Platform because you will need to copy/paste both the public + private key.
    • Note: These will only show one time. If you refresh the page, it will generate a new public + private key.

  2. Open Manage Platforms in a new tab

    • Click Add Platform.
    • Add a unique name for your Platform.
    • Provide a OAuth2 client id. (ex: 12345)
    • Add a audience (ex: https://lti-ri.imsglobal.org)
    • Copy Public key from Generate Keys tab and paste into Platform Public Key field
    • Copy Private key from Generate Keys tab and paste into Platform Private Key field
    • Refresh Generate Keys tab to generate a new set
    • Copy Public key from Generate Keys tab and paste into Tool Public Key field
    • Click Save

  3. Add Platform Key

    • Click Platform Keys then Add Platform Key.
    • Create a name for your Platform Key (ex: Key 1)
    • Add Deployment ID (ex: 1, you may set up multiple later)

  4. Open Manage Tools in a new tab

    • Click Add Tool.
    • Add a unique name for your Tool.
    • Add OAuth2 client id, same value as Platform above (ex: 12345)
    • Copy Private key from Generate Keys tab and paste into Private key field
    • Add Deployment, same value as Platform Key above (ex: 1)

    • In Platform tab, navigate to your platform
    • Click View Platform
    • Click Platform Keys
    • Copy well-known/jwks URL endpoint
    • Paste into Tool's Keyset url field

    • In Platform tab, navigate to your platform
    • Copy OAuth2 Access Token URL value
    • Paste into Tool's Oauth2 url
    • Copy OIDC Auth URL from Platform Page
    • Paste into Tool's Platform oidc auth url
    • Click Save
    • Click back link so you are viewing tool

  5. In Platform tab, view your Platform

    • Click Courses
    • Click Add Course
    • Populate fields
    • Save course

    • Navigate and view your Platform
    • Click Resource Links
    • Populate fields
    • For Tool link url, copy Tool end-point to receive Deep Link launches url from your tool
    • For Login initiation url, copy Tool Login initiation url endpoint from your tool
    • Save resource link

    • Navigate and view your Platform
    • Click Courses
    • Click View Line Items
    • Click Add Line Items
    • Populate fields

    • Navigate and view your Platform
    • Edit Platform
    • For Tool Deep Link Service Endpoint, copy Tool end-point to receive Deep Link launches endpoint from your tool

    • Navigate and view your Platform
    • Click Resource Links
    • Click Select User for Launch
    • Click Launch with New User
    • Scroll to bottom and click Perform Launch
    • If configuration is setup correctly, you should see Successful Launch at top of page

    • You should now be comfortable with Tool and Platform setup, and can replace one or the other with your Tool or Platfrom