BlackboardHelp Center

Blackboard LMS: Administrator

设置 LTI

Updated on

Note

这些文档采用 AI 辅助的机器翻译。译文按原样提供，不保证其准确性。本内容的英文版本为官方权威来源。

为新域设置全局属性

在此，您可以为 LTI 工具配置默认全局设置。如果要自定义各个设置，您可以在添加新的工具提供者时进行自定义。

  1. 在管理员面板的集成下，选择 LTI 工具提供者。

  2. 选择管理全局属性。

  3. 在功能可用性下，选择您的创建工具提供者链接偏好：

    • 允许链接到任何未明确排除的工具提供者：教师可以将 LTI 链接添加到管理员在管理 LTI 工具提供者时未明确阻止的任何域。

    • 允许链接到任何工具提供者，但每个新提供者均需获得批准：教师可以添加 LTI 链接，但如果是新域，则需要经过管理员批准。

    • 仅允许链接到已批准的工具提供者：除非管理员已批准该域，否则教师无法添加 LTI 链接。

  4. 选择是否允许任何工具提供者在“成绩中心”发布成绩。此全局设置仅适用于 LTI 1.1。对于 LTI 1.3，评分基于每个工具进行。

    • 启用此全局设置后，Blackboard LMS 将接受 LTI 工具提供者发布的成绩，但仅限于课程中由工具提供者放置位置创建的“成绩中心”列。

    • 工具提供者若要利用此设置，必须配置允许评分的放置位置。

  5. 在默认配置区域，可以设置有关用户数据和用户确认消息的全局选项。

    • 为了安全起见，强烈建议使用仅通过 SSL 发送用户数据选项。此设置仅适用于 LTI 1.1。在 LTI 1.3 中，需要 SSL（TLS 2）连接。

    • 如果选择从不，则所有要发送的用户字段选项均将取消选中。

    • 如果您选择仅通过 SSL 发送用户数据或通过任何连接发送用户数据，要发送的用户字段将显示三个预选字段，您可以根据机构的隐私政策进行自定义：课程中的角色、姓名和电子邮件地址。

    • 在允许成员服务访问部分中选择是后，该工具可以请求课程中的所有用户或部分用户（教师和学生）。如果选择否，则工具将无法访问该信息，且显示用户确认消息选项将变为可用。对该选项选择是，您可以向用户显示自定义消息，例如：“您即将启动第三方 LTI 工具。”

    • 选择提交以设置全局属性。

LTI 版本

LTI 有两个版本：v1.1 和 v1.3。每个版本都需要不同的配置步骤。添加 LTI 工具前，请确保您了解该工具所属的版本。

LTI v1.0 与同样已弃用的 LTI v1.1 非常相似，但不能回传成绩信息。如果您要添加 LTI v1.0 资源，请将其注册为 LTI v1.1。

当前版本是 LTI v1.3。与以前版本最大的区别在于基于 OAuth2、OpenID Connect 和 JSON Web 令牌的升级安全模型。此外还有 LTI Advantage，这是在 LTI v1.3 基础上构建的新扩展服务包，在 LTI 规范之外独立发展。

添加 LTI 1.1 工具提供者

LTI 1.1 停用

Blackboard已正式宣布在 Blackboard LMS 中停用对 LTI 1.1 的支持。请阅读公告。早于 1.3 的 LTI 版本存在已知且有文档记录的安全漏洞。这些较旧版本的标准已被拥有该标准的组织 1EdTech 弃用。如果您正在构建新工具，请仅使用 LTI 1.3/Advantage。

  • 2027 年 1 月 1 日：Blackboard LMS 不再允许注册新的 LTI 1.0 和 LTI 1.1 工具。这些旧版本的注册按钮将被删除。

  • 2027 年 9 月 30 日：所有 LTI 1.0 和 LTI 1.1 工具在 Blackboard LMS 中已禁用，无法启用。

Important

