Upgrading from LTI 1.1 to LTI 1.3
There are several benefits to upgrading to LTI 1.3. First, creating individual assignment links in your LMS is no longer necessary to sync individual assignment scores to your LMS. Students can use a generic Perusall link and individual assignment scores will still be sent to the LMS. You can still create individual assignment links, called “deep links” in LTI 1.3, which point to particular Perusall assignments even when the link and assignment do not have matching names. (Note: deep links are automatically created in D2L as you create Perusall assignments.) Second, your LMS course roster automatically syncs to your Perusall course; instructors will be able to view the full roster in Perusall even before students ever launch into Perusall. That way, instructors can set up groups in advance of the start of the semester.
A few important notes about migrating an LTI 1.1 integration to an LTI 1.3 integration:
- Users who initially created their Perusall account through an LTI 1.1 integration will receive a one time confirmation email the first time they launch Perusall through an LTI 1.3 integration.
- Existing Perusall courses cannot be upgraded from LTI 1.1 to LTI 1.3; LTI 1.3 will only apply to newly-created courses. Since some LMSs do not allow for both a LTI 1.1 integration and a LTI 1.3 integration to be active simultaneously, we recommend switching over to LTI 1.3 between semesters. Previously created LTI 1.1 courses will not be deleted; instructors will still be able to access them from within their Perusall account even if they can no longer launch them from the LMS.
Administrator setup:
Note: If you are using a Testing/Staging Instance, please remember to replace any urls starting in app.perusall with staging.perusall.
- In an Administrator account, click on the Admin Menu and select Manage Extensibility.
- Click on the LTI Advantage tab, select Register Tool, and then enter:
- Enabled: On
- Name: Perusall
- Description: The Perusall social learning platform
- Domain: app.perusall.com
- Redirect URLs: https://app.perusall.com/ltia/launch
- OpenID Connect Login URL: https://app.perusall.com/ltia/oidc
- Keyset URL: https://app.perusall.com/ltia/jwks
- Extensions: Deep Linking, Names and Roles, Assignments and Grades
- Send Institution Role: Yes
Once you complete the tool registration, Brightspace/D2L will provide a Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and a Brightspace OAuth2 Access Token URL; record these for later. Now add a deployment:
- Click New Deployment, and enter:
- Tool: Perusall
- Name: Perusall
- Description: The Perusall social learning platform
- Extensions: Deep Linking, Names and Roles, Assignments and Grades
- Sharing: Select your desired sharing information
- Classlist: Ensure Classlist including users not known to this deployment is checked
- Click Create Deployment.
Brightspace/D2L will then provide a Deployment ID. Now register Perusall as an application that has the authority to read group information (to allow instructors to import their groups from Brightspace into their Perusall course):
- Go to Tools > Manage Extensibility > OAuth 2.0, and click Register an app.
- Enter the following values, and click Register.
- Application Name: Perusall
- Redirect URI: https://app.perusall.com/ltia/oauth/response
- Scope: core:*:* groups:*:* enrollment:*:*
We suggest using the above scopes to allow Perusall to add additional API functionality in the future without requiring reconfiguration. However, if you prefer to restrict Perusall to the minimum scopes needed to support the current functionality, you can use the following more restrictive scopes instead: groups:group:read enrollment:orgunit:read - Access Token Lifetime: 1800
- Prompt for user consent: No
- Enable refresh tokens: No
- Now obtain your API client ID and API client secret by returning to Tools > Manage Extensibility > OAuth 2.0 and selecting the new Perusall entry.
Send the Client ID, Deployment ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, Brightspace OAuth2 Access Token URL, API client ID, and API client secret to Perusall Support. For secure delivery, we recommend sending this information using https://privnote.com.
Now create a basic Link for Perusall that instructors can add to their course:
- Under Admin Menu > External Learning Tools > LTI Advantage, select Perusall, and then New Link.
- Enter the following:
- Name: Perusall
- URL: https://app.perusall.com/ltia/launch
- Description: The Perusall social learning platform
- Type: Basic Launch
Now create a Link to allow instructors to create "deep links" directly to Perusall assignments:
- Under Admin Menu > External Learning Tools > LTI Advantage, select Perusall, and then New Link.
- Enter the following:
- Name: Perusall
- URL: https://app.perusall.com/ltia/launch
- Description: The Perusall social learning platform
- Type: Deep Linking Quicklink
- Width: 800
- Height: 600
Instructor setup
- To set up your Perusall course, go to a content area of your D2L course, select Existing Activities > and the Perusall button should appear there. (If you do not see Perusall from that drop down, then click External Learning Tools, and select Perusall from the links provided.) Perusall will now be in the module area.
- Next, click the drop down arrow next to the Perusall link, select Edit properties in place, and check off the box next to Open as an external resource.
- Launch Perusall and create your D2L-Perusall integrated course. Perusall will automatically sync your Perusall course roster with the D2L roster.
Grade Sync
If you would like to automatically sync the average of all Perusall assignments to a single gradebook column in Moodle, launch into Perusall, select Settings > Grade sync to LMS > Automatically sync students' average scores to LMS, and then click Save changes.
If you would like to sync individual assignment scores to multiple columns in the Moodle gradebook, launch into Perusall, select Settings > Grade sync to LMS > Automatically sync students' scores to LMS, and then click Save changes.
In either case, there is no need to create individual links to each Perusall assignment; however, if you would like to do so, you can create "deep links" into the corresponding Perusall assignment. To do this, go to Existing Activities and scroll down to Perusall Deep link (created by your IT admin). A window will pop up that will allow you to select a Perusall assignment to link. Note that you must first create the assignment in Perusall before you can link to it in this way.