将学习管理系统连接到 GitHub Classroom

关于 LMS 的配置

您可以将学习管理系统 (LMS) 连接到 GitHub 课堂，然后 GitHub 课堂可以从 LMS 导入学生标识符名册。若要将 LMS 连接到 GitHub 课堂，必须在 LMS 中输入 GitHub 课堂的配置凭据。

基本要求

要配置 LMS 连接到 GitHub 课堂，您必须先创建一个教室。更多信息请参阅“管理教室”。

支持的 LMSes

GitHub 课堂支持从实施学习工具互操作性 (LTI) 标准的 LMS 导入名册数据。

LTI 版本 1.0 和/或 1.1
配置 1.X 的 LTI 名称和角色

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

GitHub 测试了名册数据从以下 LMS 到 GitHub 课堂的导入。

Canvas
Google Classroom
Moodle
Sakai

目前， GitHub 课堂不支持从 Blackboard 或 Brightspace 导入名册数据.

为教室生成配置凭据

登录 GitHub Classroom。
在课堂列表中，单击要查看的课堂。
在课堂名称下，单击 Students（学生）。
如果您的教室已有名册，您可以更新名册或删除名册并创建新的名册。
- 有关删除和创建名册的更多信息，请参阅“删除教室名册”和“创建教室名册”。
- 有关更新名册的更多信息，请参阅“将学生添加到教室的名册”。
在 LMS 列表中，单击您的 LMS。如果您的 LMS 不受支持，请单击其他 LMS。
阅读有关连接 LMS 的操作，然后单击连接到 LMS。
复制用于连接到教室的“消费者密钥”、“共享密钥”和“启动 URL”。

配置通用 LMS

您必须为 LMS 配置隐私设置，以允许外部工具接收名册信息。

导航到 LMS。
配置外部工具。
提供您在 GitHub 课堂中生成的配置凭据。
- 消费者密钥
- 共享机密
- 启动 URL（有时称为“工具 URL”或类似名称）

配置 Canvas

您可以将 GitHub 课堂配置为 Canvas 的外部应用以将名册数据导入到您的教室。有关 Canvas 的更多信息，请参阅 Canvas 网站。

登录到 Canvas。
选择要与 GitHub 课堂集成的 Canvas 课程。
在左边栏中，单击 Settings（设置）。
单击 Apps（应用程序）选项卡。
单击 View app configurations（查看应用程序配置）。
单击 +App。
选择 Configuration Type（配置类型）下拉菜单，然后单击 By URL（通过 URL）。

从 GitHub 课堂粘贴配置凭据。更多信息请参阅“为教室生成配置凭据”。

Canvas 应用程序配置中的字段	值或设置
消费者密钥	GitHub 课堂中的消费者密钥
共享秘密	GitHub 课堂中的共享密钥
允许此工具访问 IMS 名称和角色预配服务	已启用
配置 URL	GitHub 课堂中的启动 URL

注意: 如果您在 Canvas 中看不到名为“Allow this tool to access the IMS Names and Role Provisioning Service（允许此工具访问 IMS 名称和角色预配服务）”的复选框，则您的 Canvas 管理员必须联系 Canvas 支持，以为您的 Canvas 帐户启用会员服务配置。如果不启用此功能，您将无法从 Canvas 同步名册。更多信息请参阅 Canvas 网站上的如何联系 Canvas 支持？。

单击 Submit（提交）。
在左侧边栏中，单击 Home（主页）。
要提示 Canvas 发送确认电子邮件，请在左侧栏中单击 GitHub Classroom。按照电子邮件中的说明完成链接 GitHub 课堂。

配置 Moodle

您可以将 GitHub 课堂配置为 Moodle 的活动以将名册数据导入到您的教室。有关 Moodle 的更多信息，请参阅 Moodle 网站。

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

登录 Moodle。
选择要与 GitHub 课堂集成的 Moodle 课程。
单击 Turn editing on（打开编辑）。
当希望 GitHub 课堂在 Moodle 中可用时，单击 Add an activity or resource（添加活动或资源）。
选择 External tool（外部工具）并单击 Add（添加）。
在“Activity name（活动名称）”字段中，键入 "GitHub Classroom"。
在 Preconfigured tool（预配置的工具）字段的下拉菜单右侧，单击 +。

在“External tool configuration（外部工具配置）”下，从 GitHub 课堂粘贴配置凭据。更多信息请参阅“为教室生成配置凭据”。

Moodle 应用程序配置中的字段	值或设置
工具名称	GitHub 课堂 - YOUR CLASSROOM NAME 注意：您可以使用任何名称，但为明确起见，我们建议使用这个值。
工具 URL	GitHub 课堂中的启动 URL
LTI 版本	LTI 1.0/1.1
默认启动容器	新窗口
消费者密钥	GitHub 课堂中的消费者密钥
共享机密	GitHub 课堂中的共享密钥

滚动到 Services（服务）并单击。
在“IMS LTI Names and Role Provisioning（IMS LTI 名称和角色预配）”的右侧，选择下拉菜单并单击 Use this service to retrieve members' information as per privacy settings（根据隐私设置使用此服务检索成员的信息）。
滚动到 Privacy（隐私）并单击。
在 Share launcher's name with tool（使用工具共享启动者的名称）和 Share launcher's email with tool（使用工具共享启动者的电子邮件）右侧，选择下拉菜单以单击 Always（始终）。
在页面底部，单击 Save changes（保存更改）。
在 Preconfigure tool（预配置工具）菜单中，单击 GitHub Classroom - YOUR CLASSROOM NAME。
在“Common module settings（通用模块设置）”下“Availability（可用性）”的右侧，选择下拉菜单并单击 Hide from students（对学生隐藏）。
在页面底部，单击 Save and return to course（保存并返回课程）。
导航到您选择显示 GitHub 课堂的任何位置，然后单击 GitHub 课堂活动。

从 LMS 导入名册

有关从将名册从 LMS 导入到 GitHub 课堂的更多信息，请参阅“管理教室”。

断开 LMS 连接

登录 GitHub Classroom。
在课堂列表中，单击要查看的课堂。
在课堂名称下，单击 Settings（设置）。
在“Connect to a learning management system (LMS)（连接到学习管理系统 [LMS]）”下，单击 Connection Settings（连接设置）。
在“Delete Connection to your learning management system（删除与学习管理系统的连接）”下，单击 Disconnect from your learning management system（断开与学习管理系统的连接）。