LTI 1.3 for Canvas

Introduction

Canvas supports Dynamic Registration for LTI Advantage tools — a streamlined, one-step way to register an external tool. Praxis AI uses it to offer a simplified onboarding experience for the Pria LTI tool. The result is two roles, two simple tasks:

Administrators register Pria as an LTI tool in a single guided flow, and
Faculty place Pria in their courses and connect each course to a Digital Twin.

An administrator only needs to register Pria once per Canvas instance. After that, faculty can add Pria to any course.

This page covers both registration methods, then how faculty place and configure Pria in a course.

Method	Best for	Effort
Dynamic Registration (recommended)	Most institutions — fastest path, default placements	10–15 min
Manual Registration	Pinning a specific Digital Twin or fine-grained control of placements (e.g. `top_navigation`)	20–30 min

Prerequisites

Before you begin, ensure you have:

Canvas admin access for the account where Pria will be installed
Permission to register external LTI tools at your institution
A valid account at pria.praxislxp.com
Third-party cookies enabled in your browser (required for LTI launches)

Dynamic Registration

This is the recommended method for most institutions. Canvas walks you through a guided wizard and registers Pria with sensible defaults.

Open the Apps page

Log in to your Canvas instance, then go to Admin → (your account) → Apps and select the Manage tab. Click Install a New App in the top-right corner.

Canvas Apps Manage page with the Install a New App button — Admin → Apps → Manage → Install a New App

Choose Dynamic Registration

In the Install App dialog:

Under Select LTI Version, choose 1.3.
Set Install Method to Dynamic Registration.
In Dynamic Registration URL, enter:

https://pria.praxislxp.com/lti/register

Install App dialog with LTI 1.3, Dynamic Registration, and the Pria registration URL — Select LTI 1.3 and Dynamic Registration, then enter the registration URL

Click Next to begin the LTI Advantage registration.

Review permissions

Pria requests the gradebook and roster permissions it needs to operate. The recommended defaults are pre-selected.

Permissions step listing the actions Pria can perform — Pria's requested permissions, with recommended defaults pre-selected

Leave the defaults and click Next.

Altering these defaults can affect Pria’s behavior. Only change them if you have a specific reason.

Confirm data sharing

Choose what user data is shared with Pria. The default, All user data, includes Canvas ID, name, SIS ID, avatar, and email address.

Data Sharing step with the user-data dropdown — Data Sharing step — All user data is the default

Leave the default and click Next.

Select placements

Placements control where Pria can be accessed from in Canvas. We recommend enabling:

Placement	Recommendation
Course Navigation	✅ Recommended — Pria appears in the course sidebar
Link Selection	✅ Recommended — lets faculty embed Pria in modules
Account Navigation	Optional
Top Navigation	Optional — opens Pria in a drawer
Page Menu	Optional

Placements step with selectable checkboxes — Choose where Pria may be accessed from

Adjust the selection to suit your institution and click Next.

Set the nickname

Give the tool an Administration Nickname (the label shown next to the app’s name in Canvas) and an optional description. You can also rename each placement.

Nickname step with the Administration Nickname and Description fields — Nickname and description for the Pria tool

This is the administrative label. When faculty place Pria in a course, they can give that placement its own name, independent of the nickname you set here.

Click Next.

Set icons (optional)

Optionally set a Tool Icon URL and per-placement icons. The defaults point to Pria’s logo.

Icons step with the Tool Icon URL field — Tool icon and per-placement icon URLs

Click Next.

Review and install

Review your permissions, data sharing, and placements. Use the pencil icons to jump back and edit any section.

Review step with editable sections — Review step summarizing the registration

Click Install App to finish registration.

Make Pria available

Pria installs as Not Available — it won’t appear to faculty until you enable it. On the app’s Availability and Exceptions tab, click the pencil (edit) icon next to Installed in (your account).

App detail card showing the Not Available status and Add Exception button — The installed app, still marked Not Available

In the Edit Exception dialog, change the status from Not Available to Available, then click Save. This makes Pria available across your child sub-accounts and courses.

Edit Exception dialog changing availability to Available — Change Not Available → Available, then Save

Use Add Exception if you’d rather enable Pria for specific sub-accounts or courses instead of the whole account.

Confirm installation

The app now shows Available, along with its Deployment ID and active placements. Pria is registered and ready for faculty to use.

App card showing Available status, Deployment ID, and placements — Pria installed and available

Manual Registration

Canvas does not allow adding placements or editing custom properties after a tool is installed through Dynamic Registration. Use Manual Registration when you need that control up front.

Choose manual registration when you want to:

Pin a specific Digital Twin by setting a priainstitutionid, or
Control placements precisely — for example, to use the top_navigation placement, which opens Pria in a drawer similar to a wiki page.

Create the developer key

Open Developer Keys

Add an LTI key

Click + Developer Key and select + LTI Key.

Configure the key

Fill in the key settings:

Key Name: Pria LTI
Owner Email: your admin email

Redirect URIs:

