开始使用
TeachFORGE.ai
开始使用 / 您的学习平台
连接您的学习平台
机构如何通过 LTI 1.3 把 Canvas、Moodle、Blackboard 或 Brightspace 连接到 TeachForge:由谁来做、交换的两份明细,以及如何测试。
两份清单先交换,然后做一次测试。
由谁来设置
这项连接属于机构,不属于某一位教师。由机构管理员在机构门户的 LMS下、卡片 LMS 集成上设置。管理员必须已开启双重验证登录,才能打开它。
支持四个平台:Canvas、Moodle、Blackboard 和 Brightspace,全部通过 LTI 1.3。教师不用设置任何东西:一旦启用,教师会在自己的课程里遇到 TeachForge。 已关联到您的学习平台的班级 讲的是教师这一侧。
通常涉及两个人:TeachForge 管理员,以及为学校运行学习平台的人(LMS 管理员)。他们交换两份明细。
开始之前
请先让 TeachForge 支持为您的机构设置默认学生 ID 模式。页面上也是这样写的。它决定从平台进来的学习者如何对应到一条记录,并且必须在第一次启动之前就位。
通过联系表单或工单写信给我们,并说明您用的是哪个平台。 学生 ID 模式 说明这种模式是什么。
步骤
选择平台
在 LMS 下选择它,并填写它的 LMS 地址。按 用预设填充 URL ,以填入该平台常用的地址。在 Canvas 上,如果确实如此,请勾选 此 Canvas 由 Instructure 托管(Canvas 云) 。
把第一份清单交给 LMS 管理员
在 交给您的 LMS 管理员 下方,页面列出 OIDC 登录 URL、 启动 URL、 公开 JWKS URL、 深链 URL、重定向地址,以及一项 自定义参数。每一项都有复制按钮。在 Moodle 上,同样的明细使用 Moodle 自己的名称,页面会在旁边显示,例如 工具 URL 和 公钥集。
拿回第二份清单
您的 LMS 管理员注册 TeachForge,并把 来自您 LMS 的平台详情交给您: 签发方、 客户端 ID、 部署 ID、 身份验证 URL、 令牌 URL 和 平台 JWKS URL。请在 学生 ID 来自中选择来源。
选择两个开关,然后保存
一次 LMS 启动即视为该活动的学生口令 让学习者直接从课程开始。 关联教师通过 LMS 启动登录 对账户已关联的教师同样适用。按 保存。
在 Canvas 上,页面会警告:必须把该工具的 Privacy Level 设为 Public。如果没有,TeachForge 需要的明细不会发出,启动就会失败。
测试
按 测试配置。TeachForge 会获取您平台的密钥,并显示 已连接 ,同时显示找到的密钥数量;或者显示 无法读取平台 JWKS ,并给出原因:
- 平台返回了 HTTP 和一个数字:地址不对,或者平台拒绝了。
- 该地址不是 TeachForge 可以获取的地址:只允许端口 443 上的公开 https 地址。
- 响应不是包含 RSA 密钥的密钥集:地址指向了错误的页面。
- 无法访问该地址:检查是否打错字,或询问 LMS 管理员该地址是否公开。
测试通过后,打开 集成已启用。状态会显示 已连接、 未测试、 测试失败 或 离开。
启用之后它做什么
- 学习者和教师从课程内部打开 TeachForge。
- 教师第一次从一门课程启动时,会把它关联到自己的一个班级。
- 同步名单 会带入这门课程的学习者。姓名从不保存。
- 教师一次可以从内容选择器向课程放入最多 20 项。
- 每一次放入都会得到成绩簿中的一列。成绩会自动发送,而 立即发送成绩 会立刻发送。
把它关掉
关掉集成时会询问 关闭集成?。课程与班级之间的关联会被移除;您的班级和其中的学习者记录会保留。若只取消一门课程的关联,请使用 已关联课程 和 取消关联。完全移除注册由 TeachForge 工作人员来做:如有需要,请写信给我们。
一次启动可能显示的消息
| 消息 | 怎么做 |
|---|---|
| 此课程尚未关联到 TeachForge | 教师从该课程启动一次,并把它关联到一个班级。 |
| 此机构尚未启用 TeachForge | 管理员打开 集成已启用。 |
| 您的课程角色无法打开 TeachForge | 学习平台发送了一个 TeachForge 不接受的角色。请询问 LMS 管理员。 |
| 在新标签页中继续 | 浏览器阻止了课程框架里的 TeachForge。按它,即可在自己的标签页中打开 TeachForge。 |