From 9b72ac3b42ad419e37f6a4530f474b5614911073 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/3] 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 779f4b3445cd..bd01ac7857c9 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 @@ -35,6 +35,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 8cca103f86f5..6396b698e724 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 @@ -20,6 +20,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 51edba64dc41..308e0c85082a 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 4d858f3620c18c54b077a1dc6344ef72f9681945 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/3] 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 6396b698e724..66b3744e5195 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 @@ -24,9 +24,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. @@ -82,10 +82,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 835d9325d778e368253925af6dcef0e0df501418 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/3] 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 66b3744e5195..4e3208107d5a 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 @@ -44,7 +44,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.