Desire2Learn Admin Setup

Upgrading from LTI 1.1 to LTI 1.3

For a full list of frequently asked questions regarding LTI 1.3, see 1.3 FAQ.

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.

1. In an Administrator account, click on the Admin Menu and select Manage Extensibility.
2. Click on the LTI Advantage tab, select Register Tool, and then enter:
   
   • Enabled: On
   • Name: Perusall 1.3
   • Description: The Perusall social learning platform
   • Domain: https://app.perusall.com
   • Redirect URL and Target link URI: 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
   • Registration: Standard

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:

1. Click New Deployment, and enter:
   • Tool: Perusall 1.3
   • Name: Perusall
   • Description: The Perusall social learning platform
   • Extensions: Deep Linking, Names and Roles, Assignments and Grades
   • Security Settings: Enable everything except Org Defined ID.
   • Classlist: Ensure Classlist including users not known to this deployment is checked
   • Configuration Settings: Check off Open as External Resource. 
2. 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):

1. Go to Tools > Manage Extensibility > OAuth 2.0, and click Register an app.
2. 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
3. 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. 

Now create a basic Link for Perusall that instructors can add to their course:

1. Under Admin Menu > External Learning Tools > LTI Advantage, select Perusall, click View Links, and then New Link. 
2. Enter the following:
   1. Name: Perusall
   2. URL: https://app.perusall.com/ltia/launch
   3. Description: The Perusall social learning platform
   4. Type: Basic Launch

Now create a Link to allow instructors to create "deep links" directly to Perusall assignments:

1. Under Admin Menu > External Learning Tools > LTI Advantage, select Perusall, click View Links, and then New Link. 
2. Enter the following:
   1. Name: Perusall Assignment link
   2. URL: https://app.perusall.com/ltia/launch
   3. Description: The Perusall social learning platform
   4. Type: Deep Linking Quicklink
   5. Width: 1000
   6. Height: 800

Add your LTI Platform through the Institution Dashboard:

• To request institutional admin access for your Perusall account (register for an account), for security verification purposes, please email support@perusall.com and point us to an institutional web page that shows your name, email address and title/affiliation.
• Once Perusall has confirmed your request, you will see Institution Dashboard on your Perusall home page (to the left of Get Help), and you can navigate to Settings > LTI 1.3 integrations > Add a new LTI 1.3 integration.  Select your LMS type (Brightspace/D2L), and insert your:
  • Client ID
  • Deployment ID
  • Brightspace Keyset URL
  • OpenID Connect Authentication Endpoint
  • Brightspace OAuth2 Access Token URL
  • API client ID
  • API client secret
• Click Ok to finalize your placement, and Save Changes.
  • Once your credentials have been entered into our platform list, you can refer your instructors to follow Desire2Learn Instructor Setup.

*If you are using a course level or sub account level deployment, or needing to add new deployments for any reason, Perusall institutional admins from institutions with an existing LTI 1.3 integration can now add additional deployment IDs in Institution Dashboard. 

NOTE

Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.