Skip to content

Commit a640aef

Browse files
scollovatiscollovati
committed
add guide for Github Classroom LTI integration with Blackboard LMS
1 parent fd8f435 commit a640aef

File tree

3 files changed

+84
-0
lines changed

3 files changed

+84
-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: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,19 @@ 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 rigth sidebar on the course page, click **Books & Tools**, then click **GitHub Classroom**. Note that the name may be different if your LMS admin named it something else when registering your LMS.
44+
1. Clicking the **GitHub Classroom** button will launch you into {% data variables.product.prodname_classroom %}, where you can select a classroom to link with your LMS course.
45+
46+
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)."
47+
3548
## Linking a Canvas course with a classroom
3649

3750
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: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,76 @@ 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+
### 1. Register {% data variables.product.prodname_classroom %} Developer Keys in the Blackboard Developer Portal
25+
26+
1. Sign into the [Blackboard 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/>**Note**: 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 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/>**Note**: 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+
### 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** 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".
71+
1. Verify that **Allow Membership Service Access** radio button is set to "Yes".
72+
1. Click **Submit**.
73+
74+
### 3. Register your developer keys with {% data variables.product.prodname_classroom %}
75+
76+
1. Go to https://classroom.github.com/register-lms.
77+
1. Fill in the following information:
78+
79+
* Under "LMS Type", choose "Other" from the dropdown menu.
80+
* "Issuer Identifier": `https://blackboard.com`
81+
* "Domain": The base URL to your Blackboard instance
82+
* "Client ID": The "Client ID" obtained from the registration of the app in the Blackboard Developer Portal.
83+
* "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Blackboard Developer Portal.
84+
* "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Blackboard Developer Portal.
85+
* "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Blackboard Developer Portal.
86+
87+
1. Click **Register**.
88+
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.
89+
2090
## Configuring Canvas for {% data variables.product.prodname_classroom %}
2191

2292
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
1011
* Canvas
1112
* Moodle
1213
* Sakai

0 commit comments

Comments
 (0)