Add Comments to Your LMS via LTI 1.3

1. 登录 FastComments 并转到 您的 LTI 1.3 配置页面。
2. (Optional) 从 Platform 下拉菜单中选择您正在连接的平台 - 它会设置显示标签，但 Auto-detect 工作正常。
3. 点击 Generate URL。会出现一个一次性 Registration URL（有效期 30 分钟，仅可使用一次）。
4. 在您的 LMS 中，打开 LTI 1.3 Dynamic Registration 界面，并将该 URL 粘贴到 Tool initiation registration endpoint（或相应）字段。提交。
5. 您的 LMS 会回调到 FastComments，交换密钥并创建集成。完成后弹出窗口会自动关闭。
6. 回到 FastComments，新的配置会出现在 Existing Configurations 表中。该工具现在可以在您的 LMS 课程中使用。

FastComments LTI 1.3 已在以下系统中测试：

• D2L Brightspace (任何支持 LTI Advantage 的版本)
• Moodle 4.0+ (External Tool 插件，LTI Advantage)
• Blackboard Learn (SaaS 与 Ultra)
• Sakai (支持 LTI Advantage 的版本)
• Schoology (Enterprise，在可用时支持 Dynamic Registration)

任何其他实现了 IMS LTI 1.3 Advantage 规范并支持 Dynamic Registration 的 LMS 也应该可用 - 在生成您的注册 URL 时从平台下拉菜单中选择 Other LTI 1.3 platform（在此获取）。

Canvas LMS 使用不同的设置流程（使用 per-developer-key configuration JSON，而不是 Dynamic Registration）。请参阅专门的 Canvas LMS 安装指南。

导航到 LTI 1.3 配置

登录 FastComments 并转到 您的 LTI 1.3 配置页面。

如果您的账户尚未具有 LTI 访问权限，您会看到 "LTI not enabled for this account" - 请联系支持以在您的计划中启用它。

选择平台（可选）

在 生成动态注册 URL 下，使用 Platform 下拉菜单告诉 FastComments 您正在连接哪个 LMS：

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• 其他 LTI 1.3 平台

您也可以将其保留为 自动检测。在注册过程中，平台信息会从您的 LMS 的 openid-configuration 中读取；下拉菜单仅用于为生成的配置提供显示标签的初始值。

生成 URL

单击 Generate URL。FastComments 会创建一个一次性注册令牌并显示一个类似于以下的 URL：

https://fastcomments.com/lti/v1p3/register/<long-token>

复制它。该 URL：

• 是 一次性使用 — 一旦您的 LMS 成功调用，令牌即被使用。
• 在未使用时会在 30 分钟 后到期。
• 应当保密 — 在这 30 分钟内，任何拥有该 URL 的人都可以在您的租户下注册一个工具。

现有配置

注册成功完成后，新配置会显示在同一页面的 Existing Configurations 表中，包含其 Platform、Issuer、Client ID 和 Status。若需取消注册，您可以从该表中删除配置。

D2L Brightspace 通过 LTI Advantage 管理界面提供动态注册。您需要管理员权限。

打开注册界面

1. 以管理员身份登录到您的 Brightspace 实例。
2. 导航到 Admin Tools > Manage Extensibility > LTI Advantage。
3. 点击 Register。 (直接网址为 https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create。)

粘贴 URL

您会看到一个注册表单。关键字段是 Tool initiation registration endpoint（某些 Brightspace 版本将其标记为 "Tool Initiation Registration URL"）。

将 FastComments 注册 URL (在此获取) 粘贴到该字段。将其他字段留空 - 它们会在注册握手过程中由 FastComments 自动填充。

点击 Register。

批准该工具

Brightspace 会打开一个弹出窗口与 FastComments 通信、交换密钥并显示确认屏幕。注册完成后弹出窗口会自动关闭。

新工具会出现在您的 LTI Advantage 工具列表中。默认情况下 Brightspace 会将新工具标记为 disabled - 将切换项切换为 enabled，以便您的课程可以使用它。

添加部署

在 Brightspace 中，LTI 工具在可用于课程之前需要一个 deployment：