Blackboard建议 LTI 集成使用 LTI 1.3 或更新版本。我们建议管理员联系使用旧版 LTI 的供应商，请求更新。我们还鼓励使用旧版 LTI 创建自定义集成的机构更新其工具。

  1. 在管理员面板的集成下，选择 LTI 工具提供者。

  2. 选择注册 LTI 1.1 提供者。

  3. 键入提供者域，例如 www.example.com。

  4. 选择提供者域状态 - 已批准或已排除。默认设置为已批准。选择已排除可阻止用户从工具提供者添加 LTI 链接。

  5. 为提供者提供任意次要主机名（可选）。提供者可以提供此信息。

  6. 向提供者确认是否允许对整个站点或每个链接进行配置，并相应地选择默认配置。对于全局设置，键入工具提供者密钥和工具提供者机密。如果将默认配置保留为为每个链接单独设置，则用户在创建每个链接时均需输入密钥和机密。您为单个提供者所做的任何选择都会覆盖全局属性。

  7. 在工具提供者自定义参数文本框中添加工具提供者所需的任何自定义参数。

    • 每个参数都必须单独占一行。

    • 它们必须采用“name=value”对的格式。

    • 它们可以是替换变量。例如：

      userNameLTI=$User.username

      useridLTI=$User.id

      userEmailLTI=$Person.email.primary

    • 它们还可以是模板变量。这些变量使用 Blackboard LMS 中的数据，以其参数格式 @x@user.full_name@x@ 进行解析。例如：

      crsRoleLrn=@X@membership.role@X@

      course_pl=@X@course.pk_string@X@

  8. 机构策略部分从全局属性中提取首选项。您可以在此处管理单项设置。

    • 为了安全起见，强烈建议使用仅通过 SSL 发送用户数据选项。

    • 如果选择从不，则所有要发送的用户字段选项均将取消选中。

    • 如果您选择仅通过 SSL 发送用户数据或通过任何连接发送用户数据，要发送的用户字段将显示三个预选字段，您可以根据机构的隐私政策进行自定义：

      课程中的角色、姓名和电子邮件地址。

    • 在允许成员服务访问部分中选择是后，该工具可以请求课程中的所有用户或部分用户（教师和学生）。如果选择否，则工具将无法访问该信息，且显示用户确认消息选项将变为可用。对该选项选择是，您可以向用户显示自定义消息，例如：“您即将启动第三方 LTI 工具。”

  9. 选择提交添加 LTI 1.1 工具。

添加 LTI 1.3/Advantage 工具

  1. 在管理员面板的集成下，选择 LTI 工具提供者。

  2. 选择注册 LTI 1.3/Advantage 工具。

  3. 输入工具供应商提供的客户端 ID 或应用程序 ID。如果您要开发自己的应用程序，可以在开发人员门户上注册，并注册您的应用程序以获取客户端 ID。

    • 某些 LTI 工具支持动态注册服务，以便在要求管理员自行注册工具时简化注册流程。如果工具使用动态注册，请在“我的应用程序”页面上选择动态注册。输入工具提供者提供的注册 URL，然后执行工具提供者要求的步骤。

  4. 选择提交。开发人员门户中的应用程序配置设置将显示在该页面上。

  5. 字段为只读字段，但是您可以将工具状态选择为已批准或已排除。

  6. 机构策略部分从全局属性中提取首选项。您可以在此处启用或停用要发送的用户字段复选框，为单个提供者管理设置：课程中的角色、姓名和电子邮件地址。您也可以对每个工具分别设置允许或禁止成绩服务访问。

  7. 在允许成员服务访问部分中选择是后，该工具可以请求课程中的所有用户或部分用户（教师和学生）。如果选择否，则工具将无法访问该信息，且显示用户确认消息选项将变为可用。对该选项选择是，您可以向用户显示自定义消息，例如：“您即将启动第三方 LTI 工具。”

  8. 您为单个提供者所做的任何选择都会覆盖全局属性。

  9. 选择提交添加 LTI 1.3/Advantage 工具。

配置放置位置：LTI 工具的显示位置

添加 LTI 工具提供者后，您可以设置放置位置，使用户能够更轻松地在 Blackboard LMS 用户界面中查找和使用该工具。工具供应商可以为 LTI 1.3 工具定义所有放置位置。

