LMS: Canvas Integration Setup

1. Sign up for a Visible Body admin account if you do not already have one. Reach out to implementation@visiblebody.com to be provided a setup link.
2. In Visible Body Courseware, go to the LMS Integration page on the left-hand side. Open the Canvas 1.3 tab and copy the URL to paste later.

3. In Canvas, navigate to the administrator panel on the left hand navigation. Select your institution.

4. On the left hand menu, click Developer Keys.

5. On the Developer Keys page, click + Developer Key and select + LTI Registration in the dropdown that appears.

6. Paste the dynamic URL you copied from the LMS integration page in Courseware and click continue.

7. On the Register App popup you can review your placements, and (optionally) rename them.

   • Please keep the default permissions for Visible Body to work properly with your institution.

   • All placements can be enabled without issue; you can hide one or more later, depending on how you structure your Canvas courses.

8. When done in the Register App popup, click Enable & Close.

9. You will be returned to the Developer Keys page to finish the integration.

10. Find the Details column by Visible Body (LTI 1.3). Highlight and copy the Client ID number directly above the Show Key button.

11. While still in the admin panel, navigate to Settings in the left hand menu, and click the Apps tab. Then click View App Configurations on the top right.

12. On the External Apps page, click + App.

13. Under Configuration Type, choose By Client ID. Paste the Client ID into the field, and click Submit. Canvas will ask you to confirm. Click Install. If you’ve previously used Visible Body, Canvas may warn that you’ve already installed the tool. In that case, click Yes, Install Tool.

    1. If you’re migrating your 1.1 integration, you may be asked to confirm you want to install the tool again. Select Yes.

You are now ready to manage the placement of Visible Body (LTI 1.3)

We recommend adding our Course Home to your Canvas course left hand navigation. This allows Visible Body to be easily accessible in relevant courses.

1. Navigate to a course where you would like to add Visible Body (LTI 1.3). You must be logged in as an admin.
2. On the left hand menu, click Settings. On the top menu, click Navigation. Drag Visible Body (LTI 1.3) to appear where you want in the course navigation.
3. Click Save.
4. Visible Body (LTI 1.3) should now be in your course navbar. Click to access the Visible Body 1.3 Homepage.
5. You will be asked to confirm that you have set up this integration. Select Connect and check for a notice confirming that you have successfully connected your institution with Visible Body. There will be one more step before you are finished.
   1. If you do not see this prompt, try refreshing the page and clicking the Visible Body tool again.

You will need to link a course to complete this integration. If you don’t have one, you can choose a sample course or create a new course from the course linking page.

1. Select Manage Sync Options from the Course Home, or select the settings icon within the Assignment Library to link a course. Once any course has been linked, this integration is ready to go. Note, your instructors will link their own courses.
   1. You can verify your connection by going into the Courseware LMS Integration page and checking the 1.3 Canvas tab for Connected.

Important: Once the integration is set up, any student added to the Canvas Course will have access to Visible Body. Once they click a Courseware link, they will either be counted as part of the site license arrangement (if the integration is set up as a site license) or start the purchase process.

Visible Body (LTI 1.3) should be available in your course’s left hand navigation already. Your administrator may have named this tool something else. We recommend that your admin add our Course Home to all courses using Visible Body. This makes it easier to manage course content and gives students and instructors one-click access to the full Visible Body Suite app.

However, if they have not installed Courseware Home you can still manage your courses in the Assignment Library.

1. Select Visible Body (LTI 1.3) and sign in using your Visible Body email and password. You’ll only have to do this once in Canvas.
2. Select the Visible Body course you want to associate with your Canvas course. If you don’t have one set up yet, you can create one at this stage.
3. Click Link Course and confirm.
4. Your course is now linked. From the Visible Body (LTI 1.3) homepage, selecting Go to Courseware will take you or your students to the associated course in Courseware.

The Visible Body Assignment Library displays all published assignments within your linked course. Click on any assignment to open it and view its activities, you'll see a toggle next to each activity that allows you to mark it as graded or ungraded - this will determine whether or not the assignment populates your LMS gradebook. Select the checkbox next to the assignment to link it to your course.

To make edits or publish new assignments, simply click Manage Assignments, and you will be taken directly to your linked Courseware course.

To update your linked course, click the settings cog in the upper right corner.

Before you start the integration process you need a Courseware "secret and key" for Canvas from the Visible Body Team. If you don’t have a secret and key from a Visible Body representative, please request one.

Once you have your secret and key, you are ready to start the integration process by following the steps below. You can also schedule a call with Visible Body to help you set up your integration.

