Canvas LMS Integration

Integrate Qriib Virtual Classrooms seamlessly into your Canvas LMS using the LTI 1.3 Advantage protocol. This integration enables single sign-on (SSO) for instructors and students, automatic roster synchronization (NRPS), and the ability to start and manage live lectures directly inside a Canvas course.

Key Capabilities

Step 1: Get the Integration URLs from the Qriib DevKit Portal

Log in to the Qriib DevKit Portal and copy the following URLs, generated dynamically for your environment:

Step 2: Create a Developer Key in Canvas

1. Log in to Canvas with an Admin account.
2. Go to Admin and select your root account (e.g. Canvas LMS Dev).
3. Click Developer Keys, then click the + Developer Key button and choose + LTI Key.
4. Fill in the configuration form with the following values:
   • Method: select Manual Entry.
   • Key Name: Qriib Virtual Classrooms
   • Owner Email: (your email address)
   • Redirect URIs: the Target Link URI (Launch URL) from Step 1
   • Title: Qriib Virtual Classrooms
   • Target Link URI: the Target Link URI (Launch URL) from Step 1
   • OpenID Connect Initiation Url: the OIDC Initiation URL from Step 1
   • JWK Method: select Public JWK URL.
   • Public JWK URL: the Public Keyset URL (JWKS) from Step 1
5. Click Save to store the key.
6. In the keys table, toggle the key's State to ON to enable it.
7. Copy the Client ID shown in the Details column.

Optional: Set Your Institution's Workspace Logo

In a Qriib environment with client-logo support deployed on both the backend and frontend, an authorized Canvas administrator can pass a logo through the existing LTI 1.3 Developer Key configuration.

Using your account's supported JSON configuration workflow, merge this fragment into the existing tool-level configuration, preserving all other custom fields, security settings, and placements. This is not a complete registration configuration:

{
  "custom_fields": {
    "logo_url": "https://your-university.edu/assets/logo.png"
  }
}

Save the configuration, then close the existing workspace and launch the course activity again. Refreshing an existing session does not update its logo. Canvas also supports placement-specific custom_fields; check the launched placement for an overriding value if the wrong logo appears.

Use a direct, public HTTPS image URL that loads without login, not a webpage containing the image. For example, a Wikipedia file-description page is HTML; use its Original file URL instead. Avoid temporary access tokens. Canvas's separate icon_url controls the icon shown by Canvas and is not automatically imported as the Qriib workspace logo.

Missing, invalid, or unloadable logos fall back to a neutral school icon without blocking workspace access. The image host receives browser requests and network metadata; Qriib sends no workspace referrer or LTI authorization header. For diagnostic steps, see Troubleshooting the Logo.

The custom_fields configuration is described in the official Canvas LTI configuration documentation. Administrator UI labels vary; this logo setup has not yet been verified against a live Canvas tenant.

Step 3: Install and Enable the App in Canvas

1. Go to the course you want to enable the tool for (e.g. the math course).
2. Go to Settings > the Apps tab, then click View App Configurations and + App.
3. Set Configuration Type to By Client ID.
4. Enter your Client ID (e.g. 10000000000001), then click Submit and Install.
5. Unlock the app (one-time step):
   • Go to Admin > Apps > the Manage tab.
   • Find the app, open its details, and click Unlock app until its status shows App is unlocked (blue lock icon).
   • Copy the Deployment ID shown there.

Step 4: Register the Canvas Credentials in the Qriib Portal

Go back to the Qriib DevKit Portal and register the new LMS using the following mapping:

Click Register LMS Integration to complete the setup.

Step 5: Add Virtual Classrooms to a Course (Instructor Workflow)

Instructors can now add a virtual classroom to any course:

1. Go to an active course (e.g. the math course).
2. Click Modules in the course sidebar.
3. Click + Module to create a new module named Live Classes.

4. Click the + icon next to the module name to add a new item.
5. In the dropdown list, select External Tool.

6. Select Qriib Virtual Classrooms from the list, then click Add Item.
7. Clicking the new link opens the virtual classroom workspace, and the lecture can begin.