Skip to main content

添加一个入站 LTI 适配器

Note

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

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 中已禁用,无法启用。

LTI 适配器类型是符合 LTI 1.1 标准的 OAuth 1.0 签名请求。在 LTI 1.1 启动中,您必须提供包含用户 batch_uid/外部 ID 的 lis_person_sourcedid 或 ext_user_username 属性才能登录。您可以提供重定向参数,将用户转到 Blackboard LMS 中的特定位置。

配置 UAS 设置

在 UAS 设置屏幕上,选择添加身份验证适配器。填写以下字段:

字段

描述

别名

这是适配器的独特名称,用于URL中。别名将以所有小写字母存储,且不应包含任何特殊的URL字符。

已启用

该开关决定适配器是否可用。

授权类型

LTI

使用外接适配器

选择用于向外部服务进行出站认证的认证适配器。如果没有选择,默认的出站适配器将被使用。

调试启用

该开关决定是否将调试语句写入日志以进行故障排除。

受限用户

输入一个逗号分隔的用户名列表,这些用户无法使用该适配器。

密钥

输入 OAuth 1.0 键值作为签名。

秘密

输入OAuth 1.0的签名秘密值。保存后,这个值会被遮蔽,所以你无法访问,但你可以更改它。

重定向参数

输入一个参数,包含用户登录后将被引导至的URL。

禁用无发声追踪

请开启此开关以便排查故障,以便重新使用认证请求。出于安全考虑,我们建议您关闭此开关,以便启用无一次性追踪。

帮助文本

输入文本,在系统配置或发生错误时会显示给用户。本文限于1000字符。

用户配置

启用用户配置

选择此开关以启用用户创建请求中提供的信息。

以下参数可随单点登录链路提供,仅在启用自动配置且用户首次创建时使用:

lis_person_sourcedid/ext_user_username

lis_person_name_given

lis_person_name_family

lis_person_contact_email_primary

默认系统角色

选择将分配给新用户的系统角色。选项包括标准角色(SystemAdmin、SystemSupport、CourseCreator、CourseSupport、AccountAdmin、Guest、User、Observer、Integration和Portal)以及任何自定义角色。

默认机构角色

选择将分配给新用户的机构角色。

默认数据源

选择将分配给新用户的数据源。

注册配置

启用注册配置

选择此开关,以便在已提供课程且不存在注册时自动创建注册。

首次自动配置注册时需要以下额外参数:

context_id → course_id

角色

课程角色默认

选择将分配给新用户的课程角色,若未提供该角色。

默认数据源

选择将分配给新注册的数据来源。

课程配置

启用课程设置

选择此开关,使系统能够创建课程,并以指定角色注册该课程。

注意

要启用课程配置,您必须启用注册配置。

如果存在外部课程编号(context_id),系统将为用户注册该课程。首次自动配置课程时需要以下额外参数:

context_id → course_id

context_title

context_label →描述

课程模板

输入复制后将应用到新课程的模板课程ID。

默认数据源

选择将分配给新课程的数据来源。

跳过配置的自定义参数名称

这会识别用于判断请求是否应跳过配置的自定义参数名称(不含“custom_”)。提供一个布尔值“true”以跳过配置。

选择保存以保存您的配置。

配置的适配器的 URL 为 https://{region}.extensions.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}。