Getting started with Brightspace Course Connector for Microsoft Teams

The Brightspace Course Connector for Microsoft Teams® is available for purchase and is set up as a Learning Tools Interoperability (LTI®) integration. It allows administrators and instructors to seamlessly create teams based on a course in Brightspace Learning Environment. This integration automatically synchronizes the class list with Microsoft Teams daily. Administrators can also manually trigger a class list synchronization on-demand for any course from the ShuffleExchange platform.

 

Once a course is connected, a link on the course homepage provides access to your Teams environment from within Brightspace Learning Environment. This integration provides enhanced communication and collaboration between instructors and learners.

 

Figure: The Course Connector for Microsoft Teams widget on a homepage

This guide outlines the process for integrating your Microsoft Teams platform with your Brightspace Learning Environment and upgrading to the latest version of Brightspace Course Connector.

Integrate Microsoft Teams platform with Brightspace Learning Environment

This setup process involves the following:

  1. Register a new LTI Advantage tool for Course Connector in Brightspace Learning Environment. This workflow also includes configuring an LTI launch of Course Connector as a basic launch widget and making it available to the appropriate Org Units.
  2. Register a new Valence API application for Course Connector in Brightspace Learning Environment.
  3. Obtain student and instructor roles.
  4. Register the ShuffleExchange LTI tool.

Register a new LTI Advantage tool for Course Connector in Brightspace Learning Environment

This section describes the steps to create a widget on the course homepage. You require administrator privileges in your Brightspace Learning Environment.

  1. Log in to Brightspace Learning Environment.
  2. From the Admin Tools menu, click Manage Extensibility.


    Figure: The Admin Tools menu

  3. On the LTI Advantage tab, click Register Tool.
  4. On the Register Tool page, specify the following details:

    • Name: Your preferred name for the tool. For example, Microsoft Teams.
    • Domain:
      • Canada - https://teams-ca.shuffleexchange.com
      • EMEA - https://teams-eu.shuffleexchange.com
      • US - https://teams-us.shuffleexchange.com
      • Australia - https://teams-au.shuffleexchange.com
      • Singapore - https://teams-asia.shuffleexchange.com
    • Redirect URLs:
      • Canada - https://teams-ca.shuffleexchange.com/teams/portal
      • EMEA - https://teams-eu.shuffleexchange.com/teams/portal
      • US - https://teams-us.shuffleexchange.com/teams/portal
      • Australia - https://teams-au.shuffleexchange.com/teams/portal
      • Singapore - https://teams-asia.shuffleexchange.com/teams/portal
    • OpenID Connect Login URL:
      • Canada - https://teams-ca.shuffleexchange.com/lti/OidcLogin
      • EMEA - https://teams-eu.shuffleexchange.com/lti/OidcLogin
      • US - https://teams-us.shuffleexchange.com/lti/OidcLogin
      • Australia - https://teams-au.shuffleexchange.com/lti/OidcLogin
      • Singapore - https://teams-asia.shuffleexchange.com/lti/OidcLogin
    • Keyset URL:
      • Canada - https://teams-ca.shuffleexchange.com/lti/jwks
      • EMEA - https://teams-eu.shuffleexchange.com/lti/jwks
      • US - https://teams-us.shuffleexchange.com/lti/jwks
      • Australia - https://teams-au.shuffleexchange.com/lti/jwks
      • Singapore - https://teams-asia.shuffleexchange.com/lti/jwks
  5. Leave the remaining fields with their default values and click Register. Your registration details appear.


    Figure: LTI Advantage tool registration details

  6. Make note of your Client Id and Issuer URL.
  7. To configure the LTI launch of Course Connector, click View Deployments.
  8. On the LTI Advantage tab, click New Deployment.
  9. To make the tool available to all Org Units, on the Deploy Tool page, specify the following details:
    • Tool: Select the tool name you specified in step 4 above.
    • Name: Your preferred name for the deployment. For example, Microsoft Teams.
    • Security Settings: Select Org Unit Information.
    • Make tool available to: Click Add Org Units and select all the course offerings where the tool should be made available.
  10. Leave the remaining fields with their default values and click Register. Your deployment registration details appear.


    Figure: Deployment registration details

  11. Make note of the Deployment Id.
  12. To configure the widget, click View Links.
  13. Click New Link and provide the following details:
    • Name: Your preferred name for the tool. For example, Microsoft Teams.
    • URL:
      • Canada - https://teams-ca.shuffleexchange.com/teams/portal
      • EMEA - https://teams-eu.shuffleexchange.com/teams/portal
      • US - https://teams-us.shuffleexchange.com/teams/portal
      • Australia - https://teams-au.shuffleexchange.com/teams/portal
      • Singapore - https://teams-asia.shuffleexchange.com/teams/portal
    • Type: Basic Launch Widget, Height: 300.
  14. Leave the remaining fields with their default values and click Save and Close.

