在 GitHub Classroom 中注册学习管理系统

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

谁可以使用此功能？

课堂管理员的组织所有者可以将学习管理系统连接到 GitHub Classroom。

本文内容

关于将 LMS 注册到您的课堂

在将 LMS 连接到课堂之前，LMS 实例的管理员需要配置 LMS 以允许 GitHub Classroom，然后将 LMS 注册到 GitHub Classroom 以启动 OAuth 握手。管理员只需执行一次注册过程，然后任何使用其 LMS 实例的教师都可以将其 LMS 课程同步到课堂。有关将 LMS 课程连接到课堂的更多信息，请参阅“将学习管理系统课程连接到课堂”。

注意： Google Classroom 不使用 LTI 协议，因此在导入花名册之前不需要连接到 GitHub Classroom。有关更多信息，请参阅“将学习管理系统课程连接到课堂”。

支持的 LMS

GitHub Classroom 支持连接到实现学习工具互操作性 (LTI) 标准的 LMS。

  • LTI 版本 1.3
  • LTI 优势

使用 LTI 有助于保护您的信息安全。LTI 是一种行业标准协议，GitHub Classroom 对 LTI 的使用已通过教学管理系统 (IMS) 全球学习联盟认证。有关更多信息，请参阅 IMS 全球学习联盟网站上的 学习工具互操作性 和 关于 IMS 全球学习联盟。

GitHub 已测试并验证了从以下 LMS 到 GitHub Classroom 的注册、连接和花名册数据导入。

  • Canvas
  • Moodle
  • Sakai
  • Google Classroom

注意：其他实现 LTI 1.3 的 LMS 也可能与 GitHub Classroom 兼容，但尚未经过验证。LMS 管理员可能需要配置有关隐私和按钮放置的自定义设置，并且可能需要向教师提供有关如何从 LMS 启动 GitHub Classroom 的文档。

Google Classroom 不使用 LTI 协议，因此在导入花名册之前不需要连接到 GitHub Classroom。有关更多信息，请参阅“将学习管理系统课程连接到课堂”。

为 GitHub Classroom 配置 Canvas

您可以将 Canvas 安装注册到 GitHub Classroom，以使教师能够将花名册数据导入其课堂。有关 Canvas 的更多信息，请参阅 Canvas 网站。

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

  1. 登录 Canvas。

  2. 在主页左侧边栏中，单击管理，然后单击站点管理。

  3. 单击开发者密钥。

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

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

    Canvas 应用配置中的字段值或设置
    方法手动输入
    标题GitHub Classroom

    注意：您可以使用任何名称，但如果您将其设置为其他名称，请确保将其告知教师。
    描述将 Canvas 课程花名册同步到 GitHub Classroom（或类似内容）
    目标链接 URIhttps://classroom.github.com/context-link
    OpenID Connect 启动 URLhttps://classroom.github.com/lti1p3/openid-connect/auth
    JWK 方法公共 JWK URL
    公共 JWK URLhttps://classroom.github.com/.well-known/jwks.json
    重定向 URIhttps://classroom.github.com/lti1p3/openid-connect/redirect
    LTI Advantage 服务下拉菜单选中“可以检索与工具安装的上下文关联的用户数据”复选框。
    其他设置下拉菜单在“隐私级别”下，选择公共
    位置选择课程设置子导航。

    注意：如果您将位置设置为其他内容，则必须将其告知教师。我们的文档将期望这是按钮的位置。

  6. 点击保存。

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

  8. 在“开发者密钥”页面上的表格中，在“状态”列下，将密钥的状态切换为“开启”。

2. 在 GitHub Classroom 中注册您的开发者密钥

  1. 访问 https://classroom.github.com/register-lms.

  2. 填写以下信息

    • 在“LMS 类型”下，从下拉菜单中选择“Canvas”。
    • “发行者标识符”：https://canvas.instructure.com
    • “域”：您 Canvas 实例的基 URL
    • “客户端 ID”：您创建的开发者密钥中“详细信息”下的“客户端 ID”
    • “OIDC 授权端点”：您 Canvas 实例的基 URL，在末尾附加/api/lti/authorize_redirect。
    • “OAuth 2.0 令牌检索 URL”：您 Canvas 实例的基 URL，在末尾附加/login/oauth2/token。
    • “密钥集 URL”：您 Canvas 实例的基 URL，在末尾附加/api/lti/security/jwks。

  3. 点击注册。

  4. 您应该在屏幕顶部看到“已成功注册 LMS”横幅，这意味着您已注册您的 LMS 实例，教师现在可以链接他们的课堂。

配置 Moodle 以使用 GitHub Classroom

您可以将您的 Moodle 安装注册到 GitHub Classroom，以使教师能够将花名册数据导入他们的课堂。有关 Moodle 的更多信息，请参阅 Moodle 网站.

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

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

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

将 GitHub Classroom 注册为外部工具

  1. 点击顶层菜单中的 "站点管理" 选项卡返回 Moodle "站点管理" 页面。

  2. 点击 "插件" 选项卡，然后在 "活动模块" 部分的 "外部工具" 下，点击 **管理工具**。

  3. 点击 **手动配置工具**。

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

    Moodle 应用配置中的字段值或设置
    工具名称GitHub Classroom

    注意：您可以使用任何名称，但如果您将其设置为其他名称，请确保将其告知教师。
    工具 URLhttps://classroom.github.com
    LTI 版本LTI 1.3
    公钥类型密钥集 URL
    公钥集https://classroom.github.com/.well-known/jwks.json
    启动登录 URLhttps://classroom.github.com/lti1p3/openid-connect/auth
    重定向 URI(s)https://classroom.github.com/lti1p3/openid-connect/redirect
    默认启动容器新窗口

  5. 选中 **支持深度链接 (内容项消息)** 复选框。

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

  7. 在 "隐私" 下拉菜单中，将 "与工具共享启动器名称" 设置为 "始终"，并将 "与工具共享启动器电子邮件" 设置为 "始终"。

  8. 点击 **保存更改**。

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

3. 将您的 Moodle 实例注册到 GitHub Classroom

  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 实例，教师现在可以链接他们的课堂。

配置 Sakai 以使用 GitHub Classroom

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

  1. 转到 Sakai 并登录。

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

  3. 点击**安装 LTI 1.x 工具**。

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

    Sakai 应用配置中的字段值或设置
    工具名称GitHub Classroom - [您的课程名称]

    注意：您可以使用任何名称，但如果您将其设置为其他名称，请确保将其告知教师。
    **按钮文本**（工具菜单中的文本）教师在启动 GitHub Classroom 的按钮上看到的文本。例如，该值可以是sync。
    启动 URLhttps://classroom.github.com/context-link
    将用户名发送到外部工具选中此复选框。
    向外部工具提供花名册选中此复选框。
    工具支持 LTI 1.3选中此复选框。
    LTI 1.3 工具密钥集 URLhttps://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 将显示您需要注册您的 Sakai 实例到 GitHub Classroom 的信息。

2. 将您的 Sakai 实例注册到 GitHub Classroom

  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 Bearer 令牌检索 URL": Sakai 提供的“LTI 1.3 平台 OAuth2 Bearer 令牌检索 URL”字段
    • "LTI 1.3 平台 OAuth2 Well-Known/KeySet URL": Sakai 提供的“LTI 1.3 平台 OAuth2 Well-Known/KeySet URL”字段

  3. 点击注册。

  4. 您应该在屏幕顶部看到“已成功注册 LMS”横幅，这意味着您已注册您的 LMS 实例，教师现在可以链接他们的课堂。