Follow the end-to-end installation guide for the PebblePad LTI with Blackboard for global administrators to integrate the platforms together as recommended.
Installation is not self-serve. To initiate, request support from a PebblePad Integration Engineer.
1. Create service user account
For authentication, the API requires a user account with administration permissions. We recommend using a dedicated service user account.
To set up:
- Follow the Blackboard guide to create a user for a service account.
- Assign a system role with the following permissions (as minimum).
| Administrator Panel (Courses) > Courses > Edit > Enrolments |
| Administrator Panel (Organizations) > Organizations > Edit > Enrolments |
| Administrator Panel (Users) > Users > Edit > View Course Enrolments |
| Administrator Panel (Users) > Users > Edit > View Organization Enrolments |
| Course/Organization > Groups > View All Groups |
| Course/Organization Control Panel (Grade Centre) > Full Control |
| Course/Organization Control Panel (Users and Groups) > Groups |
| Course/Organization Control Panel (Users and Groups) > Users |
| User management by Web Services |
2. Add REST API
- Log in to your Blackboard with an administration account.
- From the main menu, click Admin to open the Administrator Tools.
- In the Integrations panel, click REST API integrations.
- Click Create Integration.
- Complete the fields using the information in the table below.
- Click Submit.
| Application ID |
|
| Learn User | Browse - add the service user account |
| End User Access | Yes. End users will sign in with their own Blackboard ID and access is limited to their own permissions. |
| Authorise to Act As User | Service Default (No) |
3. Manage global properties
- Return to Administrator Tools.
- In the Integrations panel, click LTI Tool Providers
- Click Manage Global Properties.
- For Allow configured tool providers to post grades, choose Yes.
- Click Submit.
4. Set LTI in PebblePad
- In a new tab window, log in to your PebblePad with an administrator account.
- From the Pebble+ burger menu, choose Additional services > Administration.
- Click Integrations and Blackboard from the sub menu.
- Type or paste your Blackboard URL into the field - must end with /
- Click Save.
- Note the Key and Secret.
We recommend leaving this browser tab open to refer back to.
5. Register LTI tool in Blackboard
- Return to Blackboard - logged in with an administration account.
- Click Admin to open the Administrator Tools.
- In the Integrations panel, click LTI Tool Providers.
- Click Register LTI 1.1 Provider.
- Complete the fields using the information in the table below.
- Click Submit.
| Provider domain |
|
| Provider domain status | Approved |
| Secondary Hostnames | atlas.pebblepad.co.uk v3.pebblepad.co.uk For UK server only (include both URLs) |
| Default configuration | Set globally |
| Tool Provider Key | Obtained in step 4 (from PebblePad) |
| Tool Provider Secret | Obtained in step 4 (from PebblePad) |
| Tool Provider Custom Parameters | Pebble_username=$User.username |
| Send User Data | Send user data only over SSL |
| User Fields to Send | ✓ Role in course ✓ Name ✓ Email address |
| Allow Membership Service Access | Yes |
6. Register client IT
- From the LTI Tool Providers page, click Register LTI 1.3 / Advantage Tool.
- Paste into the field using the information in the table below.
Test (all regions) dad88c0c-8ac5-4738-b953-20fbc5deebcd AU Production 3b2ea317-addb-4652-ad4e-cfcb65f47624 CA Production cc6a6dd1-f007-46bd-b0ec-9bbd343434bd UK Production dddf8332-241c-433f-b4f0-0c7684ef393d US Production 20a8012d-35af-4b35-b392-e04aa96708c7 - Click Submit
- Note the Deployment ID - needed for the next stage.
- Complete the fields using the information in the table below
- Click Submit.
| Tool Status | Approved |
| User Fields to Sent | ✓ Role in course ✓ Name ✓ Email address |
| Allow Grade Service Access | Yes |
| Allow Membership Service Access | Yes |
7. Contact PebblePad
For the PebblePad Integration Engineer to authenticate the integration, provide them with:
- Installation location (TAQAS or Production)
- Blackboard URL
- Development ID
To run an end-to-end user test, follow the workspace manager's guide to creating a Blackboard-linked assignment.