添加一个入站LTI适配器
Note
本文档采用 AI 辅助机器翻译。译文仅供参考，不保证准确性；此内容的英文版为官方权威版本。
LTI 1.1 Retirement
Blackboard has officially announced the Retirement of LTI 1.1 Support in Blackboard LMS. Please read the announcement. LTI versions older than 1.3 have known and documented security vulnerabilities. These older versions of the standard have been deprecated by the owning standards organization, 1EdTech. If you are building a new tool, please only use LTI 1.3/Advantage.
1 January 2027: Registration of new LTI 1.0 and LTI 1.1 tools in Blackboard LMS is no longer permitted. The registration button will be removed for these older versions.
30 September 2027: All LTI 1.0 and LTI 1.1 tools are turned off in Blackboard LMS and can’t be made active.
LTI 适配器类型是符合 LTI 1.1 标准的 OAuth 1.0 签名请求。在LTI 1.1发布时，你必须提供包含用户批_uid/外部ID的lis_person_sourcedid或ext_user_username属性才能登录。您可以在 Blackboard LMS 提供重定向参数，将用户重定向到特定位置。
配置无人机设置
在无人机设置界面，选择添加认证适配器，填写如下字段：
字段 | 描述 |
|---|---|
别名 | 这是适配器的独特名称，用于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}.扩展.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}。