Follow the end-to-end installation guide for the PebblePad LTI with Brightspace for global administrators to integrate the platforms together as recommended.

Installation is not self-serve. To initiate, request support from a PebblePad Implementation Engineer.

Location server

In all places where indicated within this guide, replace LocationServer with the domain for your geographical area:

1. Whitelist domain

1. Log in to your PebblePad with an administrator account.
2. From the Pebble+ main menu, choose Additional services > Administration.
3. Click the Settings tab.
4. In the General panel, tick Content Security Policy header.
5. Click Update to save the page.
6. Return to Content Security Policy header, and add https://s.brightspace.com/
7. Click Update to save the page.

2. Add external tool

1. Log in to Brightspace with an administration account.
2. From the Settings cog, click Manage Extensibility
3. Click LTI Advantage from the sub menu.
4. Click Register Tool.
5. Complete the fields using the information in the table below.
6. Click Register.

Your OrgURL is in your PebblePad installation URL, e.g:
https://apptest.pebblepad.com/login/abcde

3. Add new deployment

1. From the modal, click View Deployments
2. Click New Deployments.
3. Complete the fields using the information in the table below.
4. (Optional) Tick Add org units, and choose specific departments, courses or modules.
5. Click Create Deployment.

4. Add assignment link

1. From the modal, click View Links.
2. Click New link.
3. Complete the fields using the information in the table below.
4. Click Save and close.

5. Add resource link

1. Click New Link (again)
2. Complete the fields using the information in the table below.
3. Click Save and close.

6. Set up config variables

This facilitates the sync of course members from Brightspace to ATLAS with accounts created using Username rather than the OrgDefinedID.

1. Click the Setting cog, and choose Config Variable Browser.
2. In the search, paste  d2l.Tools.Classlist.DisplayUsername
3. Click the link from the results.
4. Click Add value and choose Select Org Unit.
5. Choose your org units from the list (local set up specific)
6. Click Update.
7. For Value, choose On
8. Click Save.

7. Create service user account

The API requires authentication from a user account with an administrator role. It is advisable to use a dedicated service account and not a person's actual account.

1. From the Settings cog, click Roles and Permissions.
2. Click Create/Copy.
3. Click Start Fresh.
4. Name the role PebblePad API Access
5. In General, tick Cascading Role.
6. In Course Access Options, tick Access all course groups.
7. Click Save.
8. In the Edit Role Interactions, tick every box in the Administrator row in all tables on the page.
9. Click Save.
10. From the role's dropdown menu, click Edit Role Permissions.
11. For each permission below, tick the All column (to enable the whole row).
    
    

    Classlist > Has Access To The Classlist

    Grades > See the Grades tool

    Grades > Enter Grades

    Grades > Manage Grades

    Grades > Manage Items and Categories

    Groups and Sections Management > See Groups

    User Information Privacy > See First Names

    User Information Privacy > See Last Names

    User Information Privacy > See Usernames

    User Information Privacy > See Org Defined IDs

    User Information Privacy > See Email Addresses

    Users > View User Enrolments

    Users > <role> (all those you want to be visible to PebblePad)

    
    

12. Click Save and Close.
13. Create a new Service User Account (opens in new tab) and assign it the PebblePad API Access role.

8. Register API

1. Log in to Brightspace with the service account.
2. Click the Settings cog and choose Manage Extensibility.
3. Click OAuth2.
4. Click Register an app.
5. Complete the fields using the information in the table below.
6. Click Register.
7. Leave the tab open to retain access to the Client ID and Secret (for next stage)

Replace Domain with your location:
Test: apptest.pebblepad.com
AU Production: v3.pebblepad.com.au
CA Production: app.pebblepad.ca
UK Production: v3.pebblepad.co.uk
US Production: pebblepad.com

9. Set up PebblePad

1. In a new tab, log in to your PebblePad with an administrator account.
2. From the Pebble+ main menu, choose Additional services > Administration.
3. Click Integrations and Brightspace from the sub menu.
4. Complete the fields using the information in the table below.
5. In Settings for SSO, note the Key and Secret
6. Click Save.
7. From the Brightspace page, Click Accept.

10. Contact PebblePad

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

• Set-up Stage
  • We strongly suggest using the test server in the first instance
• Brightspace URL for your organisation

For the next settings, here are some steps to help you find them:

1. Log into Brightspace as an Admin
2. Go to Manage Extensibility
3. Click LTI Advantage
4. Locate the tool created for PebblePad and click it to enter the settings
5. Scroll down to the bottom of the screen and the majority of the required info is present - use the 'copy' button for time-saving and accuracy
6. Once these details have been copied and stored, click View Deployments at the very bottom of the page.
7. Click to enter the settings for the deployment created for the PebblePad integration
8. At the very bottom of the page you should see a Deployment ID (a GUID). Copy this and add to the list of other info gathered and send to your relevant contact in the PebblePad team through their stated method.

Data to send from the above steps:

• ClientID
  • a GUID
• Brightspace Keyset URL
• Brightspace OAuth2 Access Token URL
• OpenID Connect Authentication Endpoint
  • a URL
• Brightspace OAuth2 Audience
  • a URL
• Issuer
  • a URL
• DeploymentID
  • a GUID
  • Note that this on a different page to the others above, as noted in the earlier help steps

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