Skip to main content

Perusall Support

Search

Blackboard Admin Setup

  • Updated

Administrator Setup (Production)

Administrator Setup (Staging)

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 Blackboard 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. 
  • You cannot have 1.3 and 1.1 installed at the same time in Blackboard. So it is best to wait to upgrade until the semester is over. 

See also: 1.3 FAQ

Administrator Setup (Production)

  1. Navigate to System Admin > Integrations > LTI Tool Providers, and select Register LTI 1.3/Advantage Tool.
  2. For Client ID, enter fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6 and click Submit. 
  3. Take note of the Deployment ID that is shown in the next screen, and send this to Perusall Support.
  4. Under Institution Policies, ensure Role in Course, Name, and Email Address are all checked, and that both grade access service and Membership Service Access are set to Yes. Then click Submit.
  5. Select Manage placements, and ensure that the deep link placement is set to open in a new window.
  6. Navigate to System Admin > System Roles > Create a Role.
    • Name: Perusall API
    • Role ID: perusallapi
    • Description: This is the user that Perusall will act as when accessing group information for your courses.
    • Assign the following privileges:
      • Course/Organization > Groups > View All Groups
      • Course/Organization Control Panel (Users and Groups) > Groups
  7. Navigate to System Admin > Users > Create User.
    • First Name: Perusall
    • Last Name: API
    • Username perusallapi
    • Password should be unique.  It's not an account that's ever going to be used to log in.
    • Primary Institution Role: Student
    • Primary System Role: Perusall API
  8. Navigate to System Admin > Integrations > REST API Integrations, and select Create integration.
  9. Enter the following values, and then click Submit.
    • Application ID: fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6
    • Learn User: Perusall API
    • End User Access: Yes
    • Authorized To Act As User: No

Once Perusall Support has received your Deployment ID and activated in the integration, your instructors can use Perusall in their courses. 

Administrator Setup (Staging)

Staging is only for testing and should not contain any real course or student data. 

Disclaimer: Data on staging may be removed at any time. 

  1. Navigate to System Admin > Integrations > LTI Tool Providers, and select Register LTI 1.3/Advantage Tool.
  2. For Client ID, enter 2639a1cf-9230-4441-aae8-701c7414e145 and click Submit. 
  3. Take note of the Deployment ID that is shown in the next screen, and send this to Perusall Support.
  4. Under Institution Policies, ensure Role in Course, Name, and Email Address are all checked, and that both grade access service and Membership Service Access are set to Yes. Then click Submit.
  5. Select Manage placements, and ensure that the deep link placement is set to open in a new window.
  6. Navigate to System Admin > System Roles > Create a Role.
    • Name: Perusall API
    • Role ID: perusallapi
    • Description: This is the user that Perusall will act as when accessing group information for your courses.
    • Assign the following privileges:
      • Course/Organization > Groups > View All Groups
      • Course/Organization Control Panel (Users and Groups) > Groups
  7. Navigate to System Admin > Users > Create User.
    • First Name: Perusall
    • Last Name: API
    • Username perusallapi
    • Password should be unique.  It's not an account that's ever going to be used to log in.
    • Primary Institution Role: Student
    • Primary System Role: Perusall API
  8. Navigate to System Admin > Integrations > REST API Integrations, and select Create integration.
  9. Enter the following values, and then click Submit.
    • Application ID: fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6
    • Learn User: Perusall API
    • End User Access: Yes
    • Authorized To Act As User: No

Please send your Deployment ID and institution name to Perusall support so that we may activate your integration.  For secure delivery, we recommend sending this information using https://privnote.com. 

 

After Perusall has confirmed your credentials have been added to our LTI platform list, direct your instructors to our Blackboard Instructor Set Up page.