Microsoft O365 Admin

To successfully integrate your Blackboard Learn instance with Microsoft Teams classes, make sure the Blackboard application is approved for access within your Microsoft Azure tenant. This is a process that your institution’s M365 Global Admin needs to complete.

This process can be done either before or after you have configured the LTI applications in your Blackboard Learn Instance.

Before configuring LTI applications

If you choose to approve the Blackboard Teams classes Azure app before configuring the LTI integrations, you'll need to redirect to the Microsoft Identity Platform Admin Consent Endpoint. The URL is shown below:

https://login.microsoftonline.com/{tenant}/adminconsent?client_id=2d94989f-457a-47c1-a637-e75acdb11568

You’ll replace {Tenant} with your specific institutional Microsoft Azure tenant ID. You will need to know your Microsoft Tenant ID  to enable this integration in Blackboard Learn.

Learn more on How to find your tenant

 

As a Learn Admin you will need to register 2 LTI 1.3 integration apps within your test environment:

  • The Blackboard Learn Class Teams integration to support the roster sync.
  • The Microsoft Class Teams LTI tool.
  1. Make a note of the following LTI Client ID’s for both Apps:
    • Blackboard - f1561daa-1b21-4693-ba90-6c55f1a0eb41
    • Microsoft - 027328b7-c2e3-4c9e-aaa1-07802dae6c89
  2. Access the Admin Panel and under Integrations locate LTI Tool Providers.
  3. Select Register LTI1.3/Advantage Tool
  4. Enter in the first of the Client ID’s provided (either Blackboard or Microsoft) and select Submit.
  5. All relevant fields will be pre-populated for you. Go through and review these settings. Make sure the tool status is marked as Approved.
  6. Make sure all institution policies are selected including role in course, name, and email address. Also, Select allow grade service access and Allow membership service access.
  7. Scroll down and select Submit at the bottom of the page.
  8. Repeat steps 4 and 5 to register the second of the LTI apps within your environment.

After configuring LTI applications

  1. From the Administrator Panel, navigate to Tools and Utilities and select Microsoft Teams Integration Admin.
  2. Select Enable Microsoft Teams.
  3. Add your Microsoft Tenant ID into the available text field.
  4. If the app has pre-consent, it will show a small checkmark. If the checkmark appears select Submit.
  5. If consent hasn’t been approved, follow the steps described to Generate the URL for consent and send it to the M365 Global Admin for approval.
  6. Once you have confirmation of approval, select the Retry button to confirm.
  7. Once confirmed, select Submit.

Requirements

The Microsoft Teams classes integration is available for Ultra Course View courses only. Your institution needs to complete these requirements to use it:

  • Have Blackboard Learn SaaS with Ultra Base Navigation enabled
  • Enable LTI for use in courses: Go to the Administrator Panel > LTI Tool Providers > Manage Global Properties. Then, select LTI Enabled in Courses, and optionally, select Enabled in Organizations. Select Submit.
  • Must have LTI configured
  • Add Blackboard Learn Teams Classes LTI Integration
  • Add Microsoft Teams classes LTI 1.3 Tool
  • Add the REST API Tool and Cross-Origin Resource Sharing
  • Configure and approve Microsoft Teams classes Integration

Setting up the REST application and Cross Origin Resource Sharing

Alongside setting up the LTI integrations, the Learn admin will also need to configure the REST Application and also the Cross Origin Resource Sharing configuration.

Add the REST API tool

  1. On the Administrator Panel, navigate to Integrations and select Rest API Integrations.
  2. Select Create Integration.
  3. In the Application ID field, type or copy and paste this ID: f1561daa-1b21-4693-ba90-6c55f1a0eb41
  4. Type a user for this integration. This user will be the one with home API access from which the application is associated.
  5. Select Submit.

Add the Cross-Origin Resource Sharing

  1. From the Administrator Panel, navigate to Integrations and select Cross-origin Resource Sharing.
  2. Select Create Configuration.
  3. In the Origin field, type of copy and paste this URL: https://bb-ms-teams-ultra-ext.api.blackboard.com
  4. In the Allowed Headers field, type Authorization.
  5. Set Available to Yes.
  6. Select Submit.

Enabling class Teams in Blackboard Learn

Once you have enabled the LTI tools, your next step will be to set up the Microsoft Class Teams integration from your own Microsoft Office 365 tenant. You can do this by following these steps:

Learn Admin

  1. On the Learn Admin screen, under Tools and Utilities select Microsoft Teams Integration Admin.
  2. Select the checkbox on Enable Microsoft Teams and insert your tenant ID as referenced in the precious explained Microsoft O365 Admin section.

    Please note that you won’t be able to save the settings until the application has been approved by the O365 admin. Refer to the previous Microsoft O365 Admin section.

  3. Select Submit and save the settings to enable Teams globally for all your Learn Ultra courses, once the global O365 admin has approved the Blackboard Teams application in your Microsoft tenant.

Institutional Email and why it is useful

A separate Help section on changing or using the institutional email, which defaults to the person email for most SIS formats, shows you how you can change it to your own fields as necessary.

The Microsoft Teams integration relies on the institutional email to map to the AAD UPN. Thus, it requires to be set for every user to synchronize. If it isn't set, then the user may not appear in the corresponding team and errors can occur.

Learn more on Institutional Email