在 GitHub Classroom 注册一个学习管理系统

可以使用 GitHub Classroom 配置符合 LTI 的学习管理系统 (LMS)。

谁可以使用此功能？

Organization owners who are admins for a classroom can connect learning management systems to GitHub Classroom.

在本文中

关于将 LMS 注册到您的课堂中

在将 LMS 连接到课堂之前，LMS 实例的管理员需要将 LMS 配置为允许 GitHub Classroom，然后在 GitHub Classroom 注册 LMS 以启动 OAuth 握手。 管理员只需执行一次注册过程，那么任何使用 LMS 实例的教师均可将其 LMS 课程同步到课堂。 有关将 LMS 课程连接到课堂的详细信息，请参阅 将 Learning Management System 课程连接到教室。

注意

支持的学习管理系统

GitHub Classroom 支持与实施学习工具互操作性 (LTI) 标准的 LMS 建立连接。

  • LTI 版本 1.3
  • LTI 优势

使用 LTI 有助于确保您的信息安全。 LTI 是一个行业标准协议，GitHub Classroom 对 LTI 的使用得到了教学管理系统 (IMS) 全球学习联盟的认证。 有关详细信息，请参阅 IMS 全球学习联盟网站上的学习工具互操作性和关于 IMS 全球学习联盟。

GitHub 已测试且验证注册、连接及将名册数据从以下 LMS 导入 GitHub Classroom。

  • Blackboard（这是社区支持的选项）
  • 画布
  • Moodle
  • Sakai
  • Google Classroom

注意

其他实施 LTI 1.3 的 LMS 可与 GitHub Classroom 配合工作，但尚未验证。 LMS 管理员可能需要配置有关隐私和按钮放置的自定义设置，以及可能需要向教师提供如何从 LMS 启动到 GitHub Classroom 的文档。

Google Classroom 不使用 LTI 协议，因此在导入名册之前不需要连接到 GitHub Classroom。 有关详细信息，请参阅“将 Learning Management System 课程连接到教室”。

为 GitHub Classroom 配置 Blackboard

你可以在 GitHub Classroom 上注册你的 Blackboard 系统，以便教师可以将名单数据导入课堂。 有关 Blackboard 的详细信息，请参阅 Blackboard 网站。

步骤 1. 在 Anthology 开发人员门户中注册 GitHub Classroom 开发人员密钥

  1. 登录到 Anthology 开发人员门户。

  2. 在“我的应用程序”页中单击加号。

  3. 在下拉菜单中单击“Manual Registration”****。

  4. 在“Register a new application”配置屏幕中，将字段设置为以下值。

    新应用配置中的字段值或设置
           **应用程序名称** | `GitHub Classroom` <br/><br/>可以使用任何名称，它将仅向管理员显示。  |

    | 描述 | Sync Blackboard course roster to GitHub Classroom（或类似） | | Domain(s) | classroom.github.com | | 分组 | 保留默认值或根据机构需求对其进行更改。 | | 我的集成支持 LTI 1.3 | 启用标志。| | 登录初始 URL | https://classroom.github.com/lti1p3/openid-connect/auth | | 工具重定向 URL | https://classroom.github.com/lti1p3/openid-connect/redirect,https://classroom.github.com/context-link | | 工具 JWKS URL | https://classroom.github.com/.well-known/jwks.json | | “Signing Algorithm”下拉菜单**** | RS256 | | 自定义参数**** | 留空。 |

  5. 单击“Register Application”****。

  6. 开发人员门户将显示一个屏幕，其中包含你在 Blackboard 实例和下面的 GitHub Classroom 中注册实例的后续步骤中需要输入的重要信息。 请在安全的地方记下它们，然后单击“Done”****。

  7. 在“My Applications”页上的表中，在 GitHub Classroom 应用程序这一行中，单击三个点，然后在下拉菜单中单击“Manage Placements”****。

  8. 单击加号。

  9. 在“注册新展示位置”配置界面中，将字段设置为以下值。

    新放置配置中的字段值或设置
           **位置名称** | `GitHub Classroom` <br/><br/>可以使用任何名称，但如果将其设置为其他名称，请确保让教师知晓。  |

    | 描述 | Sync Blackboard course roster to GitHub Classroom（或类似） | | 类型下拉列表 | 课程工具 | | 允许学生访问 | 请勿启用此标志。 | | 在新窗口中启动 | 除非你想要提供该用户体验，否则请勿启用该标志。 | | 目标链接 URI | https://classroom.github.com/context-link | | 图标 URL | 请将其留空或为该图标提供静态 URL。 如果需要，稍后可以在 Blackboard 中手动上传。 | | 自定义参数**** | 留空。 |

  10. 单击“Register Placement”****。