1. 打开新注册的 FastComments 工具。
2. 点击 View Deployments > New Deployment。
3. 为部署命名（例如 "FastComments - All Courses"），选择其应可用的组织单元，然后保存。

通过此部署首次启动后，FastComments 会将 deployment_id 固定到其配置记录 - 在同一客户端下来自不同部署的后续启动将被拒绝，除非您重新注册。

使用 Moodle？ 我们还为 FastComments 发布了专门的 Moodle 插件，提供比 LTI 1.3 更紧密的集成（成绩同步钩子、更深入的活动报告、本地 Moodle 设置界面）。请参阅 Moodle 插件安装指南。如果你希望进行一次注册覆盖其他 LMS，或你的 Moodle 管理员不愿安装第三方插件，下面的 LTI 1.3 流程是正确的选择。

Moodle 4.0+ 支持通过 External Tool 插件进行 LTI 1.3 的动态注册。

打开工具管理界面

1. 以站点管理员身份登录 Moodle。
2. 导航到 Site administration > Plugins > Activity modules > External tool > Manage tools。

粘贴 URL

你会看到一个标为 Tool URL 的卡片。将 FastComments 的注册 URL (在此获取) 粘贴到文本字段，然后点击 Add LTI Advantage。

Moodle 会打开一个注册界面，显示该工具的身份信息及其请求的权限。检查无误后点击 Activate（或 Register，取决于 Moodle 版本）。

注册完成后弹窗会关闭；新的 FastComments 工具会以 Active 状态出现在 Tools 列表中。

使其可用

默认情况下，Moodle 会将新工具添加到“Course tools”列表，但不会在活动选择器中显示它们。要在课程范围内公开 FastComments：

1. 点击 FastComments 磁贴上的齿轮图标。
2. 在 Tool configuration usage 下，选择 Show in activity chooser and as a preconfigured tool。
3. 保存。

教师现在可以通过 Add an activity or resource > FastComments 将 FastComments 添加到任何课程。

Blackboard Learn SaaS 和 Ultra 支持 LTI 1.3 动态注册。

打开工具提供者屏幕

1. 以系统管理员身份登录 Blackboard。
2. 导航到 Administrator Panel > Integrations > LTI Tool Providers。
3. 点击 Register LTI 1.3 / LTI Advantage Tool。

如果你只看到“Register LTI 1.1 Provider”，说明你的 Blackboard 版本尚不支持 LTI 1.3——请升级或联系 Blackboard 支持。

粘贴 URL

将 FastComments 注册 URL (在此获取) 粘贴到 Client ID / Registration URL 字段（Blackboard 的标签因版本而异）。提交。

Blackboard 会与 FastComments 执行注册握手并显示确认屏幕。

批准并启用

Blackboard 默认将新注册的工具标记为 Approved but excluded：

1. 在工具提供者列表中找到 FastComments 条目。
2. 打开菜单并选择 Edit。
3. 将 Tool Status 设置为 Approved。
4. 在 Institution Policies 下，查看发送了哪些用户数据（姓名、电子邮件、角色）。保存。

该工具现在可供教师在向课程添加内容时使用。

Sakai

Sakai 在支持 LTI Advantage 的发布版本中支持 LTI 1.3 动态注册。从 管理工作区 开始：

1. 以 Sakai 管理员身份登录并打开 管理工作区。
2. 选择 外部工具 > 安装 LTI 1.3 工具。
3. 粘贴 FastComments 注册 URL (在此获取) 并提交。
4. 握手完成后批准该工具。

该工具随后会出现在 外部工具 下，站点维护者可以将其添加到站点。

Schoology

Schoology Enterprise 实例支持 LTI 1.3，但动态注册的可用性因部署而异。请与您的 Schoology 客户经理确认。

如果您的 Schoology 实例不支持动态注册，则需要使用以下端点手动配置集成：

• OIDC 登录 URL: https://fastcomments.com/lti/v1p3/login
• 目标链接 URL: https://fastcomments.com/lti/v1p3/launch
• 公钥集 URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• 重定向 URL: https://fastcomments.com/lti/v1p3/launch

