If you are planning to conduct testing, we welcome you to do so in our testing environment, staging.perusall.com. 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.
Step 1: Install Perusall 1.3
To set up Perusall as a tool in your Moodle instance, navigate to Site Administration > Plug Ins > External Tool > Manage Tools, and then select the option to configure the tool manually.
Fill out the fields as shown below, and then click Save changes.
Tool settings
- Tool name: Perusall 1.3
- Tool URL:
https://app.perusall.com/ltia/launch
- Tool description: The Perusall social learning platform
- LTI version: LTI 1.3
- Public key type: Keyset URL
- Public keyset:
https://app.perusall.com/ltia/jwks
- Initiate login URL:
https://app.perusall.com/ltia/oidc
- Redirection URI(s):
https://app.perusall.com/ltia/launch
- Tool configuration usage: Show in activity chooser and as a preconfigured tool. If the above option is not available, select Show as preconfigured tool when adding an external tool.
- Default launch container: New window
- Supports Deep Linking: checked
- Content Selection URL:
https://app.perusall.com/ltia/launch
- Icon URL and Secure icon URL (under "Show more"):
https://perusall.com/favicon.ico
Services
- IMS LTI Assignment and Grade Services: Use this service for grade sync and column management
- IMS LTI Names and Role Provisioning: Use this service to retrieve members' information as per privacy settings
- Tool Settings: Use this service
Privacy
- Share launcher's name with tool: Always
- Share launcher's email with tool: Always
- Accept grades from the tool: Always
- Force SSL: checked
-
After you save the tool, locate Perusall 1.3 under Manage Tools, and click the list icon (left of the gear icon) to reveal the Tool configuration details.
-
Save these for the next (and final) step.
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 (Moodle), and insert your:
- Client ID
- Deployment ID
- Authentication request URL
- Access Token URL
-
Public Keyset URL
- 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 Moodle Instructor Setup & Moodle 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.
Moodle’s LTI 1.3 integration does not support the LTI 1.3 launch workflow that avoids cookies. This can cause issues when Perusall is opened in an iframe in browsers that block third-party cookies, particularly during the deep link content selection process. To avoid this, instructors using Moodle should either enable third-party cookies or use a browser like Firefox that allows them. Moodle has been aware of this issue, and it does not appear to be in progress..
Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.
Related to