步骤 2. 在 Blackboard 中注册 GitHub Classroom 开发人员密钥

  1. 登录到您的Blackboard实例。
  2. 在主页的左边栏中，单击“Admin”，然后单击“LTI Tool Providers”********。
  3. 在“LTI Tool Providers”页面，单击“Register LTI 1.3/Advantage Tool”****。
  4. 插入从开发人员门户获取的客户端 ID**** 应用程序 ID，然后单击“Submit” / ********。
  5. Blackboard 将显示所有应用程序数据。 在本页中：
    1. 验证“Tool Status”是否为 ****Approved。
    2. 验证是否为“课程中的角色”、“姓名”、“电子邮件地址”启用了“要发送的用户字段”标志。****
    3. 验证“允许标记服务访问”单选按钮是否设置为“否”。**** 要启用此选项，请导航到管理员面板中的 LTI 工具提供程序：
      • 选择“管理全局属性”
      • 在“工具提供者链接的创建”下，选择单选按钮“允许链接到任何工具提供者，但需要对每个新提供者进行批准”
    4. 验证“允许会员服务访问”单选按钮是否设置为“是”****。
  6. 单击“提交”****。

步骤 3. 在 GitHub Classroom 注册开发人员密钥

  1. 转到 https://classroom.github.com/register-lms。

  2. 填充以下信息：

    • 在“LMS Type”下，从下拉菜单中选择“Other”。
    • “颁发者标识符”：https://blackboard.com
    • “Domain”：Blackboard 实例的基础 “URL”
    • “客户端 ID”：从 Anthology 开发人员门户中的应用注册中获取的客户端 ID/应用程序 ID。
    • “OIDC 启动 URL”：从 Anthology 开发人员门户中的应用注册获取的“OIDC 身份验证请求终结点。“
    • “OAuth 2.0 令牌检索 URL”：应用在 Anthology 开发人员门户中注册时获得的身份验证令牌端点。
    • “Key Set URL”：从 Anthology 开发人员门户中的应用注册获取的公用密钥集 URL。

  3. 单击“注册”。

  4. 应会在屏幕上方看到“成功注册 LMS”的横幅，这意味着已注册了 LMS 实例，教师现在可以链接他们的教室。

为 GitHub Classroom 配置画布

可以在 GitHub Classroom 注册 Canvas 安装，让教师能够将名单数据导入其教室。 有关 Canvas 的详细信息，请参阅 Canvas 网站。

1. 在 Canvas 中注册 GitHub Classroom 开发人员密钥

  1. 登录到 Canvas。

  2. 在主页的左侧栏中，单击“Admin”，然后单击“Site Admin”。

  3. 单击“开发人员密钥”。

  4. 在“开发人员密钥”下，单击“+ 开发人员密钥”按钮，然后从下拉菜单中选择“+LTI 密钥” 。

  5. 在“密钥设置”配置屏幕上，将字段设置为以下值。

    Canvas 应用程序配置中的字段值或设置
           **方法** | `Manual Entry` |

    | 标题 | GitHub Classroom

    注意：可以使用任何名称，但如果将此名称设置为其他名称，请确保让教师知晓。 | | 描述 | Sync Canvas course rosters to GitHub Classroom（或类似） | | 目标链接 URI | https://classroom.github.com/context-link | | OpenID Connect 初始化 URL | https://classroom.github.com/lti1p3/openid-connect/auth | | JWK 方法 | Public JWK URL | | 公共 JWK URL | https://classroom.github.com/.well-known/jwks.json | | 重定向 URI | https://classroom.github.com/lti1p3/openid-connect/redirect | | LTI 优势服务下拉列表 | 选中“可以检索与工具所安装的上下文关联的用户数据”复选框。 | | “其他设置”下拉菜单 | 在“隐私级别”下，选择 Public | | 放置 | 选择 Course Settings Sub Navigation。

    注意： 如果将“放置”设置为其他位置，则必须让教师知晓。 本文档会预先假定这是按钮的放置位置。 |

  6. 单击“ 保存”。

  7. 在“开发人员密钥”页的表中，在 GitHub Classroom 开发人员密钥的行中，记下“详细信息”列中客户端 ID 的值 -- 这必须告知教师，以便他们完成设置。

  8. 在“开发人员密钥”页上的“状态”列中，将密钥的状态切换为“打开”。

