Willo Labs Blackboard LTI 1.1 Implementation

LTI Tool Provider Configuration

The Willo Labs LTI Tool Provider can be configured at the system level with Blackboard. These instructions assume that you have received the necessary tool provider key and secret from Willo Labs.

LTI 1.1 Tool Provider Configuration

1. Log into Blackboard as an Administrator and navigate to the Admin tab.
2. Under the Integrations tab, click LTI Tool Providers.

3. Click on Register LTI 1.1 Provider.

4. Define the following properties:
   1. Provider Domain:
      1. US-based institutions: app.willolabs.com
      2. CA-based institutions: ca.willolabs.com
   2. Provider Domain Status: Approved
   3. Secondary Hostnames: Leave Empty
   4. Default Configuration: Set globally
   5. Tool Provider Key: Provided by Implementation Team
   6. Tool Provider Secret: Provided by Implementation Team
   7. Tool Provider Custom Parameters: Leave Empty
   8. Send User Data: Send user data only over SSL
   9. User Fields to Send: Select the following
      • Role in Course
      • Name
      • Email Address
   10. Allow Membership Service Access: Yes

5. Click Submit.

Manage Placement for Willo Labs Tool

Follow these steps to make the Willo Labs tool available to your instructors in Course Tools in the left navigation bar. Optionally, you may also add a placement to the Build Content area.

1. Log into Blackboard as an Administrator and navigate to the Admin tab.
2. Under Integrations, click LTI Tool Providers.
3. Locate the Willo tool provider, select the down arrow to the right of the link and select Manage Placements.

4. Select Create Placement.

Course Tools

Create the Course Tools placement for the Willo widget by completing the following fields, and click Submit when done.

• Label: Willo Labs
• Handle: willo-labs-course-tool
• Availability: Yes
• Type: Select Course Tool
• Select Launch in New Window
• Tool Provider URL: https://app.willolabs.com/onelink/
• Key and Secret will auto populate

OPTIONAL: Build Content

You may also create a second placement for the Willo widget in the Built Content area of courses by completing the following fields. Click Submit when done.

• Label: Willo Labs
• Handle: willo-labs-course-content
• Availability: Yes
• Type: Select Course Content Tool
• Select Launch in New Window
• Tool Provider URL: https://app.willolabs.com/onelink/
• Key and Secret will auto populate

API Grade Sync Setup

If you are using an LTI 1.1 tool configuration, you may follow these instructions to set up API grade sync.

Blackboard

[Optional] Setup System-Specific Role and User for API Authentication (System Roles)

You may provide authorization to the Application ID installation using your personal Blackboard admin user account. If that is the case, you can skip to the Install API section. Please follow the steps below if you’d like to create a specific system role and user account for Willo Digital Delivery.

 

1. Login to Blackboard as an Administrator and navigate to the Administrator panel.
2. Select Users > System Roles and Create Role.
3. Input a Role Name and Role ID and then click Submit.
4. Assign the following permissions by searching each permission and then select the checkmark beside the permission. Select the Privileges menu and then select Permit Privileges.
   • Course/Organization Control Panel (Grade Center) > All Grading
   • Course/Organization Control Panel (Grade Center) > Full Control
   • Course/Organization (Content Areas) > Create Materials
   • Course/Organization (Content Areas) > Edit Materials
   • Course/Organization Control Panel (Users and Groups) > Users
   • Administrator Panel (Users) > Users
5. When complete, navigate back to the Administrator panel and choose Users
6. Click Create User and provide a First Name (e.g. Willo), Last Name (e.g. API), and Username (e.g. willodigitaldelivery). Select Staff for Institution Role and then select your newly created System Role from step 3 for a System Role. Click Submit.

 

Install API (REST API Integrations)

1. Log into Blackboard as an Administrator and navigate to the Administrator panel.
2. Under Integrations, click REST API Integrations
3. Click Create Integration

4. Input the following form fields:
   • Application ID: Provided by Implementation Team
   • Learn User: Your administrator username or the one created from step 6 of the previous section
   • End User Access: Yes
   • Authorized To Act as User: Service Default (No)
5. Click Submit