在 Schoology 向您提供 Client ID 和 Deployment ID 之后，请联系 FastComments 支持在您的租户上注册该配置。

其他 LTI 1.3 平台

任何遵循 IMS LTI 1.3 Advantage 规范的 LMS 都应能使用相同的注册 URL (在此获取)。请查找标有 "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", 或类似名称的设置。

如果您的平台仅支持手动 LTI 1.3 设置，请使用上文 Schoology 部分列出的四个端点并联系支持以完成配置。

本页介绍在管理员已注册工具并创建部署后，如何将 FastComments 添加到 Brightspace 课程中。如果尚未注册该工具，请先参阅 D2L 注册指南。

将 FastComments 作为 Brightspace 单元主题嵌入

Brightspace 提供两种内容创作体验：Classic Content 和 New Content Experience（也称为 Lessons）。两者都支持 FastComments，但菜单路径不同。下面的每个部分都会在两者分歧处进行说明。

找到 FastComments 工具

FastComments 工具在课程内容编辑器中出现在两个位置：

1. 活动选择器，通过模块/单元的 Add Existing 按钮访问（旧版本 Brightspace 标为 Add Existing Activities）。在当前 Brightspace 版本中，FastComments 会直接出现在选择器中；旧版本则将其嵌套在 External Learning Tools 子菜单下。任一路径都会将 FastComments 添加为独立主题。
2. HTML 编辑器内的 Insert Stuff 对话框下的 LTI Advantage。这通过 LTI 深度链接流程将 FastComments 内联嵌入到 HTML 主题中。

如果 FastComments 在任一选择器中都未出现，则说明部署未对包含该课程的组织单元启用。请让您的 Brightspace 管理员打开 Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments，打开该部署，并在 Org Units 下添加该课程的组织单元（或父级组织单元）。

在模块中将 FastComments 添加为主题

Classic Content:

1. 打开课程并在导航栏中点击 Content。
2. 选择应包含讨论的模块（或通过 Add a module 新建一个）。
3. 点击 Add Existing（旧版 Brightspace：Add Existing Activities > External Learning Tools）。
4. 在选择器中点击 FastComments。Brightspace 会在模块中创建一个主题并将您返回到内容视图。
5. 点击新主题。使用内联标题编辑器将其重命名为描述性名称，例如 FastComments Discussion。

New Content Experience (Lessons):

1. 打开课程并点击 Content。
2. 打开应包含讨论的单元和 lesson。
3. 点击 Add > Existing Activity 并选择 FastComments（旧版 Brightspace：嵌套在 External Learning Tools 下）。
4. 活动会被添加到 lesson 中。
5. 点击活动标题以重命名。

任何用户（讲师或学生）首次打开该主题时，FastComments 会为该资源链接初始化线程。该线程绑定到资源链接 ID，因此重命名或移动主题不会改变加载的线程。

在 HTML 主题中内联嵌入 FastComments

当您希望评论出现在同一主题页面内的阅读、视频或其他内容下方，而不是作为单独主题时，使用此流程。

1. 在模块/lesson 中打开或创建一个 HTML 主题。
2. 点击 Edit HTML 以打开 Brightspace HTML 编辑器。
3. 将光标放在应出现评论线程的位置。
4. 点击 Insert Stuff 按钮（编辑器工具栏中的拼图图标）。
5. 在 Insert Stuff 对话框中，向下滚动到 LTI Advantage 并点击 FastComments。
6. FastComments 会打开深度链接选择器。确认放置位置（默认选项适用于内容讨论）；点击 Insert 或 Continue。
7. Brightspace 会返回 HTML 编辑器并显示表示 LTI 启动的占位块。点击主题上的 Save and Close。

当主题加载时，Brightspace 会将该占位块替换为一个通过 LTI 自动启动 FastComments 的 iframe。学生会在页面内看到讨论线程。

一个 HTML 主题可以包含多个深度链接的 FastComments 嵌入。每个嵌入都会产生各自的线程，因为每个深度链接都会生成不同的资源链接 ID。

模块主题 与 内联快速链接（Inline Quicklink）

在以下情况下选择“模块主题”方式：

