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 Implementation 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:

1. Follow the Blackboard guide to create a user for a service account.
2. Assign the Institution Role as 'Custom Test Role'

3. Assign a system role with the following permissions (as minimum).

2. Add REST API

1. Log in to your Blackboard with an administrator account.
2. From the main menu, click Admin to open the Administrator Tools.
3. In the Integrations panel, click REST API integrations.
4. Click Create Integration in the header above the main pane.
5. Complete the fields using the information in the table below.
6. Click Submit.

3. Manage global properties

1. Return to Administrator Tools.
2. In the Integrations panel, click LTI Tool Providers
3. Click Manage Global Properties.
4. For the setting 'Allow configured tool providers to post grades', choose Yes.
5. Click Submit.

4. Set LTI in PebblePad

1. In a new browser window, log in to your PebblePad with an administrator account.
2. From the Pebble+ main menu in the Navigation bar, choose Additional services > Administration.

3. Click Integrations and Blackboard from the sub menu.

4. Type or paste your Blackboard URL into the field - must end with /

5. Click Save.

6. In the Settings for SSO section, note the Key and Secret. Keep these safe for later.

We recommend leaving this browser tab open to refer back to.

5. Register LTI tool in Blackboard

1. Return to Blackboard - logged in with an administration account.
2. Click Admin to open the Administrator Tools.
3. In the Integrations panel, click LTI Tool Providers.
4. Click Register LTI 1.1 Provider (this is correct and a necessary step - do not worry about the 1.1. point for now)
5. On the 'Register Provider Domain' page that loads, complete the fields using the information in the table below and submit once done.

6. Register Client ID

1. From the LTI Tool Providers page, click Register LTI 1.3 / Advantage Tool.
2. Paste into the field using the information in the table below, as relevant for your region/stage:
   
   

   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

   
   
3. Click Submit
4. Note the Deployment ID - needed for the next stage to submit to the PebblePad Implementation Engineer for authentication purposes.
5. Complete the fields using the information in the table below
6. Click Submit.

7. Contact PebblePad

For the PebblePad Implementation Engineer to authenticate the integration, provide them with:

• Installation location (Test or Production; we strongly recommend doing this through the test server first)
• Blackboard URL for your organisation
• Deployment ID
  • As noted from the earlier steps in this guide after completing the 'Register Client ID' stage.

To run an end-to-end user test, follow the workspace manager's guide to creating a Blackboard-linked assignment.