Skip to content

Commit f921b42

Browse files
scollovatijc-clark
scollovati
and
jc-clark
authored
[education] add documentation for configuring Blackboard LMS (#35028)
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
1 parent 55564da commit f921b42

File tree

3 files changed

+89
-0
lines changed

3 files changed

+89
-0
lines changed

‎content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,22 @@ To configure an LMS to connect to {% data variables.product.prodname_classroom %
3232

3333
{% data reusables.classroom.supported-lmses %}
3434

35+
## Linking a Blackboard course with a classroom
36+
37+
You can link your Blackboard course with a classroom in {% data variables.product.prodname_classroom %}. For more information about Blackboard, see the [Blackboard website](https://www.anthology.com/products/teaching-and-learning/learning-effectiveness/blackboard).
38+
39+
An administrator needs to register your LMS instance with classroom before you can link an LMS course. For more information, see [AUTOTITLE](/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom#configuring-blackboard-for-github-classroom).
40+
41+
1. Sign into your **Blackboard** instance.
42+
1. Select the Blackboard course or organization to integrate with {% data variables.product.prodname_classroom %}.
43+
1. In the right sidebar on the course page, click **Books & Tools**, then click **GitHub Classroom**. Note that the name may be different if your LMS administrator named it something else when registering your LMS.
44+
1. Click **{% data variables.product.prodname_classroom %}**.
45+
1. In {% data variables.product.prodname_classroom %}, select a classroom to link with your LMS course.
46+
47+
> [!NOTE] This step might give you an error message, "Unable to launch link. The Tool Provider has been disabled by the System Administrator: {% data variables.product.prodname_classroom %}". To resolve this error, ensure that the status of the “{% data variables.product.prodname_classroom %}” tool is set to `Approved`. In the "Admin Panel," click **LTI Tool Providers**. Hover on the name next to {% data variables.product.prodname_classroom %} and click **Approve**.
48+
49+
Once your course is linked, you can import your roster from your LMS course to your classroom. For more information, see [Importing a roster from your LMS](#importing-a-roster-from-your-lms).
50+
3551
## Linking a Canvas course with a classroom
3652

3753
You can link your Canvas course with a classroom in {% data variables.product.prodname_classroom %}. For more information about Canvas, see the [Canvas website](https://www.instructure.com/canvas/).

‎content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,78 @@ Before you can connect your LMS to a classroom, an administrator for your LMS in
1717

1818
{% data reusables.classroom.supported-lmses %}
1919

20+
## Configuring Blackboard for {% data variables.product.prodname_classroom %}
21+
22+
You can register your Blackboard installation with {% data variables.product.prodname_classroom %} to enable teachers to import roster data into their classrooms. For more information about Blackboard, see the [Blackboard website](https://www.anthology.com/products/teaching-and-learning/learning-effectiveness/blackboard).
23+
24+
### Step 1. Register {% data variables.product.prodname_classroom %} Developer Keys in the Anthology Developer Portal
25+
26+
1. Sign into the [Anthology Developer Portal](https://developer.anthology.com/).
27+
1. Click on the **plus sign** in the [My Application](https://developer.anthology.com/portal/applications) page.
28+
1. Click **Manual Registration** in the dropdown menu.
29+
1. On the "Register a new application" configuration screen, set the fields to the following values.
30+
31+
| Field in the new app configuration | Value or setting |
32+
| :- | :- |
33+
| **Application Name** | `GitHub Classroom` <br/><br/>You can use any name, it will be showed only to administrators. |
34+
| **Description** | `Sync Blackboard course roster to GitHub Classroom` (or something similar) |
35+
| **Domain(s)** | `classroom.github.com` |
36+
| **Group** | Leave the default value or change it according to your institution needs. |
37+
| **My Integration supports LTI 1.3** | Enable the flag.|
38+
| **Login Initiation URL** | `https://classroom.github.com/lti1p3/openid-connect/auth` |
39+
| **Tool Redirect URL(s)** | `https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link` |
40+
| **Tool JWKS URL** | `https://classroom.github.com/.well-known/jwks.json` |
41+
| **Signing Algorithm** dropdown | `RS256` |
42+
| **Custom parameters** | Leave empty. |
43+
1. Click **Register Application**.
44+
1. The Developer Portal will show a screen that contains important information you'll need to input in the next steps of registering your instance in your Blackboard instance and in {% data variables.product.prodname_classroom %} below. Please note them in a safe place and click **Done**.
45+
1. In the table on the "My Applications" page, in the row for the GitHub Classroom application, click on the three dots and then **Manage Placements** in the dropdown menu.
46+
1. Click on the **plus sign**.
47+
1. On the "Register a new placement" configuration screen, set the fields to the following values.
48+
49+
| Field in the new placement configuration | Value or setting |
50+
| :- | :- |
51+
| **Placement Name** | `GitHub Classroom` <br/><br/>You can use any name, but if you set this to something else, be sure this is communicated to teachers. |
52+
| **Description** | `Sync Blackboard course roster to GitHub Classroom` (or something similar) |
53+
| **Type** dropdown | Course Tool |
54+
| **Allow students access** | Don't enable the flag. |
55+
| **Launch in new window** | Don't enable the flag, unless you want to offer that user experience. |
56+
| **Target link URI** | `https://classroom.github.com/context-link` |
57+
| **Icon URL** | Leave it empty or provide a static URL for the icon. If needed, later in Blackboard can be manually uploaded. |
58+
| **Custom parameters** | Leave empty. |
59+
1. Click **Register Placement**.
60+
61+
### Step 2. Register {% data variables.product.prodname_classroom %} Developer Keys in Blackboard
62+
63+
1. Sign into your **Blackboard** instance.
64+
1. In the left sidebar on the home page, click **Admin**, then click **LTI Tool Providers**.
65+
1. On the "LTI Tool Providers" page, click **Register LTI 1.3/Advantage Tool**.
66+
1. Insert the **Client ID** / **Application ID** obtained from the Developer Portal and click **Submit**.
67+
1. Blackboard will show all application data. In this page:
68+
1. Verify that **Tool Status** is `Approved`.
69+
1. Verify that **User Fields to be Sent** flags are enabled for "Role in Course", "Name", "Email Address".
70+
1. Verify that **Allow mark service access** radio button is set to "No". To enable this option, navigate to the LTI Tool Providers in the Admin Panel:
71+
- Select Manage Global Properties
72+
- Under Creation of Tool Provider Links, select radio button “Allow links to any tool provider, but require approval for each new provider”
73+
1. Verify that **Allow Membership Service Access** radio button is set to "Yes".
74+
1. Click **Submit**.
75+
76+
### Step 3. Register your developer keys with {% data variables.product.prodname_classroom %}
77+
78+
1. Go to https://classroom.github.com/register-lms.
79+
1. Fill in the following information:
80+
81+
* Under "LMS Type", choose "Other" from the dropdown menu.
82+
* "Issuer Identifier": `https://blackboard.com`
83+
* "Domain": The base URL to your Blackboard instance
84+
* "Client ID": The "Client ID" / "Application ID" obtained from the registration of the app in the Anthology Developer Portal.
85+
* "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Anthology Developer Portal.
86+
* "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Anthology Developer Portal.
87+
* "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Anthology Developer Portal.
88+
89+
1. Click **Register**.
90+
1. You should see the "Successfully registered LMS" banner at the top of the screen, which means that you've registered your LMS instance and teachers can now link their classrooms.
91+
2092
## Configuring Canvas for {% data variables.product.prodname_classroom %}
2193

2294
You can register your Canvas installation with {% data variables.product.prodname_classroom %} to enable teachers to import roster data into their classrooms. For more information about Canvas, see the [Canvas website](https://www.instructure.com/canvas/).

‎data/reusables/classroom/supported-lmses.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ Using LTI helps keep your information safe and secure. LTI is an industry-standa
77

88
{% data variables.product.company_short %} has tested and verified registration, connection and the import of roster data from the following LMSes into {% data variables.product.prodname_classroom %}.
99

10+
* Blackboard (This is a community supported option)
1011
* Canvas
1112
* Moodle
1213
* Sakai

0 commit comments

Comments
 (0)