Desire2Learn / Brightspace setup

Initial administrative setup

First set up Perusall as an External Learning Tool by selecting External Learning Tools > Manage Tool Providers > New Tool Provider. In the resulting screen:

• Launch Point: https://app.perusall.com/lti/launch
• Secret: (provided by Perusall Support)
• Use custom tool consumer information instead of default: Yes
• Key: (provided by Perusall Support)
• Name: Perusall
• Description: (put anything here)
• Contact Email: support@perusall.com
• Allow users to use this tool provider: Yes
• Send tool consumer information to tool provider: Yes
• Send context information to tool provider: Yes
• Send course information to tool provider: Yes
• Send LTI user ID and LTI role list to tool provider: Yes
• Send user name to tool provider: Yes
• Send user email to tool provider: Yes
• Send system username to tool provider: Yes
• Send system Org Defined ID to tool provider: No
• Send system role to tool provider: Yes
• Send link title to tool provider: Yes
• Send link description to tool provider: Yes

If you do not have your key and secret, request it from Perusall Support (for security verification purposes, provide a link to an institutional web page that shows your name, title, email address).

If prompted, select HMAC-SHA1 (not HMAC-SHA256) as the OAuth Signature Method.

Setting up your course

1. Create a link in your course that points to Perusall: within one of your content modules, select Add Existing Activities > External Learning Tools > Create New LTI Link.
2. Enter Perusall for the name and https://app.perusall.com/lti/launch for the launch point.
3. Select Edit properties in place in the dropdown next to the newly-created link, and check Open as external resource.
4. Reload the page.
5. Click on the new Perusall link. Perusall will launch and a course will be created that is connected to your D2L course.
6. Set up your readings and assignments within Perusall.

Setting up grade sync

For grades in Perusall to sync back to D2L, students must access each assignment in Perusall through an external tool link in D2L that has the same name as the assignment in Perusall.

For each assignment in Perusall:

1. Click on an assignment under Assignments on your course home page, and click the Copy full title for LMS button. (This will copy the name of the assignment to the clipboard.)
2. In D2L, within one of your content modules, select Add Existing Activities > External Learning Tools > Create New LTI Link.
3. For the name, paste in the Perusall assignment name from the clipboard, and enter  https://app.perusall.com/lti/launch for the launch point.
4. Select Edit properties in place in the dropdown next to the newly-created link, and check Open as external resource.
5. Reload the page.
6. Test out the link by clicking on it. You should be taken directly into the corresponding assignment in Perusall, bypassing the course home page in Perusall. If you are instead taken to the course home page in Perusall, check that the name of your link in D2L matches exactly with the name of the assignment in Perusall.

Note: To ensure that grade sync works throughout the semester, make sure that students access each Perusall assignment by clicking through the corresponding link in D2L. If a student accesses an assignment in Perusall without clicking through the corresponding D2L assignment link at least once, then Perusall will not be able to send that student's score back to D2L. As a result, you may want to hide or delete the generic Perusall link you created in D2L to force students to access assignments through the corresponding assignment-specific links.