https://pria.praxislxp.com/lti
https://pria.praxislxp.com/lti/resources
https://pria.praxislxp.com/lti/launch

In the Method dropdown, select Paste JSON, then paste the configuration below into the LTI 1.3 Configuration field. The scopes in it are what you are granting Pria: the lti-ags entries let it read and write gradebook entries and scores, contextmembership.readonly lets it read the course roster, and the three canvas.instructure.com entries let Canvas and Pria keep the signing key, account lookup and grade-progress checks in sync.

{
  "title": "Pria LTI",
  "scopes": [
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem",
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/score",
    "https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly",
    "https://canvas.instructure.com/lti/public_jwk/scope/update",
    "https://canvas.instructure.com/lti/account_lookup/scope/show",
    "https://canvas.instructure.com/lti-ags/progress/scope/show"
  ],
  "extensions": [
    {
      "domain": "praxislxp.com",
      "platform": "canvas.instructure.com",
      "settings": {
        "text": "Pria LTI",
        "icon_url": "https://pria.praxislxp.com/logo192.png",
        "platform": "canvas.instructure.com",
        "placements": [
          {
            "text": "Pria LTI",
            "icon_url": "https://pria.praxislxp.com/logo192.png",
            "placement": "account_navigation",
            "message_type": "LtiResourceLinkRequest",
            "target_link_uri": "https://pria.praxislxp.com"
          },
          {
            "text": "Manual Pria LTI",
            "icon_url": "https://pria.praxislxp.com/logo192.png",
            "placement": "link_selection",
            "message_type": "LtiDeepLinkingRequest",
            "target_link_uri": "https://pria.praxislxp.com/lti"
          },
          {
            "text": "Manual Pria LTI",
            "icon_url": "https://pria.praxislxp.com/logo192.png",
            "placement": "wiki_page_menu",
            "message_type": "LtiResourceLinkRequest",
            "target_link_uri": "https://pria.praxislxp.com/lti"
          },
          {
            "text": "Manual Pria LTI",
            "icon_url": "https://pria.praxislxp.com/logo192.png",
            "placement": "top_navigation",
            "message_type": "LtiResourceLinkRequest",
            "target_link_uri": "https://pria.praxislxp.com/lti/launch"
          }
        ]
      },
      "privacy_level": "public"
    }
  ],
  "description": "Praxis-AI, Pria LTI",
  "custom_fields": {
    "priainstitutionid": "f831501f-b645-481a-9cbb-331509aa....",
    "userid": "$Canvas.user.id",
    "courseid": "$Canvas.course.id",
    "coursename": "$Canvas.course.name",
    "partnerid": "$Canvas.account.id",
    "partnername": "$Canvas.account.name",
    "accountglobalid": "$Canvas.root_account.global_id"
  },
  "public_jwk_url": "https://pria.praxislxp.com/lti/keys",
  "target_link_uri": "https://pria.praxislxp.com/lti",
  "oidc_initiation_url": "https://pria.praxislxp.com/lti/login"
}

Set priainstitutionid to the Digital Twin’s Public ID to always open that twin (institution is the API’s word for a Digital Twin). To let faculty connect a Digital Twin during onboarding instead, delete the priainstitutionid line.

Save and copy the Client ID

Toggle back to Manual Entry to confirm the placements — you’ll now see top_navigation listed. Save the key, then copy its Client ID (for example, 243790000000000223). You’ll need it in the next section.

A complete walkthrough of the manual setup is also available in this Google Doc.

Install the app from the Client ID

Open the Apps page

Go to Admin → (your account) → Settings → Apps, then click + App.

Add by Client ID

In the Add App dialog, set Configuration Type to By Client ID, paste the Client ID you copied above, and click Submit. Canvas finds the matching LTI app — click Install to confirm.

If you reinstall Pria, Canvas shows a confirmation dialog. Click Install to add the new installation — it supports the Digital Twin onboarding workflow and is independent of any previous install.

Your Pria LTI application is now installed. It can take a few minutes for Canvas to make it available as a placement.

Place Pria in your course

This section is for faculty, and assumes an administrator has already registered Pria using one of the methods above. From your Dashboard, open the course where you want to add Pria.

Add an item to a module

Inside a module, click the + button to add an item. In the Add Item to Module dialog, set the dropdown to External Tool, then select Pria from the list of tools.

Add Item to Module dialog with External Tool selected — Add an External Tool item and choose Pria

Embed Pria

Pria opens its Link Resource from External Tool card. Click Embed in your course to create the link.

Link Resource from External Tool card with Embed in your course button — The Pria embed card

Name and add the item

Back in the Add Item to Module dialog, give the placement a page name (for example, Professor Cantu), then click Add Item.

Add Item dialog with the page name and Add Item button — Name the placement and add it to the module

Pria now appears in your module. Click it to launch. Pria opens inline unless your placement is configured to launch in a separate window.

Connect a Digital Twin

The first time an admin or instructor launches Pria in a course, it shows Let’s get you connected. If your account is already associated with one or more Digital Twins, you can connect an existing twin or create a new one.