1. Set up Courseware as an external tool in Canvas. Simply add Courseware as an app using the Canvas App Center and the secret and key provided with your school's Visible Body Courseware group subscription.

   1. Log into Canvas.

   2. Go to Settings.

   3. Select the Apps tab.

   4. Next, check the list of apps for the Visible Body icon and then select it. (If you are missing this icon, please submit a support ticket

   5. Finally, enter your secret and key.

2. Select the Canvas course you want to integrate with your Courseware course.

3. To make Courseware available on the left-hand bar in Canvas, you will need to make it visible. (By default, Courseware will be hidden.)

   1. In the Settings menu, go to Navigation

   2. You’ll see Visible Body Courseware in a list under items that are hidden from students. Drag it up and drop it to the place you want it to show on the left-hand bar (course navigation section).

   3. Select “Save”

   4. Refresh your view, and Courseware will show on the left-hand bar.

For students to access your course, you will need to link the Canvas course to the Courseware course you wish to use.

1. Select Visible Body Courseware from the left-Nav menu and sign in to link your Canvas and Courseware accounts. You won't be asked to log into Courseware again when accessing through Canvas, just log into Canvas!
2. Next, you'll be prompted to link aCourseware course to your Canvas course. Just select your course from the dropdown, or if you want to create a new course, select "Create one" below.

   Look for the green confirmation message at the top of the screen to make sure your course has been linked successfully.

3. Each time you visit Courseware through Canvas, it will bring you directly to the linked Courseware course.

If you’ve linked the incorrect course and need to unlink your Courseware and Canvas courses, follow the instructions in the "Unlink a Courseware Course" section below.

Some items to note:

1. Import Courseware grades into Canvas more effectively with the CSV export function in the gradebook. Now, you can use the populated SIS User ID column to match up students before you import the grades.
2. Canvas Courseware integration is available for schools that have a group license and for courses in which students purchase their own subscription.
3. You only need one secret and key for each instance of Canvas. Most instructors at one campus can use the same secret and key to set up their courses. If your school has multiple campuses using different instances of Canvas, you will need a secret and key for each.
4. DO NOT use the "Invite People" link to invite students to your course. This feature does not work with the Canvas-Courseware integration. - This really only affects deep integration users.

If you are using Safari and see an error message, follow these steps:

1. Select "Safari" from the top menu bar.
2. In the dropdown, select "Preferences".
3. In the settings window, select "Privacy" from the top bar.
4. Uncheck the box for "Prevent cross-site tracking"
5. Try linking your Courseware course to your Canvas course again.
6. If you still see an error message, please contact our support team.

Once your integration is set up, it is easy for students to access Courseware within Canvas. This article includes step by step instructions.

The instructions below are for customers who want a Deep Integration between Canvas and Courseware for their courses. In addition to single sign-on functionality, Deep integration will automatically sync selected assignments and grades with your Canvas gradebook.

To complete the Deep integration, the person following these steps at your school will need administrator access to the school's Canvas instance.

You can change your Canvas sync status anytime.

If you currently have a Deep integration and want to switch to Lite, you will not lose any grades in either system, but any subsequent scores from Visible Body will no longer be automatically reported to the Canvas gradebook. Simply switch the Deep Integration slider to the "off" position.

If you currently have a Lite integration and want to switch to Deep, you can select which assignments to sync so that those scores will be automatically reported to the Canvas gradebook.

If you've accidentally linked the wrong Courseware course to your Canvas course or vice versa, you can follow these steps to unlink your courses.

1. On the LMS Integration page, navigate to the Canvas subsection. You will see the listing of courses that are linked.
2. Check off the radio button next to the pairing you want to unlink.
3. Select the “Unlink Course” button, and confirm you want to unlink these courses by selecting “OK” in the pop-up. You will see a green confirmation message at the top of the screen that these two courses are now unlinked. Note: you can only unlink one set of courses at a time.

Scopes are optional. If schools prefer to enforce Scopes these are the specific scopes required for current Canvas Deep integration features:

Assignments

• url:GET|/api/v1/courses/:course_id/assignments
• url:GET|/api/v1/courses/:course_id/assignment_groups/:assignment_group_id/assignments
• url:GET|/api/v1/courses/:course_id/assignments/:id
• url:DELETE|/api/v1/courses/:course_id/assignments/:id
• url:PUT|/api/v1/courses/:course_id/assignments/:id
• url:POST|/api/v1/courses/:course_id/assignments

Assignment Groups (Folders)

• url:GET|/api/v1/courses/:course_id/assignment_groups
• url:GET|/api/v1/courses/:course_id/assignment_groups/:assignment_group_id
• url:POST|/api/v1/courses/:course_id/assignment_groups
• url:PUT|/api/v1/courses/:course_id/assignment_groups/:assignment_group_id
• url:DELETE|/api/v1/courses/:course_id/assignment_groups/:assignment_group_id

Courses

• url:GET|/api/v1/courses/:course_id/users

Submissions

• url:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id