From a640aef8878ebaf8bfcc6911bd5d16813082570c Mon Sep 17 00:00:00 2001 From: scollovati <20740642+scollovati@users.noreply.github.com> Date: Thu, 17 Oct 2024 15:48:31 +0200 Subject: [PATCH 1/5] add guide for Github Classroom LTI integration with Blackboard LMS --- ...management-system-course-to-a-classroom.md | 13 ++++ ...management-system-with-github-classroom.md | 70 +++++++++++++++++++ data/reusables/classroom/supported-lmses.md | 1 + 3 files changed, 84 insertions(+) diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md index 7a12a921f5fc..2a01c3aa4625 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md @@ -32,6 +32,19 @@ To configure an LMS to connect to {% data variables.product.prodname_classroom % {% data reusables.classroom.supported-lmses %} +## Linking a Blackboard course with a classroom + +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). + +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)." + +1. Sign into your **Blackboard** instance. +1. Select the Blackboard course or organization to integrate with {% data variables.product.prodname_classroom %}. +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. +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. + +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)." + ## Linking a Canvas course with a classroom 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/). diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md index 6043154c9622..39796475c2a6 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md @@ -17,6 +17,76 @@ Before you can connect your LMS to a classroom, an administrator for your LMS in {% data reusables.classroom.supported-lmses %} +## Configuring Blackboard for {% data variables.product.prodname_classroom %} + +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). + +### 1. Register {% data variables.product.prodname_classroom %} Developer Keys in the Blackboard Developer Portal + +1. Sign into the [Blackboard Developer Portal](https://developer.anthology.com/). +1. Click on the **plus sign** in the [My Application](https://developer.anthology.com/portal/applications) page. +1. Click **Manual Registration** in the dropdown menu. +1. On the "Register a new application" configuration screen, set the fields to the following values. + + | Field in the new app configuration | Value or setting | + | :- | :- | + | **Application Name** | `GitHub Classroom`

**Note**: You can use any name, it will be showed only to administrators. | + | **Description** | `Sync Blackboard course roster to GitHub Classroom` (or something similar) | + | **Domain(s)** | `classroom.github.com` | + | **Group** | Leave the default value or change it according to your institution needs. | + | **My Integration supports LTI 1.3** | Enable the flag.| + | **Login Initiation URL** | `https://classroom.github.com/lti1p3/openid-connect/auth` | + | **Tool Redirect URL(s)** | `https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link` | + | **Tool JWKS URL** | `https://classroom.github.com/.well-known/jwks.json` | + | **Signing Algorithm** dropdown | `RS256` | + | **Custom parameters** | Leave empty. | +1. Click **Register Application**. +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**. +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. +1. Click on the **plus sign**. +1. On the "Register a new placement" configuration screen, set the fields to the following values. + + | Field in the new placement configuration | Value or setting | + | :- | :- | + | **Placement Name** | `GitHub Classroom`

**Note**: You can use any name, but if you set this to something else, be sure this is communicated to teachers. | + | **Description** | `Sync Blackboard course roster to GitHub Classroom` (or something similar) | + | **Type** dropdown | Course Tool | + | **Allow students access** | Don't enable the flag. | + | **Launch in new window** | Don't enable the flag, unless you want to offer that user experience. | + | **Target link URI** | `https://classroom.github.com/context-link` | + | **Icon URL** | Leave it empty or provide a static URL for the icon. If needed, later in Blackboard can be manually uploaded. | + | **Custom parameters** | Leave empty. | +1. Click **Register Placement**. + +### 2. Register {% data variables.product.prodname_classroom %} Developer Keys in Blackboard + +1. Sign into your **Blackboard** instance. +1. In the left sidebar on the home page, click **Admin**, then click **LTI Tool Providers**. +1. On the "LTI Tool Providers" page, click **Register LTI 1.3/Advantage Tool**. +1. Insert the **Client ID** obtained from the Developer Portal and click **Submit**. +1. Blackboard will show all application data. In this page: + 1. Verify that **Tool Status** is "Approved". + 1. Verify that **User Fields to be Sent** flags are enabled for "Role in Course", "Name", "Email Address". + 1. Verify that **Allow mark service access** radio button is set to "No". + 1. Verify that **Allow Membership Service Access** radio button is set to "Yes". +1. Click **Submit**. + +### 3. Register your developer keys with {% data variables.product.prodname_classroom %} + +1. Go to https://classroom.github.com/register-lms. +1. Fill in the following information: + + * Under "LMS Type", choose "Other" from the dropdown menu. + * "Issuer Identifier": `https://blackboard.com` + * "Domain": The base URL to your Blackboard instance + * "Client ID": The "Client ID" obtained from the registration of the app in the Blackboard Developer Portal. + * "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Blackboard Developer Portal. + * "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Blackboard Developer Portal. + * "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Blackboard Developer Portal. + +1. Click **Register**. +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. + ## Configuring Canvas for {% data variables.product.prodname_classroom %} 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/). diff --git a/data/reusables/classroom/supported-lmses.md b/data/reusables/classroom/supported-lmses.md index b47bd761052e..9dfb2596a6a7 100644 --- a/data/reusables/classroom/supported-lmses.md +++ b/data/reusables/classroom/supported-lmses.md @@ -7,6 +7,7 @@ Using LTI helps keep your information safe and secure. LTI is an industry-standa {% 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 %}. +* Blackboard * Canvas * Moodle * Sakai From 63e1293f31d11e85db4eab73aba4994dc36361f3 Mon Sep 17 00:00:00 2001 From: scollovati <20740642+scollovati@users.noreply.github.com> Date: Mon, 21 Oct 2024 07:39:53 +0200 Subject: [PATCH 2/5] renames to anthology dev portal --- ...arning-management-system-with-github-classroom.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md index 39796475c2a6..d42f34cff6e8 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md @@ -21,9 +21,9 @@ Before you can connect your LMS to a classroom, an administrator for your LMS in 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). -### 1. Register {% data variables.product.prodname_classroom %} Developer Keys in the Blackboard Developer Portal +### 1. Register {% data variables.product.prodname_classroom %} Developer Keys in the Anthology Developer Portal -1. Sign into the [Blackboard Developer Portal](https://developer.anthology.com/). +1. Sign into the [Anthology Developer Portal](https://developer.anthology.com/). 1. Click on the **plus sign** in the [My Application](https://developer.anthology.com/portal/applications) page. 1. Click **Manual Registration** in the dropdown menu. 1. On the "Register a new application" configuration screen, set the fields to the following values. @@ -79,10 +79,10 @@ You can register your Blackboard installation with {% data variables.product.pro * Under "LMS Type", choose "Other" from the dropdown menu. * "Issuer Identifier": `https://blackboard.com` * "Domain": The base URL to your Blackboard instance - * "Client ID": The "Client ID" obtained from the registration of the app in the Blackboard Developer Portal. - * "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Blackboard Developer Portal. - * "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Blackboard Developer Portal. - * "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Blackboard Developer Portal. + * "Client ID": The "Client ID" obtained from the registration of the app in the Anthology Developer Portal. + * "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Anthology Developer Portal. + * "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Anthology Developer Portal. + * "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Anthology Developer Portal. 1. Click **Register**. 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. From 1d118ee717a47f8a37bb2319a1c8830b7c7fc6d4 Mon Sep 17 00:00:00 2001 From: scollovati <20740642+scollovati@users.noreply.github.com> Date: Mon, 21 Oct 2024 09:06:57 +0200 Subject: [PATCH 3/5] hotfix for CI "Content Lint Markdown" --- ...gister-a-learning-management-system-with-github-classroom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md index d42f34cff6e8..c6fe517f1228 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md @@ -41,7 +41,7 @@ You can register your Blackboard installation with {% data variables.product.pro | **Signing Algorithm** dropdown | `RS256` | | **Custom parameters** | Leave empty. | 1. Click **Register Application**. -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**. +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**. 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. 1. Click on the **plus sign**. 1. On the "Register a new placement" configuration screen, set the fields to the following values. From efdeb01cef2f127a7748240b8bfd1deb2e99f499 Mon Sep 17 00:00:00 2001 From: scollovati <20740642+scollovati@users.noreply.github.com> Date: Tue, 11 Feb 2025 09:45:55 +0100 Subject: [PATCH 4/5] fix MD linting errors --- ...nect-a-learning-management-system-course-to-a-classroom.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md index 2a01c3aa4625..b6ee9e954f25 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md @@ -36,14 +36,14 @@ To configure an LMS to connect to {% data variables.product.prodname_classroom % 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). -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)." +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). 1. Sign into your **Blackboard** instance. 1. Select the Blackboard course or organization to integrate with {% data variables.product.prodname_classroom %}. 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. 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. -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)." +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). ## Linking a Canvas course with a classroom From 26f5b2dc31cd6370ac2b3922659fbfa92a41a13a Mon Sep 17 00:00:00 2001 From: scollovati <20740642+scollovati@users.noreply.github.com> Date: Wed, 21 May 2025 11:20:02 +0200 Subject: [PATCH 5/5] fixes after SME review --- ...-a-learning-management-system-course-to-a-classroom.md | 4 ++-- ...-a-learning-management-system-with-github-classroom.md | 8 +++++--- data/reusables/classroom/supported-lmses.md | 2 +- 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md index b6ee9e954f25..281e4b21a549 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-course-to-a-classroom.md @@ -40,8 +40,8 @@ An administrator needs to register your LMS instance with classroom before you c 1. Sign into your **Blackboard** instance. 1. Select the Blackboard course or organization to integrate with {% data variables.product.prodname_classroom %}. -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. -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. +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 admin named it something else when registering your LMS. +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. This step might popup an error message "Unable to launch link. The Tool Provider has been disabled by the System Administrator: GitHub Classroom". To resolve this error, ensure that the status of tool “GitHub Classroom” is set to Approved. Click on LTI Tool Providers in Admin Panel. Hover on the name next to GitHub Classroom and click Approve. 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). diff --git a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md index c6fe517f1228..8e76c8f6a211 100644 --- a/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md +++ b/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/register-a-learning-management-system-with-github-classroom.md @@ -63,11 +63,13 @@ You can register your Blackboard installation with {% data variables.product.pro 1. Sign into your **Blackboard** instance. 1. In the left sidebar on the home page, click **Admin**, then click **LTI Tool Providers**. 1. On the "LTI Tool Providers" page, click **Register LTI 1.3/Advantage Tool**. -1. Insert the **Client ID** obtained from the Developer Portal and click **Submit**. +1. Insert the **Client ID** / **Application ID** obtained from the Developer Portal and click **Submit**. 1. Blackboard will show all application data. In this page: 1. Verify that **Tool Status** is "Approved". 1. Verify that **User Fields to be Sent** flags are enabled for "Role in Course", "Name", "Email Address". - 1. Verify that **Allow mark service access** radio button is set to "No". + 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: + - Select Manage Global Properties + - Under Creation of Tool Provider Links, select radio button “Allow links to any tool provider, but require approval for each new provider” 1. Verify that **Allow Membership Service Access** radio button is set to "Yes". 1. Click **Submit**. @@ -79,7 +81,7 @@ You can register your Blackboard installation with {% data variables.product.pro * Under "LMS Type", choose "Other" from the dropdown menu. * "Issuer Identifier": `https://blackboard.com` * "Domain": The base URL to your Blackboard instance - * "Client ID": The "Client ID" obtained from the registration of the app in the Anthology Developer Portal. + * "Client ID": The "Client ID" / "Application ID" obtained from the registration of the app in the Anthology Developer Portal. * "OIDC Initiation URL": The "OIDC auth request endpoint" obtained from the registration of the app in the Anthology Developer Portal. * "OAuth 2.0 Token Retrieval URL": The "Auth token endpoint" obtained from the registration of the app in the Anthology Developer Portal. * "Key Set URL": The "Public keyset URL" obtained from the registration of the app in the Anthology Developer Portal. diff --git a/data/reusables/classroom/supported-lmses.md b/data/reusables/classroom/supported-lmses.md index 9dfb2596a6a7..1e9255eb0df2 100644 --- a/data/reusables/classroom/supported-lmses.md +++ b/data/reusables/classroom/supported-lmses.md @@ -7,7 +7,7 @@ Using LTI helps keep your information safe and secure. LTI is an industry-standa {% 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 %}. -* Blackboard +* Blackboard (This is a community supported option) * Canvas * Moodle * Sakai