添加一个入站 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}。