Skip to main content

Canvas

Unlike other LMSes, Canvas does not support dynamic registration. It does however support a semi-automated registration using JSON. This guide explains how to register an LTIAAS tool into Canvas with the Automatic JSON method and manually.

Automatic JSON registration

Summary

caution

Canvas automatic JSON registration is only available for customers that purchase the dynamic registration feature.

To set up LTIAAS with Canvas JSON you need to:

  1. Add a developer LTI Key in Canvas
  2. Install the LTIAAS tool into Canvas
  3. Register the Canvas provided details into LTIAAS
  4. Do a test launch

Step 1. Add a developer key in Canvas

  1. Login to your Canvas LMS as an administrator.
  2. Navigate to 'Admin' -> [your account name] -> 'Developer Keys'
  3. Click the '+ Developer Key' button followed by the '+ LTI Key' dropdown
    Canvas add LTI key button inside admin menu
  4. In the resulting form, enter the following information:
    • Key name: Your Tool Name
    • Method: Enter URL
    • Redirection URI(s): https://your.ltiaas.com/lti/launch
    • JSON URL: https://your.ltiaas.com/register/canvas
  5. Click the 'Save' button at the bottom when the form is filled.
    Canvas save key settings
  6. After saving, find the newly registered tool's key on the list of keys and make sure the State is switched to 'ON'
  7. Note the number in the details column. It will be used as the Client ID in the next steps
    Canvas developer keys table with client ID highlighted

Step 2. Install the LTIAAS tool into Canvas

  1. In the Canvas Admin menu, navigate to 'Settings' -> 'Apps'
  2. Click the '+ App' button
    Canvas add a new app
  3. In the resulting form choose:
    • Configuration Type: By Client ID
    • Client ID: [The Client ID number you found in the previous series of steps]
  4. Click the 'Submit' button
    Canvas submit add app form
  5. In the resulting dialog, click 'Install'
    Canvas install app button
  6. The tool will now show up in the 'External Apps' table.

Step 3. Register the Canvas provided details into LTIAAS

A registration can be done within the LTIAAS Portal. Start by logging in to your account and navigating to the Registrations page. Then click on the + Add Registration button.

LTIAAS Portal registrations page with add registration button highlighted

Enter the information that the LMS provides for its LTI endpoints using the table below as a guide.

LTIAAS Registration API NameCanvas Provided Name (Instructure Cloud)Canvas Provided Name (Self Hosted)
nameAny name you would like that helps you identify your LMS
Client IDThe client ID found in the first sequence of steps
URLhttps://canvas.instructure.comhttps://[YOUR_CANVAS_URL]
Authentication MethodJWK_SET
Authentication Keyhttps://[YOUR_CANVAS_URL]/api/lti/security/jwks
Access Token Endpointhttps://[YOUR_CANVAS_URL]/login/oauth2/token
Authentication Endpointhttps://[YOUR_CANVAS_URL]/api/lti/authorize_redirect
info

Replace [YOUR_CANVAS_URL] with the base URL of your canvas instance. For example: canvas.my-university.edu or canvas.instructure.com. More information about the Canvas LTI 1.3 endpoints can be found on Instructure's website.

caution

If a registration is not working, one of the likely causes is an incorrect URL. Please try both https://canvas.instructure.com and https://[YOUR_CANVAS_URL].

Click submit when you have made the necessary changes. Also, you can edit these values at any time.

LTIAAS Portal tool registration form

Step 4. (Optional) Edit the registration

If at any time you want to edit or delete a registration, simply click on the blue pencil icon on the leftmost column of the table for the registration item you want to change.

By default, all new registrations are activated upon creation. There may be an instance where a platform was registered, but you don't want the registration to be active. You can activate/deactivate a registration by clicking on the true/false button on the Active column of the table.

LTIAAS Portal registration page with new registration added

Step 5. Do a test launch

tip

You may need to add placements for the newly installed tool before adding it to certain places within the LMS.

  1. Follow the instructions on the Canvas website to add an external tool assignment to a course: How do I add an assignment using an external app?
  2. When choosing an external tool, choose the newly registered tool from step 1.

Manual Registration

Summary

To set up LTIAAS with Canvas using Manual Registration, you need to:

  1. Add a developer LTI key in Canvas
  2. Install the LTIAAS tool into Canvas
  3. Register the Canvas provided details into LTIAAS
  4. Do a test launch