2. 在 GitHub Classroom 注册开发人员密钥

  1. 转到 https://classroom.github.com/register-lms。

  2. 填充以下信息：

    • 在“LMS 类型”下，从下拉菜单中选择“画布”。
    • “颁发者标识符”：https://canvas.instructure.com
    • “域名”：Canvas实例的基 URL
    • “客户端 ID”：创建的开发人员密钥中“详细信息”下的“客户端 ID”
    • “OIDC 授权终结点”：Canvas 实例的基 URL，其末尾添加了 /api/lti/authorize_redirect。
    • “OAuth 2.0 令牌检索 URL”：Canvas 实例的基 URL，其末尾添加了 /login/oauth2/token。
    • “Key Set URL”：Canvas 实例的基础 URL，其末尾添加了 /api/lti/security/jwks。

  3. 单击“注册”。

  4. 应会在屏幕上方看到“成功注册 LMS”的横幅，这意味着已注册了 LMS 实例，教师现在可以链接他们的教室。

为 GitHub Classroom 配置 Moodle

可以在 GitHub Classroom 注册 Moodle 安装，让教师能够将名单数据导入其教室。 有关 Moodle 的详细信息，请参阅 Moodle 网站。

您必须使用 Moodle 版本 3.0 或更高版本。

1. 在 Moodle 中启用“发布为 LTI 工具”

  1. 登录到 Moodle。
  2. 单击顶级菜单中的“站点管理”选项卡。
  3. 在“站点管理”页上，单击“插件”选项卡，然后向下滚动到“身份验证”部分，然后单击“管理身份验证”。
  4. 在“LTI”字段旁边，单击切换按钮以启用 LTI。
  5. 再次单击“插件”选项卡，然后向下滚动到“登记”，然后单击“管理登记插件”。
  6. 在“发布为 LTI 工具”字段旁边，单击切换按钮以启用“发布为 LTI 工具”。
  7. 点击顶级菜单中的“站点管理”选项卡返回“站点管理”页面，然后向下滚动到“安全”部分，单击“HTTP 安全性”。
  8. 在“允许帧嵌入”旁边，选中用于启用帧嵌入的复选框，然后单击“保存更改”。

2. 将 GitHub Classroom 注册为外部工具

  1. 单击顶级菜单中的“网站管理”选项卡，返回到 Moodle“网站管理”页面。

  2. 单击“插件”选项卡，然后在“活动模块”部分旁边，“外部工具”下方，单击“管理工具”。

  3. 单击“手动配置工具”。

  4. 在各字段中输入以下值。

    Moodle 应用程序配置中的字段值或设置
           **工具名称** | `GitHub Classroom` <br/><br/>注意：可以使用任何名称，但如果将此名称设置为其他名称，请确保让教师知晓。 |

    | 工具的 URL | https://classroom.github.com | | LTI 版本 | LTI 1.3 | | 公钥类型 | Keyset URL | | 公钥集 | https://classroom.github.com/.well-known/jwks.json | | 启动登录 URL | https://classroom.github.com/lti1p3/openid-connect/auth | | 重定向 URL | https://classroom.github.com/lti1p3/openid-connect/redirect | | 默认启动容器 | New window |

  5. 选中“支持深层链接（内容项消息）”复选框。

  6. 在“服务”下拉列表的“IMS LTI 名称和角色预配”旁边，从下拉菜单中选择“使用此服务根据隐私设置检索成员的信息”。

  7. 在“隐私”下拉列表中，将“使用工具共享发起人的名称”设置为“始终”，并将“使用工具共享发起人的电子邮件”设置为“始终”。

  8. 单击“保存更改”。

  9. 现已将 GitHub Classroom 注册为外部工具。 在“工具”下的“GitHub Classroom”框中，单击菜单图标以查看“工具配置详细信息”界面。 此界面包含需要在以下（在 GitHub Classroom 上注册实例）最后一步中要输入的重要信息。

