Desire2Learn Admin Setup

Step 1: Install Perusall 1.3

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: Enable Open as External Resource. 
2. Click Create Deployment.

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 the Institution Dashboard.

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:
   • 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:

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

Step 2: Add your LTI Platform through the Institution Dashboard

Please follow the steps below to finalize your integration by adding the Perusall LTI 1.3 tool information from your LMS to our list of LTI Platforms using your Institution Dashboard. 

• Register for an account.

• Contact Perusall support, and point us to an institutional web page that shows your name, email address and title/affiliation.

  If you are using staging.perusall.com, please register for a staging account, provide the verification details above, and when you contact Perusall support, please let us know you'd like access to the Staging institution dashboard.

• 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.

Learn more about your Institution dashboard features.

Testing the integration

Once your credentials have been entered into our platform list, you can test the integration by following Desire2Learn Instructor Setup & Desire2Learn Integration Features.

LTI 1.3 courses offer a new grade sync feature: LMS gradebook column management.  Learn more about grade sync in LTI 1.3 courses. 

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

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