General
Usage
The Desire2Learn/Brightspace (D2L) portal LTI Advantage integration simply allows further D2L experience level integrations, so be sure to check out our D2L experience integration article.
How to
Install Riipen in D2L with LTI Advantage
To install Riipen as a LTI Advantage application in D2L, follow all of these steps from inside of your D2L instance.
Tool Setup
From an Administrator account, complete these steps:
Click on the "Admin Menu" and select "Manage Extensibility"
Click on the "LTI Advantage" tab and select "Register Tool"
Fill in the form with the following values:
Enabled: On
Name: Riipen LTIA
Description: Riipen LTI 1.3 Advantage Tool
Domain: https://app.riipen.com
Redirect URL and Target link URI: https://app.riipen.com/ltia/launch
OpenID Connect Login URL: https://app.riipen.com/ltia/oidc
Keyset URL: https://app.riipen.com/ltia/jwks
Extensions: Deep Linking, Names and Roles, Assignments and Grades
Send Institution Role: Yes
Registration: Standard
Once you complete the tool registration, D2L will provide a Client ID, Brightspace Keyset URL, OpenID Connect Authentication Endpoint, and a Brightspace OAuth2 Access Token URL; record these for later.
Create Deployment
Click "New Deployment"
Fill in the form with the following values:
Tool: Riipen LTIA
Name: Riipen
Description: Riipen LTI 1.3 Advantage Tool
Extensions: Deep Linking, Names and Roles, Assignments and Grades
Security Settings: Enable everything except "Org Defined ID".
Classlist: Ensure "Classlist including users not known to this deployment" is checked
Configuration Settings: Enable "Open as External Resource".
Click "Create Deployment"
D2L will then provide a Deployment ID; record this for later.
Create Launch Link
Now create a basic link for Riipen that instructors can add to their course by following these steps:
Navigate to "Admin Menu > External Learning Tools > LTI Advantage",
Click "Riipen"
Click "View Links"
Click "New Link"
Enter the following:
Name: Riipen
Description: The Riipen platform
Type: Basic Launch
Create Link
Now create a link to allow instructors to create deep links directly to Riipen scored items:
Navigate to "Admin Menu > External Learning Tools > LTI Advantage",
Click "Riipen"
Click "View Links"
Click "New Link"
Fill in the form with the following values:
Name: Riipen deep link
Description: Riipen LTI 1.3 Advantage Tool
Type: Deep Linking Quicklink
Width: 1000
Height: 800
Add Riipen API
Now register Riipen as an application that has the authority to read group information (to allow instructors to import their groups from D2L into their Riipen experience):
Navigate to "Tools > Manage Extensibility > OAuth 2.0"
Click "Register an app"
Fill in the form with the following values:
Application Name: Riipen
Redirect URI: https://app.riipen.com/ltia/oauth/response
Scope: core:*:* groups:*:* enrollment:*:*
Access Token Lifetime: 1800
Prompt for user consent: No
Enable refresh tokens: No
Navigate to "Tools > Manage Extensibility > OAuth 2.0"
Click on "Riipen"
You should now. see your API client ID and API client secret; record these for later.
Enable D2L LTI Advantage integration in Riipen
The following steps can be completed by a portal administrator. Within your portal on Riipen:
Click "Settings" below the "Portal" group in the main navigation.
Select the "Integrations" tab.
Select the "LTI Advantage" option under the "Learning Tool Interoperability (LTI)" section.
Fill in all the fields with the appropriate values (see below)
Click "Submit" to finish enabling the integration.
Field | Value |
LMS Type | D2L |
Client ID | The Client ID from the LTI Advantage tool you registered. |
Deployment ID | The Deployment ID from the deployment you created |
Brightspace Keyset URL | The Brightspace Keyset URL from the LTI Advantage tool you registered. |
OpenID Connect Authentication Endpoint | The OpenID Connect Authentication Endpoint from the LTI Advantage tool you registered. |
Brightspace OAuth2 Access Token URL | The Brightspace OAuth2 Access Token URL from the LTI Advantage tool you registered. |
API client ID | The API client ID from the app you registered. |
API client secret | The API client secret from the app you registered. |
Disable the D2L LTI Advantage integration in Riipen
Click "Settings" below the "Portal" group in the main navigation.
Select the "Integrations" tab.
Select the "LTI Advantage" option under the "Learning Tool Interoperability (LTI)" section.
Click on the "Delete" button to remove the integration.
Removing the portal level D2L LTI Advantage integration will remove all D2L LTI Advantage integrations for experiences within the portal.