3. 在 GitHub Classroom 上注册 Moodle 实例

  1. 转到 https://classroom.github.com/register-lms。

  2. 填充以下信息：

    • 在“LMS 类型”下，从下拉菜单中选择“Moodle”。
    • “颁发者标识符”：在 Moodle 中创建的外部工具“工具配置详细信息”中的“平台 ID”
    • “域”：Moodle 实例的基础 URL
    • “客户端 ID”：在 Moodle 中创建的外部工具“工具配置详细信息”中的“客户端 ID”
    • “身份验证请求 URL”：在 Moodle 中创建的外部工具“工具配置详细信息”中的“身份验证请求 URL”
    • “访问令牌 URL”：在 Moodle 中创建的外部工具“工具配置详细信息”中的“访问令牌 URL”
    • “密钥集 URL”：在 Moodle 中创建的外部工具“工具配置详细信息”中的“公共密钥集 URL”

  3. 单击“注册”。

  4. 应会在屏幕上方看到“成功注册 LMS”的横幅，这意味着已注册了 LMS 实例，教师现在可以链接他们的教室。

为GitHub Classroom配置Sakai

1. 将 GitHub Classroom 注册为外部工具

  1. 进入 Sakai 并登录。

  2. 转到“管理工作区”，在左侧边栏中选择“外部工具”。

  3. 单击“安装 LTI 1.x 工具”。

  4. 在各字段中输入以下值。

    Sakai 应用配置中的字段值或设置
           **工具名称** | GitHub Classroom - [课程名称] <br/><br/>注意：可以使用任何名称，但如果将此名称设置为其他名称，请确保让教师知晓。 |

    | 按钮文本（工具菜单中的文本） | 教师会在用于启动到 GitHub Classroom 的按钮上看到的内容。 例如，此值可以是 sync。 | | 启动 URL | https://classroom.github.com/context-link | | 将用户名发送到外部工具 | 选中此复选框。 | | 向外部工具提供名单 | 选中此复选框。 | | 工具支持 LTI 1.3 | 选中此复选框。 | | LTI 1.3 工具密钥集 URL | https://classroom.github.com/.well-known/jwks.json | | LTI 1.3 工具 OpenID Connect/初始化端点 | https://classroom.github.com/lti1p3/openid-connect/auth | | LTI 1.3 工具重定向终结点 | https://classroom.github.com/lti1p3/openid-connect/redirect |

  5. 提交后，Sakai 将显示你需要的信息，以便在 GitHub Classroom 注册 Sakai 实例。

2. 在 GitHub Classroom 中注册 Sakai 实例

  1. 转到 https://classroom.github.com/register-lms。

  2. 填充以下信息：

    • 在“LMS 类型”下，从下拉菜单中选择“Sakai”。
    • “LTI 1.3 平台颁发者”：Sakai 提供的“LTI 1.3 平台颁发者”字段
    • “域名”：您的 Sakai 实例的基础 URL
    • “LTI 1.3 客户端 ID”：Sakai 提供的“LTI 1.3 客户端 ID”字段
    • “LTI 1.3 平台 OIDC 身份验证 URL”：Sakai 提供的“LTI 1.3 平台 OIDC 身份验证 URL”字段
    • “LTI 1.3 平台 OAuth2 持有者令牌检索 URL”：Sakai 提供的“LTI 1.3 平台 OAuth2 持有者令牌检索 URL”字段
    • “LTI 1.3 平台 OAuth2 已知/密钥集 URL”：Sakai 提供的“LTI 1.3 平台 OAuth2 已知/密钥集 URL”字段

  3. 单击“注册”。

  4. 应会在屏幕上方看到“成功注册 LMS”的横幅，这意味着已注册了 LMS 实例，教师现在可以链接他们的教室。