English Español Français
Go to YuJa
  1. YuJa Help Center
  2. Engage Student Response System
  3. D2L Brightspace
  4. Administrator

Integrating Engage into D2L Brightspace Using LTI 1.3

Avatar
YuJa
  • Updated

Admins can integrate Engage into their D2L Brightspace Learning Management System (LMS). The integration allows polls to be created, published, and graded directly to D2L Brightspace courses and viewed by admins, instructors, and students. If you have any questions regarding the steps in this process, please contact your dedicated Account Manager.

Registering Engage to D2L Brightspace

To integrate Engage as an external learning tool, it must first be registered to your D2L Brightspace learning environment. 

  1. Log in to D2L Brightspace as an admin.
  2. Click the Gear button.
  3. Select Manage Extensibility.
    D2L Brightspace Manage Extensibility
     
  4. Click LTI Advantage > Register Tool.
    D2L Brightspace register tool
     
  5. Select Standard.
    D2L Brightspace select Standard
     
  6. Enter the information as shown below, and then click Register.
    D2L Brightspace register information
    • Name: Any name you choose that helps identify the YuJa Engage Tool.
    • Domain: The domain provided by your Account Manager. 
    • Redirect URLs: The redirect URLs provided by your Account Manager.
    • OpenID Connect Login URL: The OpenID Connect Login URL provided by your Account Manager.
    • Target Link URL: The target link URL provided by your Account Manager.
    • Keyset URL: The Keyset URL provided by your Account Manager.
    • Extensions: Select these check boxes:
      • Assignment and Grade Services
      • Deep Linking 
      • Names and Role Provisioning Services 
    • Roles: Select the Send Institution Role check box.
    • Custom Parameters
      • Name: person_sourcedid, Value: $Person.email.primary
      • Name: lis_person_sourcedid, Value: lti_login_id=$User.username
  7. In the list of LTI Advantage tools, select YuJa Engage.
    D2L Brightspace select YuJa Engage LTI Advantage tool
  8. In the Brightspace Registration Details section, make a note of the details. They will be required when configuring the Engage API.
    D2L Brightspace Registration Details

Deploying Engage to D2L Brightspace

Once you have registered Engage with your institution's D2L Brightspace environment, it must be deployed to allow courses to access it.

  1. On the External Learning Tools page, select the LTI Advantage tab.
  2. Click New Deployment.
    D2L Brightspace New Deployment
  3. Enter the information as shown below, and then click Create Deployment.
    D2L Brightspace Create Deployment
    • Tool: Select the YuJa Engage tool registered in Registering Engage to D2L Brightspace.
    • Name: Any name you choose that helps identify the YuJa Engage Tool.
    • Extensions: Select these check boxes:
      • Assignment and Grade Services 
      • Deep Linking 
      • Names and Role Provisioning Services 
    • Security Settings: Select these check boxes:
      • Org Unit Information
      • User Information 
        • Name
          • First Name
          • Middle Name 
          • Last Name 
        • Email
        • User ID
        • Username
        • Org Defined Id
      • Link Information 
        • Title
        • Description 
    • Custom Parameters
      • Name: person_sourcedid, Value: $Person.email.primary
      • Name: lis_person_sourcedid, Value: lti_login_id=$User.username
    • Add Org Units: Add courses you want to enable Engage for. You can edit the deployment tool at any time to add additional courses. 
  4. In the Brightspace Registration Details modal, make a note of the Deployment Id. It will be required when configuring the Engage API.
  5. Click View Links. You will be required to create two links: Basic Launch and Deep Linking Quicklink.
    D2L Brightspace create links
  6. Click New Link.
    D2L Brightspace create new link
     
  7. Enter the information as shown below and click Save and Close.

    D2L Brightspace enter the link information
     
    • Name: Any name of your choice to identify the Basic Launch link.
    • URL: The URL provided by your Account Manager.
    • Type: Select Basic Launch. 
  8. Click New Link again to add the Deep Linking Quicklink.
  9. Enter the information as shown below.
    D2L Brightspace enter the Deep Linking Quicklink information
    • Name: Any name of your choice to identify the Basic Launch link.
    • URL: The URL provided by your Account Manager.
    • Type: Select Deep Linking Quicklink.
  10. Click Save and Close.

Configuring the Engage API 

