步骤 1 - 在 Moodle 中注册外部工具 Moodle
第一步完全由站点管理员在Moodle内部完成。您需要将 DrillBit 注册为新的 LTI 1.3 外部工具,将其指向 DrillBit 端点,启用 DrillBit 所需的服务,最后打开工具配置详情,复制平台 ID / 客户端 ID / 部署 ID——这些值将用于 DrillBit 端的 步骤 2。
1. 打开“外部工具管理器”
- 以 管理员 身份登录 Moodle。
- 打开 站点管理 › 插件 › 外部工具 › 管理工具。
- 在“工具 URL”字段下方,点击 手动配置工具。
将打开 外部工具配置 表单。
2. 设置工具 URL 和 LTI 版本
填写工具设置部分。以下URL对所有客户均相同:
除非 DrillBit 支持团队明确告知,否则请将 自定义参数 留空。
3. 工具配置使用 & 启动容器
仍在 工具设置 中:
- 工具配置用法 -
Show as preconfigured tool when adding an external tool。正是这一功能使得讲师在向课程添加“外部工具”时,能够从预配置工具下拉菜单中选择 DrillBit。 - 默认启动容器 -
New window。DrillBit 的用户界面比典型的 Moodle 活动框架更宽,因此在新窗口中打开可让教师获得完整的报告视图。 - 支持深度链接(内容项消息) - 请勾选此项。深度链接是驱动教师在将该工具添加到课程时所看到的“创建作业”对话框的功能。
4. 启用所需服务
打开 “服务” 部分并设置:
- IMS LTI 作业与成绩服务 - 使用此服务进行成绩同步和列管理。允许 DrillBit 将相似度分数写回 Moodle 成绩簿。
- IMS LTI 名称和角色配置 - 使用此服务根据隐私设置检索成员信息。让 DrillBit 识别每次启动背后的学生/教师。
- 工具设置 - 使用此服务。
5. 隐私设置
打开 “隐私” 部分,并将所有共享设置为 “始终”:
- 与工具共享启动器名称 -
Always。 - 将启动器的电子邮件地址与工具共享 -
Always。 - 从工具接受成绩 -
Always。
除非您的Moodle环境在其他地方强制使用非HTTPS启动URL,否则请保持“强制SSL”选项未勾选——DrillBit的端点已采用HTTPS。
6. 保存并打开工具详细信息
- 点击表单底部的 “保存更改”。
- 您将返回“管理工具”页面,该页面上会显示一张标题为“已部署的 LTI”(或您设置的任何“工具名称”)且状态为“已启用”的新卡片。
- 点击工具卡片上的 汉堡菜单图标。
将打开“工具配置详细信息”对话框。复制以下每个值——您将在第 2 步中将其粘贴到 DrillBit 中:
- 平台 ID——您的 Moodle 站点的 URL。
- 客户端 ID - Moodle 刚刚生成的 LTI 客户端标识符。
- 部署 ID - 此部署的数字 ID。
- 公钥集 URL -
https://<your-moodle>/mod/lti/certs.php。 - 访问令牌 URL -
https://<your-moodle>/mod/lti/token.php。 - 身份验证请求 URL -
https://<your-moodle>/mod/lti/auth.php.