Step 1. Add a developer key in Canvas

  1. Login to your Canvas LMS as an administrator.

  2. Navigate to 'Admin' -> [your account name] -> 'Developer Keys'

  3. Click the '+ Developer Key' button followed by the '+ LTI Key' dropdown

    Canvas add LTI key button inside admin menu
  4. In the resulting form, enter the following information:

    • Key name: Your Tool Name
    • Method: Manual Entry
    • Redirection URI(s): https://your.ltiaas.com/lti/launch
    • Title: Your Title
    • Description: Your Tool Description
    • Target Link URI: https://your.ltiaas.com/lti/launch
    • OpenID Connect Initiation Url: https://your.ltiaas.com/lti/login
    • JWK Method: Public JWK URL
    • Public JWK URL: https://your.ltiaas.com/lti/keys
    Canvas configure manual tool form
  5. Further down in the form, select the services your tool needs. The screenshot below shows an example of a tool that uses assignments, grades, and the launch context (i.e. the course ID).

    Canvas enable/disable LTI services
  6. Toward the bottom of the form, add placements for your tool. These are the locations in the LMS where your tool can be added. If you are using Deep Linking, select LtiDeepLinkingRequest. Otherwise, select LtiResourceLinkRequest for a basic LTI launch.

    Canvas add placements form with message type selection
  7. Click the 'Save' button at the bottom when the form is filled.

  8. After saving, find the newly registered tool's key on the list of keys and make sure the State is switched to 'ON'.

  9. Note the number in the details column. It will be used as the Client ID in the next steps.

    Canvas developer keys table with client ID highlighted

Step 2. Install the LTIAAS tool into Canvas

  1. In the Canvas Admin menu, navigate to 'Settings' -> 'Apps'
  2. Click the '+ App' button
    Canvas add a new app
  3. In the resulting form choose:
    • Configuration Type: By Client ID
    • Client ID: [The Client ID number you found in the previous series of steps]
  4. Click the 'Submit' button
    Canvas submit add app form
  5. In the resulting dialog, click 'Install'
    Canvas install app button
  6. The tool will now show up in the 'External Apps' table.

Step 3. Register the Canvas provided details into LTIAAS

A registration can be done within the LTIAAS Portal. Start by logging in to your account and navigating to the Registrations page. Then click on the + Add Registration button.

LTIAAS Portal registrations page with add registration button highlighted

Enter the information that the LMS provides for its LTI endpoints using the table below as a guide.

LTIAAS Registration API NameCanvas Provided Name (Instructure Cloud)Canvas Provided Name (Self Hosted)
nameAny name you would like that helps you identify your LMS
Client IDThe client ID found in the first sequence of steps
URLhttps://canvas.instructure.comhttps://[YOUR_CANVAS_URL]
Authentication MethodJWK_SET
Authentication Keyhttps://[YOUR_CANVAS_URL]/api/lti/security/jwks
Access Token Endpointhttps://[YOUR_CANVAS_URL]/login/oauth2/token
Authentication Endpointhttps://[YOUR_CANVAS_URL]/api/lti/authorize_redirect
info

Replace [YOUR_CANVAS_URL] with the base URL of your canvas instance. For example: canvas.my-university.edu or canvas.instructure.com. More information about the Canvas LTI 1.3 endpoints can be found on Instructure's website.

caution

If a registration is not working, one of the likely causes is an incorrect URL. Please try both https://canvas.instructure.com and https://[YOUR_CANVAS_URL].

Click submit when you have made the necessary changes. Also, you can edit these values at any time.

LTIAAS Portal tool registration form

Step 4. (Optional) Edit the registration

If at any time you want to edit or delete a registration, simply click on the blue pencil icon on the leftmost column of the table for the registration item you want to change.

By default, all new registrations are activated upon creation. There may be an instance where a platform was registered, but you don't want the registration to be active. You can activate/deactivate a registration by clicking on the true/false button on the Active column of the table.

LTIAAS Portal registration page with new registration added

Step 5. Do a test launch

tip

You may need to add placements for the newly installed tool before adding it to certain places within the LMS.

  1. Follow the instructions on the Canvas website to add an external tool assignment to a course: How do I add an assignment using an external app?
  2. When choosing an external tool, choose the newly registered tool from step 1.

Next steps

Now that you have your LTI tool set up in an LMS, you can start receiving LTI launches. Please see the Receiving your first LTI launch guide for more information.

All trademarks, logos, and service marks displayed on this website are the property of their respective owners. LTIAAS is a trademark of GatherAct, LLC, doing business as LTIAAS. Learning Tools Interoperability (LTI)® is a trademark of 1EdTech Consortium, Inc. LTIAAS is not affiliated with, endorsed or sponsored by 1EdTech Consortium, Inc. or by any other owners of third-party trademarks used on this website. LTIAAS is not responsible for the content, quality, or accuracy of any websites linked to or from this website that are not owned by LTIAAS. If you have any questions or concerns about the use of any trademarks or content on this website, please contact us.