使用 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 将花名册数据从以下 LMS 注册、连接和导入到 GitHub Classroom。

  • Canvas
  • Moodle
  • Sakai
  • Google Classroom

注意

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

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

配置 Canvas 以用于 GitHub Classroom

您可以将您的 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 优势服务下拉列表选中“可以检索与安装工具的上下文关联的用户数据”复选框。
    其他设置下拉列表在“隐私级别”下，选择公开
    位置选择课程设置子导航。

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

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

为 GitHub Classroom 配置 Moodle

您可以将您的 Moodle 安装注册到 GitHub Classroom，以使教师能够将花名册数据导入他们的课堂。有关 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

    注意：您可以使用任何名称，但如果您将其设置为其他名称，请确保将其告知教师。
    工具 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
    重定向 URIhttps://classroom.github.com/lti1p3/openid-connect/redirect
    默认启动容器新窗口

  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 - [您的课程名称]

    注意：您可以使用任何名称，但如果您将其设置为其他名称，请确保将其告知教师。
    按钮文本（工具菜单中的文本）教师在启动到 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 将显示您需要使用 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 实例，教师现在可以链接他们的课堂。