如果未配置放置位置，学生和教师若要在课程中使用该工具，就必须知道 URL 或密钥，如通过 LTI 连接使用教学工具中所述。

如何创建放置位置

  1. 在管理员工具下的 LTI 工具提供者中，转到要配置的工具提供者，然后选择域旁边显示的菜单选项。转到管理放置位置。

  2. 选择创建放置位置。

  3. 键入一个标签。此名称将在课程中显示给用户。

  4. 如果工具通过工具菜单显示给学生，请添加描述。描述不会显示给教师。

  5. 键入标识符。它必须是唯一的，并且只能包含字母数字、下划线或短划线字符。

  6. 要将放置位置设为可用或不可用，请选择是或否。

  7. 选择一个类型：

    Note

    您不能更改现有放置位置的类型。若要更改类型，必须创建新的放置位置。

    • 深度链接内容工具：允许教师和课程构建者启动 LTI 工具并从工具提供者添加内容，而不是通过 Blackboard LMS 界面添加内容。如果工具提供者经过配置，教师可以在单次导入中选择多项内容，则此工具可以节省时间并简化工作流程。

      • 允许学生访问：授予学生权限，使其也可以从工具提供者添加内容。

    • 课程内容工具：允许教师从“课程内容”页面添加工具。通过内容市场部分添加后，该工具将成为课程大纲的一部分。

      • 允许评分：允许教师向工具添加评分功能，例如截止日期和满分。

    • 课程工具：该工具在原始课程的“课程管理”区域和 Ultra 课程的“书籍和工具”菜单中向教师和课程构建者显示。

      • 允许学生访问：选中后，学生可以在学生“工具”菜单中访问该工具。添加描述，以帮助学生了解该工具是什么以及有何用途。

    • 系统工具无需访问课程即可打开。在原始体验中，该工具显示在我的机构选项卡的工具菜单中。在 Ultra 体验中，该工具显示在基本导航的“工具”部分。您还可以在“机构页面”模块中放置系统工具。

    • 通过管理员工具，管理员可以将该工具添加到管理员面板的工具和实用工具菜单中。

    • Ultra 扩展放置位置用于某些集成。仅在集成提供者告知时使用此放置位置。如果您的集成不需要，请勿使用此放置位置。

    • 监考工具、基本导航工具和课程导航工具是由工具提供者设置的 LTI 1.3/Advantage 专用类型，您可以访问但无法修改。

  8. 如果您希望此工具在新窗口中而不是 iframe 中启动，请选中该复选框。

  9. 选择浏览并上传 50 x 50 像素的图像文件，为该工具添加图标。如果此 LTI 放置位置位于原始课程视图的课程中，图标会与链接一起显示在工具列表中。在 Ultra 课程视图中，图标会与链接一起显示在内容市场中，但不会与链接一起显示在“课程内容”页面上。

  10. 键入工具提供者信息。在大多数情况下，此信息与您创建工具时添加的信息相同，除非您要为同一个已注册的提供者创建多个放置位置。

  11. 选择提交。

Warning

删除 LTI 域或放置位置将断开所有现有的 LTI 链接。重新添加 LTI 域或放置位置不会修复已断开的链接。除非您确定再也不会使用，否则不要删除 LTI 放置位置或域。

要将 LTI 1.1 工具迁移到 LTI 1.3，请使用相同的域创建新的 LTI 工具，并接受迁移到 LTI 1.3 的提示。这将安全地处理现有链接。

管理工具访问权限和可见性

原始课程视图课程仍允许教师覆盖工具的可用性状态（如果允许）。Ultra 课程视图课程中的工具可用性始终由管理员管理。

  1. 在管理员面板的工具和实用工具下方，选择工具。

  2. 搜索要打开或关闭的工具。您将看到内部工具、Building Block 工具和 LTI 工具的列表，可以按类型进行筛选。

  3. 在“可用性”中，选择开或关。

  4. 您也可以对新的原始课程和所有 Ultra 课程或新的和现有课程应用更改。

  5. 选择提交。