Let's get you connected screen listing existing Digital Twins and a + Digital Twin button — Connect an existing Digital Twin or create a new one

Use an existing twin

Select any Digital Twin from the list to connect it to this course. Every Pria placement in the course then opens that twin.

A course connects to one Digital Twin. A course that another active twin already uses is refused with “This course is already connected to another Digital Twin”. To switch twins later, a teacher or administrator of the twin unlinks the course from Your Profile › Canvas / LTI (see Faculty Onboarding), or a Digital Twin admin removes it from the twin’s LTI Contexts list; the next launch shows this screen again.

Create a new twin

Click + Digital Twin to create a new, personalized Digital Twin. In the New Digital Twin dialog, enter:

A name for your twin (for example, Bob)
A picture URL that is publicly accessible on the internet (no CORS restrictions)

New Digital Twin dialog with name and picture URL fields — Create a new Digital Twin

Click Let’s GO! to finish. Pria then shows Confirm it’s you: select Send me a code and type the code emailed to you — this makes you the new twin’s administrator — and you land in your new Digital Twin.

Anytime you or your students open Pria in this course, they’ll open this Digital Twin directly. When you place Pria in another course, the onboarding wizard again offers to reuse an existing twin or create a new one.

Hide Pria in a course

The connection screen also has a Hide Pria in this course card: students no longer see Pria in the course, and teachers can select Show Pria in this course to bring it back.

If the course’s Digital Twin is disabled

Students see “Pria is not available in this course right now. Ask your teacher.” Teachers see This course’s Digital Twin is disabled with two buttons:

Disconnect this Digital Twin from the course — then reload and connect the course to another twin.
Hide Pria in this course.

When the twin is blocked because its whole account is disabled, only Hide Pria in this course is offered; ask the Praxis AI team at humans@praxis-ai.com.

Personalize your twin

Open the Personalization and AI Models tab to customize your Digital Twin’s behavior, system prompt, and available models. Click Update to save your changes. For the full reference, see the Personalization documentation.

Student access

Students are automatically added to your Digital Twin once you’ve placed Pria in the course, launched it, and completed the connection wizard for the first time. If a student opens Pria before a twin has been connected, a message asks them to have a teacher or administrator set it up. Admin accounts may first see Confirm it’s you and enter a one-time code; students are not asked. See More security for LMS login.

LTI launches require third-party cookies. In Incognito/Private mode, or when cookies are blocked, the launch may fail with a cookie-related error. Allow third-party cookies (or add an exception for pria.praxislxp.com) and retry.

Troubleshooting

Issue	Solution
”Invalid redirect” during launch	Verify the Redirect URIs are registered exactly as shown. Check for trailing slashes or typos.
Pria doesn’t appear in a course	Confirm the app’s availability is set to Available (Dynamic Registration) or the Developer Key is ON (Manual). Verify the tool was installed at the correct account level.
”Unregistered” or “Unknown Client” errors	Confirm the Client ID in Canvas matches the registered tool, and that the registration URL is correct.
Third-party cookie errors	LTI requires cookies. Allow third-party cookies (or add an exception for `pria.praxislxp.com`) and avoid Incognito/Private mode.
Students can’t access but faculty can	Ensure a Digital Twin has been connected to the course and is not disabled, Pria is not hidden in the course, the item is published, and availability isn’t restricted by an exception.
Deep linking (adding Pria from the module editor) not creating content	Verify the Link Selection placement is enabled and the course allows external-tool content in modules.
Custom parameters not passing	For manual registration, ensure custom fields are set in the Developer Key JSON, not only on the External Tool config.

Test launches in a normal browser window first. If it works there but fails in Incognito, the issue is cookie-related.

Overview

Getting Started

LMS Integrations

Voice & Avatars

Web & Chat Integrations

MCP Server

JavaScript SDK

Authentication

REST API

Runtime API

Administrator API

LTI 1.3 for Canvas

Introduction

Prerequisites

Dynamic Registration

Manual Registration

Create the developer key

Install the app from the Client ID

Place Pria in your course

Connect a Digital Twin

Use an existing twin

Create a new twin

Hide Pria in a course

If the course’s Digital Twin is disabled

Personalize your twin

Student access

Troubleshooting

What’s next?

Enable Canvas Tools

Configure Your Digital Twin

​Introduction

​Prerequisites

​Dynamic Registration

​Manual Registration

​Create the developer key

​Install the app from the Client ID

​Place Pria in your course

​Connect a Digital Twin

​Use an existing twin

​Create a new twin

​Hide Pria in a course

​If the course’s Digital Twin is disabled

​Personalize your twin

​Student access

​Troubleshooting

​What’s next?

Enable Canvas Tools

Configure Your Digital Twin

Introduction

Prerequisites

Dynamic Registration

Manual Registration

Create the developer key

Install the app from the Client ID

Place Pria in your course

Connect a Digital Twin

Use an existing twin

Create a new twin

Hide Pria in a course

If the course’s Digital Twin is disabled

Personalize your twin

Student access

Troubleshooting

What’s next?