Register a new Valence API application for Course Connector in Brightspace Learning Environment

The Brightspace Course Connector for Microsoft Teams uses a Valence API to access course, section, and enrollment information. This section details the steps to create a Valence application and credentials to access Brightspace APIs. You require administrator privileges in your Brightspace Learning Environment.

  1. Log in to Brightspace Learning Environment.
  2. From the Admin Tools menu, click Manage Extensibility.
  3. On the ID Key Authorization tab, click Register an App.
  4. On the Register an Application page, provide the following details:
    • Application Name: Your preferred name for the tool. For example, Microsoft Teams.
    • Trusted URL: https://apitesttool.desire2learnvalence.com/index.php
    • Select the I accept the Non-Commercial Developer Agreement check box.
  5. Leave the remaining fields with their default values and click Register Application. Your registration details appear.


    Figure: Valence API registration details

  6. Make note of the Application ID and Application Key.
  7. In incognito mode, navigate to the API Test Tool page and specify the following details:
    • Host: Your Brightspace Learning Environment host URL without https or a trailing slash. For example, d2l.com
    • Port: 443
    • App ID: Application ID from Step 6 above.
    • App Key: Application Key from Step 6 above.
  8. Click Authenticate. An access confirmation message appears.


    Figure: Access confirmation message

  9. To populate the User ID and User Key, click Continue.
  10. Make note of the User ID and User Key.

Obtain student and instructor roles

To ensure the right users are created as team owners and members in Microsoft Teams, ShuffleExchange, the partner platform, requires the associated role IDs mapped to course instructors and learners.

To obtain instructor and learner role IDs:

  1. Log in to Brightspace Learning Environment.
  2. From the Admin Tools menu, click Roles and Permissions.
  3. Click on a role that represents either the student or instructor and in the browser URL filed, make note of the role ID.
  4. Repeat Step 3 for each role and note down all the role IDs for students and instructors separately.

Register the ShuffleExchange LTI Tool

The ShuffleExchange (SE) LTI Tool requires the details captured in the earlier steps to enable the Teams integration with your Brightspace Learning Environment instance. Contact the ShuffleExchange Team to configure your credentials and then follow the steps below to configure your LTI Tool.

  1. In incognito mode, navigate to
    1. https://teams-ca.shuffleexchange.com (for Canada)
    2. https://teams-eu.shuffleexchange.com (for EMEA)
    3. https://teams-us.shuffleexchange.com (for US)
    4. https://teams-au.shuffleexchange.com (for Australia)

    5. https://teams-asia.shuffleexchange.com (for Singapore)
      and log in with your credentials supplied to you by your D2L partner after purchasing this add-on.

  2. Enter the following details:
  3. Click Save.

You can now add the Brightspace Course Connector widget for Microsoft Teams to your course homepage.

Miscellaneous / Optional Settings

Below the core configuration fields are Miscellaneous settings that help administrators configure optional components:

Miscellaneous options for Brightspace Course Connector for Microsoft Teams

  • Brightspace tab: Enter a custom name for the tab that appears within Microsoft Teams. The default tab name is Brightspace.
  • Group Email Prefix: Optionally, specify a prefix when group emails are created to ensure uniqueness and discoverability.
  • Group Mail Prefix: Enter a prefix to appear before group mail
  • Course Name Format: Add a new prefix or suffix, using the indicated format in the field
  • Name Blocked Words: words that should be avoided and removed if included in the team name at time of creation

Instructors can add the Brightspace Course Connector widget for Microsoft Teams to course homepages.

To add the Brightspace Course Connector widget for Microsoft Teams to your course homepage:

  1. From your course homepage, select Course Admin > Homepages.
  2. Select the homepage you want to edit.
  3. In the Widgets area, click Add Widgets.
  4. Select Microsoft Teams and click Add.
  5. Click Save and Close.

Upgrade Brightspace Course Connector

  1. Log into the ShuffleExchange platform.
  2. From the environment selector in the upper right corner of the screen, select the environment to upgrade.
  3. On the left navigation pane, click Settings and then click Connect.
    • A Microsoft 365 global administrator must grant consent to install the new Brightspace Teams Course Connector application.
  4. Once the application is installed, click Save.
  5. Repeat the above upgrade steps for each environment in your ShuffleExchange account.
  6. Once all upgrades are complete, a Microsoft 365 administrator can safely uninstall the following:
    • ShuffleTeamsApp (the previous version of the Course Connector application).
    • The previously created Microsoft 365 service user.