• 讨论是该模块步骤的主要活动。
• 您希望该主题出现在 Brightspace 的目录、完成跟踪和 Class Progress 中。

在以下情况下选择“内联嵌入”方式：

• 评论应位于同一页面的其他内容下方。
• 您不希望目录中出现单独的、可完成跟踪的条目。

可见性、草稿与发布条件

新的 FastComments 主题默认对学生可见。若想在设置期间隐藏它：

1. 在内容编辑器中，点击主题标题（Classic）或活动上的三点菜单（New Content Experience）。
2. 将状态设为 Draft（Classic），或关闭 Visibility（New Content Experience）。

草稿主题对学生不可见。讲师和助教仍能看到它们并带有 “Draft” 徽章。

要将主题限制为特定小组或班级部分：

1. 打开主题。
2. 点击主题标题菜单 > Edit Properties In-place（Classic），或 Edit > Restrictions（New Content Experience）。
3. 在 Release Conditions 下点击 Create。
4. 选择 Group enrollment 或 Section enrollment，选择相应的小组/部分，然后保存。

发布条件会与 FastComments 自身的角色映射叠加。无法查看该主题的学生不会获得 LTI 启动。

学生首次启动时看到的内容

当学生点击主题（或加载包含嵌入的 HTML 主题）时：

1. Brightspace 在后台执行 LTI 1.3 启动。
2. FastComments 接收学生的姓名、邮箱、头像 URL 和 LMS 角色，并自动为其登录。不会出现 FastComments 登录提示。
3. 该资源链接的评论线程会在 Brightspace iframe 内呈现。

启动时的角色映射：

• Brightspace Administrator 变为 FastComments admin（线程的完整审核、删除、封禁和配置访问权限）。
• Brightspace Instructor 变为 FastComments moderator（置顶、隐藏、删除、封禁）。
• 所有其他角色（Learner、TeachingAssistant 等）则成为普通评论者。

评论将归属于学生的 Brightspace 帐户。如果学生在 Brightspace 中编辑其姓名或头像，下一次 LTI 启动会同步更改。

Iframe 高度与重设大小（Resize）

FastComments 在每次线程呈现和内容更改（新增评论、展开回复）时都会发送 org.imsglobal.lti.frameResize postMessage。Brightspace 监听此消息并调整 iframe 高度，以防止线程被裁剪或出现内部滚动条。

如果 iframe 保持固定且过短的高度：

• 确认课程是在 HTTPS 下加载。Brightspace 的 postMessage 监听器会拒绝混合内容的框架。
• 确认没有浏览器扩展阻止 postMessage 通道。
• 对于 HTML 主题内的内联嵌入，外围 HTML 不应将 iframe 包裹在固定高度容器中。请从父元素中移除任何内联的 style="height: ..."。

Brightspace 特定的常见问题

工具未在 Add Existing 选择器中显示。 此课程所属的组织单元未对该部署启用。管理员需要将该组织单元（或父级）添加到部署的 Org Units 列表。仅注册工具本身不足；部署决定哪些课程可以看到该工具。

启动时出现 deployment_id 不匹配。 FastComments 会将首次看到的 deployment_id 进行 TOFU 固定。如果管理员删除了原始部署并创建了新部署，则来自新部署的启动会因部署不匹配错误而被拒绝。解决方法是重新注册 FastComments（生成新的注册 URL (在此获取）并再次运行 Dynamic Registration）；旧的配置记录将被替换。

工具已启动但显示 “Invalid LTI launch”。 课程所在的租户/组织结构不在部署覆盖范围内，或部署在注册后被禁用。请重新检查 Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled 切换以及该部署的组织单元列表。

FastComments 内缺少姓名和角色。 Brightspace 会在 LTI 启动中附带 Names and Role Provisioning Services (NRPS) 声明。如果该课程是从旧的 LTI 1.1 链接升级而来，则启动可能缺少 name 和 email 声明。通过 Add Existing 重新添加 FastComments 主题（不要迁移旧链接），以便启动使用 LTI 1.3。

嵌入显示登录屏幕而非自动 SSO。 该 HTML 主题是作为指向 FastComments 的普通