Admin Setup Instructions
-
From the administrator account for your Student Learning & Licensure (SL&L) organization, click on Settings, click Configuration Settings, then click LMS Integrations:
- Click the Edit button (pencil icon) to the right of LMS 1 or LMS 2
- From the LMS dropdown, select D2L
-
In the LMS URL box, enter the URL for your institution's D2L environment
- In a new tab or window, log into your D2L administrator account
-
Click the Admin Tools icon Manage Extensibility
-
Go to the LTI Advantage tab and click the Register Tool button
-
Enter the following information to create the tool:
- Enter the Name of your choice
- Enter the Description of your choice
- Enter the Domain: https://sll.watermarkinsights.com
- From your SL&L admin account, copy the Initiate login URL and paste it in the OpenID Connect Login URL field in D2L
- Copy the Redirection URL in SL&L and paste it in the Redirect URLs field in D2L
-
Copy the Public keyset URL in SL&L and paste it in the Keyset URL field in D2L
-
In D2L, check these boxes under Extensions:
- Assignment and Grade Services
- Names and Role Provisioning Services
- Check the box for Send Institution Role
- Click Register
- Once the new tool is registered, the Registration Details will be displayed (Note: you may also view these details by clicking on the LTI tool)
- Copy the Client ID from the Registration Details in D2L, and paste it in the Client ID field in SL&L
- Copy the Brightspace Keyset URL in D2L and paste it in the Public keyset URL field in SL&L
- Copy the Brightspace OAuth2 Access Token URL in D2L and paste it in the Access token URL field in SL&L
- Copy the OpenID Connect Authentication Endpoint in D2L and paste it in the Authentication request URL field in SL&L
-
Copy the Issuer in D2L and paste it in the Issuer field in SL&L
*Please make sure there are no trailing spaces or special characters (such as a "/") at the end of the URL - Click Done in D2L
Tool Deployment
Next you will create a Deployment for the new tool that was just created, either from the Creation screen or the Edit Tool screen. Deployments allow sharing of registered tools in D2L to specific org units or descendants of parent org units.
Registered tools can have multiple deployments. Each individual deployment can be unique, supporting the ability for different LTI extensions and Security Settings per deployment. Links can be created for use in the org unit(s) from the Deployment, or users with permissions can create individual links at the org
level that link to the deployment.
-
In your D2L administrator account, click the
Admin Tools
icon External Learning Tools
- Go to the LTI Advantage tab
-
Click the New Deployment button
- Select the SL&L tool you created from the Tool dropdown
- Enter the Name of your choice
- Enter the Description of your choice
-
Check these boxes under Extensions:
- Assignment and Grade Services
- Names and Role Provisioning Services
-
Under Security Settings, ensure the following
settings
are selected:
- Org Unit Information
-
User Information
-
Name
- First Name
- Middle Name
- Last Name
- User ID
- Username
- Org Defined ID
-
Name
-
Link Information
- Title
- Description
-
Classlist including users not known to this deployment
-
Under Configuration Settings, ensure the following
settings
are selected:
- Open as External Resource
- Auto Create Grade Items
Note: These two settings (i) allow the SL&L assignment to be opened in a new tab; (ii) automatically create and associate a grade book item with the SL&L external tool
-
Click the Add Org Units button. Search for the topmost unit and enable “This org unit and all descendants”. This will allow the tool to be available at the course. It will allow faculty to create unique individual external tools from within a course.
NOTE: This will allow faculty to create unique individual external tools from within a course. The external tool created by faculty members will be automatically associated with the SL&L external tool.
Alternatively, if you would like the tool to only be available for tool creation within certain courses, complete the following steps.
- Click the Add Org Units button.
- In the upper right, under the Filter by Org Unit Type, choose Course Offering from the dropdown list
- Select the courses where the manual tool creation will be available for faculty
- Click Add
-
Once all Org Units have been added, click
Create Deployment
- Once the Deployment is created, D2L will display a unique Deployment ID that is needed to complete the registration on the SL&L side (Note: you can also view the Deployment ID by clicking on the new Deployment)
- Copy the Deployment ID from D2L and paste it in the Deployment ID field in SL&L
-
Return to your other D2L tab and click Done\
- Return to SL&L and click SAVE