D2L LTI 1.3 Integration - Administrator Setup

Admin Setup Instructions

1. From the administrator account for your Student Learning & Licensure (SL&L) organization, click on Settings, click Configuration Settings, then click LMS Integrations:
2. Click the Edit button (pencil icon) to the right of LMS 1 or LMS 2
3. From the LMS dropdown, select D2L

4. In the LMS URL box, enter the URL for your institution's D2L environment

   

5. In a new tab or window, log into your D2L administrator account Click the Admin Tools icon Manage Extensibility

   

6. Go to the LTI Advantage tab and click the Register Tool button

   

7. Enter the following information to create the tool:
   1. Enter the Name of your choice
   2. Enter the Description of your choice
   3. Enter the Domain: https://sll.watermarkinsights.com
   4. From your SL&L admin account, copy the Initiate login URL and paste it in the OpenID Connect Login URL field in D2L
   5. Copy the Redirection URL in SL&L and paste it in the Redirect URLs field in D2L

   6. Copy the Public keyset URL in SL&L and paste it in the Keyset URL field in D2L

      

8. In D2L, check these boxes under Extensions:
   1. Assignment and Grade Services
   2. Names and Role Provisioning Services
9. Check the box for Send Institution Role
10. Click Register
11. 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)
12. Copy the Client ID from the Registration Details in D2L, and paste it in the Client ID field in SL&L
13. Copy the Brightspace Keyset URL in D2L and paste it in the Public keyset URL field in SL&L
14. Copy the Brightspace OAuth2 Access Token URL in D2L and paste it in the Access token URL field in SL&L
15. Copy the OpenID Connect Authentication Endpoint in D2L and paste it in the Authentication request URL field in SL&L

16. 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

    

17. 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.

1. In your D2L administrator account, click the Admin Tools icon  External Learning Tools

   

2. Go to the LTI Advantage tab

3. Click the New Deployment button

   

4. Select the SL&L tool you created from the Tool dropdown
5. Enter the Name of your choice
6. Enter the Description of your choice
7. Check these boxes under Extensions:
   1. Assignment and Grade Services
   2. Deep Linking
   3. Names and Role Provisioning Services
8. Under Security Settings, ensure the following settings are selected:
   1. Org Unit Information
   2. User Information
      1. Name
         • First Name
         • Middle Name
         • Last Name
      2. Email
      3. User ID
      4. Username
      5. Org Defined ID
   3. Link Information
      1. Title
      2. Description

   4. Classlist including users not known to this deployment

      

9. Under Configuration Settings, ensure the following settings are selected:

   1. Open as External Resource
   2. Auto Create Grade Items
   3. 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

   NOTE: The assignments that get created in D2L would also have a grade item selection with the same title as the assignment. Thus, when using the Deep Linking option, the Auto Create Grade Items option should be unchecked in D2L’s LTI 1.3 integration set up with SL&L.

10. 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.

    1. 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.

       1. Click the Add Org Units button.
       2. In the upper right, under the Filter by Org Unit Type, choose Course Offering from the dropdown list
       3. Select the courses where the manual tool creation will be available for faculty
       4. Click Add

       

11. Once all Org Units have been added, click Create Deployment
12. 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)
13. Copy the Deployment ID from D2L and paste it in the Deployment ID field in SL&L

14. Return to your other D2L tab and click Done

    

15. Return to SL&L and click SAVE
16. Enable Deep Linking by following the steps listed below:

    1. Click the View Links option at the bottom of the deployment which will open the Links page in a new tab.

       

    2. Click the New Link button on the Links page.

       

    3. Enter a title of your choice in the box for the Name field (it would be good to provide a title that indicates that the link corresponds to Deep Linking or that indicates that this link enables bulk creation and linking of D2L assignments with SL&L activities).
    4. For the URL field, enter: https://sll.watermarkinsights.com/via/lti/v1p3/deeplink
    5. For the Type field, select the value Deep Linking Quicklink.
    6. Once you select the Deep Linking Quicklink value for the Type field, a couple of boxes for Width (default value set to 800) and Height (default value set to 600) will be displayed.

       1. These are the dimensions of the dialog in which the Deep Linking workflow gets rendered in D2L. The ideal values that ensure that the dialog displays correctly on different screen-sizes are: Width = 1450 and Height = 600.

    7. Click Save

Using Deep Linking to Bulk Create and Link D2L Assignments to SL&L Activities

Once you have enabled Deep Linking for your LTI 1.3 integration between D2L and SL&L, your D2L Course Admins and D2L Course Instructors can begin to use it to bulk create and link D2L assignments based on SL&L activities.

1. The D2L Course Admins and D2L Course Instructors can access the Deep Linking workflow from their D2L Course from the Existing Activities menu for any module in the Content area (you can reach out to your D2L Administrator to know about the title of the Deep Linking access point).
2. Once you access the Deep Linking workflow option, a pop up will be displayed where in you will be able to view a paginated list of activities (20 activities per page) from the course sections that you have access to in SL&L.

   1. If you are an administrator in SL&L, you will see a list of activities from open course sections that belong to the hierarchy nodes to which you have access.

   2. If you are an instructor in SL&L, you will see a list of activities from the open course sections for which you an the instructor.

   3. The list only includes activities that have been published, but are not linked to any LMS assignment.

3. You can filter the list of activities in the following ways:

   1. By searching based on Activity Title, Course Code, and Section Name.

   2. Using the View drop-down: This drop-down enables you to filter the list of activities based on 3 options.

      1. Activities from all sections: Selecting this option displays a list of published, but unlinked activities from all open course sections that you have access to in SL&L.

         NOTE: If you do not have access to any open course sections as an SL&L Administrator or an SL&L Course Instructor OR if no published activities have been created in the open course sections that you have access to as an SL&L Administrator or an SL&L Course Instructor OR if all activities from the open course that you have access to as an SL&L Administrator or an SL&L Course are already linked to an LMS assignment, an empty state message will be displayed.

      2. Activities from matched sections: Selecting this option displays a list of published, but unlinked activities from course sections that you have access to in SL&L, which match the D2L Course (through which you have accessed the Deep Linking workflow page) based on Section ID or Section Name.

         NOTE: From among the open course sections to which you have access as an SL&L Administrator or an SL&L Course Instructor, if there are no course sections that match the D2L course (through which you have accessed the Deep Linking workflow page) based on Section ID or Section Name OR if no published activities have been created in the course sections that match the D2L course (through which you have accessed the Deep Linking workflow page) based on Section ID or Section Name OR if all published activities from the course sections that match the D2L course (through which you have accessed the Deep Linking workflow page) based on Section ID or Section Name are already linked to an LMS assignment, an empty state message will be displayed if you select the Activities from matched sections option.

      3. Selected Activities: Selecting this option displays a list of activities that you have selected after accessing the Deep Linking workflow page.

         NOTE: If you have not made any selections on the Deep Linking workflow page, an empty state message will be displayed if you select the Selected Activities option.

   NOTE: When you access the Deep Linking workflow page, if there is an SL&L Course Section or Course Sections that match the D2L Course (through which you have accessed the Deep Linking workflow page) based on Section ID or Section Name, the list will display activities from the matched Course Section or Course Sections by default i.e. the View drop-down on the page will default to the option Activities from matched sections.

4. Search and select the activities that you would like to create and link as D2L Assignments.
5. Click the Add Activities button.