This guide covers how to add a new external tool for PebblePad in a Brightspace administration area.
STEP-BY-STEP
- 1: Open Manage Extensibility
- 2: Register new tool
- 3: Add new deployment
- 4: Add assignment link
- 5: Add Resource link
- 6: Setup Config Variables
Login to Brightspace using an account with a System Admin role.
1: Open Manage Extensibility
- From the Brightspace dashboard, select the Setting cog (top right) to view the admin options
- Select Manage Extensibility from the sub menu
2: Register new tool
- Select LTI Advantage from the sub menu
- Select the Register Tool button
- Add the following data into the related fields.
| Setting | Value |
| Tool Type | Standard |
| Enabled | On |
| Tool name | PebblePad LTI 1.3 |
| Domain | https://server domain/ |
| Redirect URLs | https://server domain/login/openid/redirect Replace server domain with the appropriate option from the sub-table below. |
| OpenID Connect Login URL | https://server domain/login/openid/authorise Replace server domain with the appropriate option from the sub-table below. |
| Target Link URI | https://server domain/login/openid/redirect Replace server domain with the appropriate option from the sub-table below. |
| Keyset URL | https://server domain/login/org-code/.well-known/jwks.json Replace server domain with the appropriate option from the sub-table below. Also, replace org-code with your Pebble installation org URL found on the end of your main login page URL. e.g. https://apptest.pebblepad.com/login/abcde |
| Extensions (checked) |
|
| Roles (checked) |
|
Sub-table for location-based server domains:
| Location | Domain |
|---|---|
| TAQAS (Testing - All locations) | lti1p3.apptest.pebblepad.com |
| AU (Production) | lti1p3.pebblepad.com.au |
| CA (Production) | lti1p3.pebblepad.ca |
| UK (Production) | lti1p3.pebblepad.co.uk |
| US (Production) | lti1p3.pebblepad.com |
- Select Register button to save and confirm
From the pop-up modal, copy the information displayed and add into our Brightspace Integration Data sheet (.csv). We'll explain how to send this to us at the end of Stage 3.
3: Add new deployment
- From the pop-up modal, select the View Deployments link
- Select the New Deployments button
- Add the following data into the related fields.
| SETTING | VALUE |
|---|---|
| Tool | PebblePad LTI 1.3 |
| Name | PebblePad Assignment |
| Description | (optional) |
| Security Settings (checked) |
|
| Configuration Settings (checked) |
|
| Custom Parameters | |
| - name | pebble_username |
| - value | $User.username |
- (optional) Select Add org units and choose specific departments, courses, modules this tool should only be available for
- Select the Create Deployment button to save
From the pop-up modal, copy the information displayed and add into the Brightspace Integration Data sheet (downloaded in Step 2).
4: Add assignment link
- From the pop-up modal, select the View Links link
- Select the New Link button
- Add the following data into the related fields.
| SETTING | VALUE |
|---|---|
| Name | PebblePad Assignment |
| URL | https://server domain/login/openid/redirect Replace server domain with the appropriate option from the sub-table below. |
| Description | (optional) |
| Type | Basic Launch |
Sub-table for location-based server domains:
| Location | Domain |
|---|---|
| TAQAS (Testing - All locations) | lti1p3.apptest.pebblepad.com |
| AU (Production) | lti1p3.pebblepad.com.au |
| CA (Production) | lti1p3.pebblepad.ca |
| UK (Production) | lti1p3.pebblepad.co.uk |
| US (Production) | lti1p3.pebblepad.com |
- Select the Save and Close button to confirm
5: Add Resource link
- Select the New Link button (again)
- Add the following data into the related fields.
| SETTING | VALUE |
|---|---|
| Name | PebblePad Resource Link |
| URL | https://server domain/login/openid/redirect Replace server domain with the appropriate option from the sub-table below. |
| Description | (optional) |
| Type | Deep Linking Quicklink |
Sub-table for location-based server domains:
| Location | Domain |
|---|---|
| TAQAS (Testing - All locations) | lti1p3.apptest.pebblepad.com |
| AU (Production) | lti1p3.pebblepad.com.au |
| CA (Production) | lti1p3.pebblepad.ca |
| UK (Production) | lti1p3.pebblepad.co.uk |
| US (Production) | lti1p3.pebblepad.com |
- Select the Save and Close button to confirm
6: Setup Config Variables
The following facilitates to sync course members from Brightspace to ATLAS and have accounts created with Username rather than the OrgDefinedID.
- Select the Setting cog icon (top-right corner of the screen)
- Choose the Config Variable Browser link in the sub menu
- In the search box underneath View Change History enter d2l.Tools.Classlist.DisplayUsername
- Select the link in the table provided
- Select the Add Value button
- Choose the Select Org Unit button
- Select the title of your *area from the list (*dependent on local requirements)
- Select the Update button
- Adjust the Value, to On from the drop-down list
- Select the Save to finalise.