Once you have deployed Engage to D2L Brightspace, you will be required to configure the Engage API to allow for data transfer between D2L Brightspace and Engage. Make sure your Account Manager has provided you with your ISS, OIDC Endpoint, JWKS Endpoint, and OAuth2 Token Endpoint.

  1. Log in to Engage as an admin using your zone URL.
    • Example: https://www.evergreen.engage.yuja.com
  2. In the side navbar, select Integrations.
    Engage Integrations
     
  3. In the Choose Integration Type drop-down menu, select LMS LTI 1.3.
  4. In the Select LMS drop-down menu, select D2L.
  5. In the API Configuration section, enter the information as shown below.
    Engage API configuration information
    • ISS: Issuer
    • Client Id: Client Id
    • OIDC Endpoint: OpenID Connect Authentication Endpoint
    • JWKS Endpoint: Brightspace Keyset URL
    • OAuth2 Token Endpoint: Brightspace OAuth2 Access Token URL
    • Deployment Id: The deployment Id as noted in Deploying Engage to D2L Brightspace.
  6. In the User Configuration and Course Configuration sections, turn on the toggles.
    Engage User and Course Configuration
  7. Click Save Changes.
    Engage save configuration

Integrating Course Roster Sync

Once the integration is complete, you can enable course roster sync to automatically update the Engage roster with a list of students in a specified course. Make sure you have received a trusted URL from your Account Manager. 

  1. Log in to D2L Brightspace as an admin.
  2. Click the Gear button.
  3. Select Manage Extensibility.
    D2L Brightspace Manage Extensibility
     
  4. In the ID Key Authorization tab, click Register an App.
    D2L Brightspace Register an App
     
  5. Enter the information as shown below.
    D2L Brightspace enter the app information
     
    • Application Name: Any name you choose that helps identify the application.
    • Trusted URL: The trusted URL provided by your Account Manager.
    • Enable this application: Select the I accept the Non-Commercial Developer Agreement check box.
  6. Click Register Application.
    D2L Brightspace Register Application
     
  7. Make a note of the Application ID and Application Key. They will be required to complete the course roster integration.
    D2L Brightspace Make note of Application ID and Application Key
  8. Click the Gear button.
  9. Select Config Variable Browser.
    D2L Brightspace Config Variable Browser
  10. In the side navbar, select Tools > Classlist.
  11. In the table, select DisplayEmail.
    D2L Brightspace Classlist
  12. Click Add Value.
    D2L Brightspace Add Value
     
  13. Click Select Org Unit to select the organization from which you would like to retrieve emails.
    D2L Brightspace select the organization
  14. Set the Value to on.
    D2L Brightspace select the value
     
  15. Click Save.
    D2L Brightspace save the organization information
     
  16. In the side navbar, select Tools > Classlist.
  17. In the table, select DisplayUsername.
    D2L Brightspace DisplayUsername
     
  18. Click Add Value.
    D2L Brightspace add DisplayUsername value
     
  19. Click Select Org Unit to select the Org from which you would like to retrieve usernames.
    D2L Brightspace select organization to retrive usernames
  20. Set the Value to On.
    D2L Brightspace select values
     
  21. Click Save.
    D2L Brightspace save organization values
  22. Log in to Engage.
  23. In the side navbar, select Integrations.
    Engage Integrations
     
  24. In the Choose Integration Type drop-down menu, select LMS - API.
  25. In the Select LMS drop-down menu, select D2L.
    Engage Integration Type and Select LMS
     

  26. Enter the API Access information as shown below.

    Engage LMS add App Key

  27. Adjust any additional Linkage Settings as shown below.
    Engage adjust Linkage Settings
    • D2L Course: Select D2L Course ID.
    • D2LUsers: Select D2L User ID or Primary Email.
    • Use Email as Backup Field: Turn on the Use Email as Backup Field toggle.
       
  28. Click Save Changes.
    Engage save information
     

Adding Engage to a Course

Once the integration process is complete, you can add Engage to the Navbar for any course created in the Engage deployment tool. For more information, please refer to step 4 in Deploying Engage to D2L Brightspace.

  1. Log in to D2L Brightspace as an admin and select your course.
  2. Hover over the navbar and click the Navbar Options button > Edit This Navbar.
    D2L Brightspace Edit This Navbar
     
  3. Click Add Links. 
    D2L Brightspace add navbar links
     
  4. Click Create Custom Link.
    D2L Brightspace add Custom Link
     
  5. Enter a Name for the custom link and click Insert Quicklink.
    D2L Brightspace add Custom Link information
     
  6. Click External Learning Tools.
    D2L Brightspace External Learning Tools
     
  7. Locate and select the YuJa Engage LTI link.
    D2L Brightspace add Engage LTI link
     
  8. In the Behavior drop-down menu, select Same window. 
    D2L Brightspace edit Behavior
     
  9. Click Create.
    D2L Brightspace create behavior
     
  10. Click the More drop-down menu > YuJa Engage.
    D2L Brightspace add YuJa Engage
     
  11. Select the YuJa Engage LTI link.
  12. Create and release a poll or attendance within D2L Brightspace.
    D2L Brightspace create an Engage poll
     

 

Related articles

Contact Support