> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goguardian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Canvas with Pear Assessment

> Set up Canvas integration by creating a developer key, adding credentials to Pear Assessment, installing the app, and syncing your district roster.

Integrate Canvas with Pear Assessment

The article explains how to integrate Pear Assessment with Canvas, a Learning Management System (LMS), through a self-service process. It guides users on setting up and managing the integration for efficient classroom management and student data utilization.

## Integrate Canvas with Pear Assessment

Pear Assessment supports an integration with Canvas, which can be configured in your District Settings. You will need a Pear Assessment District Admin account to complete the Canvas integration.

## Enable Canvas Integration

1. Sign in to Pear Assessment with an administrator account.
2. Click **Manage District**.
3. Click **Settings**.
4. Click **District Policies**.
5. Under **Domains** > **3rd Party Integrations**, click the radio button for Canvas.
6. Click **View Configuration** to open your Canvas integration settings in a new tab.
7. Keep the tab with the screen below open, then go to your Canvas instance in a new tab.

## Create a Developer Key

To perform this step, the Canvas Administrator from your school or district creates a developer key to integrate Pear Assessment with Canvas. Use the following steps to obtain the developer key:

1. Sign in as admin to your school or district Canvas instance.
2. Click on **Admin** and click on the instance defined in **Managed Accounts**. Select **Developer Keys** from the menu. Click on the **+ Developer Key** button and select **Create an API Key**.
3. Create a key using the following values:
   * **Key Name**: e.g. Pear Assessment (This will be visible as link to users)
   * **Owner email**: canvas admin's email id
   * **Redirect URLs**: [https://app.edulastic.com/](https://app.edulastic.com/)
4. Obtain your Instance URL, client ID and Developer Key for the Pear Assessment integration.

Note: To get the developer key, please click on the **Show Key** button.

Please ensure the state of the developer key is set to "On":

1. As a Canvas admin, navigate to the root account.
2. Select the **Developer Keys** menu.
3. Select the **Account** tab and ensure Pear Assessment is set to On.

Sometimes it may be necessary to click **Inherited** and turn the key to On.

## Add Canvas Credentials to Pear Assessment

1. In the **Canvas Integration** tab, set up the Developer Keys by adding the relevant information for the fields below:
   * **Instance URL**: Your Canvas Instance URL
   * **Client ID**: Generated from Canvas
   * **Secret Key**: The key generated from the Client ID in Canvas
2. Click **Test Connection** to verify the keys communicate with your Canvas environment.
3. If the test is not successful, please review the previous steps to ensure all the data is accurate.
4. When the test is successful, click **Next** to view the unique Consumer Key and Shared Secret (Secret Key) assigned to your account.
5. Keep your Pear Assessment tab open and go back to the tab with your Canvas instance for the next steps.

## Installing the Pear Assessment App in Your Canvas Instance

1. To complete this step, use the Consumer Key and Shared Secret (Secret Key) from Pear Assessment in the previous step.
2. This key can be copied on the second screen while configuring your Canvas connection. Use these credentials to add the Pear Assessment App in Canvas.
3. Find the Pear Assessment app from the Canvas App Center. Go to **Settings** > **Apps** > Search for **Pear Assessment** and click on the **Pear Assessment** App.
4. Install the Pear Assessment App. Click on **+Add App** and enter the Consumer Key and Shared Secret (Secret Key).
5. Enter the Launch URL: [https://app.edulastic.com/api/auth/Lti](https://app.edulastic.com/api/auth/Lti)
6. Go back to your Canvas Configurations on your Pear Assessment tab.
7. Click **Next** to School Mapping, select your Canvas account from the dropdown menu and map them to your schools.
8. Click **Next**.
9. Sync your Canvas integration under **Sync District**.