Integrating Squarecap with your Learning Management System

Squarecap offers two levels of integration with popular learning management systems:

• Our Canvas API Integration allows teachers and students to use Squarecap with their existing Canvas credentials (single sign-on). Teachers can import their courses and rosters directly from Squarecap to Canvas, as well as upload Squarecap grades directly and automatically to Canvas.
• Our LTI integration allows students to access Squarecap content directly from their LMS and allows teachers to upload grades directly from Squarecap to Canvas.

For Canvas users, we highly recommend enabling an API integration. For Blackboard, Brightspace, Moodle, and other major LMS users, we recommend adding Squarecap as an LTI tool provider.

Before enabling an integration, feel free to reach out to [e-mail] with any questions concerning security, FERPA compliance, or accessibility.

Enabling a Canvas API Integration

To enable an API integration with Squarecap:

1. Log into your Canvas instance as an administrator.
2. Click on Admin, then click on your school's account name
3. Click on Developer Keys > Add Developer Key > API Key
4. Fill in the following information, leaving all other fields blank:
   1. Key Name: Squarecap
   2. Owner Email: [e-mail]
   3. Redirect URI: https://www.squarecap.com/login?canvas
   4. Icon URL: https://www.squarecap.com/static/img/scapv4.jpg
5. Click Save Key
6. Under the newly created Developer Key, click Show Key
7. Copy both the Developer Key and ID, then send this information to [e-mail] through your preferred secure channel
8. Finally, make sure the developer key's state is set to On

If your institution requires API scope limiting for Canvas integrations, we encourage you to enable these scopes for Squarecap.

Squarecap is a Certified Canvas Partner.

Adding Squarecap as an LTI Tool Provider

For LTI integrations, Squarecap will generate a secret and key combination for administrators to use for tool setup. To request a key and secret, email [e-mail].

Once you've obtained a key and secret from us, add us as a tool provider to your learning management system.

Blackboard

Follow these instructions to add a new LTI tool provider. Navigate to the Register Provider Domain form, then fill in the following information:

• Provider Domain: https://www.squarecap.com
• Provider Domain Status: Approved
• Default Configuration: Set globally
• Key and Secret: Enter the values provided by [e-mail]
• Send User Data: Send user data only over SSL
• User Fields to Send: ✓ Role in Course, ✓ Name,  ✓ Email

Finally, click Submit.

Sakai

Follow these instructions to add a new LTI 1.1 tool to your site from your administrative workspace. On the External Tool screen, fill in the following information:

• Tool Title: Squarecap
• Button Text: Squarecap
• Custom Icon: 🎓
• Tool Status: Enabled
• Tool Visibility: Visible
• Description: For tracking attendance, encouraging class participation, and providing students with immediate feedback in class
• Launch URL: https://squarecap.com/api/v1/lti
• Allow Launch URL to be changed: Allow
• Launch Key: Enter the key value provided by [e-mail]
• Allow launch key to be changed: Do not allow
• Launch Secret: Enter the secret value provided by [e-mail]
• Allow launch secret to be changed: Do not allow
• Launch types: ✓ Allow the tool to be launched as a link
• Privacy Settings: ✓ Send User Names to External Tool ✓ Send Email Addresses to External Tool
• Services: ✓ Allow External Tool to return grades ✓ Allow External Tool to create grade columns ✓ Provide Roster to External Tool
• Launch in Popup: Always launch in Popup

Finally, click Submit.

Moodle

Follow these instructions to add a new LTI 1.1 tool. Under Manage Tools, click Configure a tool manually. Under the configuration screen, enter the following information:

• Tool name: Squarecap
• Tool URL: https://squarecap.com/api/v1/lti
• Tool Description: For tracking attendance, encouraging class participation, and providing students with immediate feedback in class
• LTI version: LTI 1.0/1.1
• Consumer key: Enter the key value provided by [e-mail]
• Shared secret: Enter the secret value provided by [e-mail]
• Tool configuration usage: Show as preconfigured tool when adding an external tool
• Services > IMS LTI Assignment and Grade Services: Use this service for grade sync only
• Services > IMS LTI Names and Role Provisioning: Use this service to retrieve members' information as per privacy settings
• Privacy > Share launcher's name with tool: Always
• Privacy > Share launcher's email with tool: Always
• Privacy > Force SSL: ✓

Brightspace

Follow these instructions to add a new tool provider. For the Key and Secret, use those that have been provided to you by Squarecap.

• Launch point: squarecap.com
• Version: LTI 1.1
• OAuth Signature Method: HMAC-SHA1
• Use custom tool consumer information instead of default: ✓

Note: If you're using an LMS other than one listed above, or if these instructions are not working, just email [e-mail] and we'll work directly with you to enable integration with your LMS.