作为学生数据的管理者,我们深知您非常关注采用新型教育科技工具所带来的隐私和安全问题。由于 LTI 工具的集成深度,许多技术细节都会影响数据的共享。本指南旨在帮助您了解相关设置,以便您能够就授予哪些访问权限做出明智的决定。
在“开发者密钥”的“其他设置”中,可以将密钥的隐私级别设置为“公开”或“私有”。请注意,如果将此值设置为工具提供商建议值以外的其他值,可能会导致服务无法正常工作。例如,如果启动级别设置为“私有”,即使已授予“可以在与该工具关联的成绩簿中创建和查看作业数据”权限,该工具也无法正确更新成绩簿。
所有标记为“私有”的发射活动中发送的默认信息包括:
- 资源链接请求
- 工具启动所依据的帐户、课程或作业的“标题”或名称。
- 资源 ID
- 资源描述
- 工具的部署 ID
- 工具启动时的背景类型
- 工具启动时的背景信息(例如,如果是课程,则需提供课程名称和标题)
- 用户的标准 LTI 角色(管理员、讲师、用户等,无自定义角色)
- 启动该工具的画布放置名称
如果此次发布被指定为公开发布,则还将包括:
- 用户图标
- 用户的电子邮件地址
- 用户名
- 用户的名字
- 用户的姓氏
- 用户SIS ID
- 课程的SIS ID
除了以上信息,还有四个主要设置领域需要关注,它们会影响共享的数据内容。我们将在下文中逐一详细介绍。这四个领域是:
权限
本节定义了下列各类别下的具体应用场景。本文档通篇使用这些类别来指示某个功能或替换变量的支持范围。例如,当某个变量被描述为适用于课程时,它适用于此处定义的相应课程应用类别中的所有应用场景。
部署
一般来说,工具只有在启动时才能访问信息,而且仅限于启动时的上下文以及启动它的用户。如果一个工具只安装在课程 A 中,它就不会获取课程 B 的信息。如果一个工具只用于作业 A,它就不会获取作业 B 的信息。同样,工具也只能访问与其使用的作业相关的更新信息。
此外,除从学生背景卡位置启动工具外,其他位置的工具只能访问启动该工具的用户的信息;从学生背景卡位置启动工具时,工具将提供启动该工具的学生的 ID。
实习安排
许多替换变量仅在特定位置可用。我们已将位置类型分组如下,以便您更轻松地了解哪些替换变量适用于哪些位置。您可以找到一份包含每个位置屏幕截图的文档。这里。
实习安排 | 替代变量 |
|---|
课程实习 | - 课程导航
- 课程首页 子导航
- 课程设置子导航
- 任务索引菜单
- 课程作业菜单(支持深度链接)
- 迁移选择(支持深度链接)
- 同步成绩
- 编辑器按钮(支持深度链接)
- 协作(支持深度链接)
- 讨论主题菜单
- 讨论索引菜单
- 测验菜单
- 测验索引菜单
- 页面菜单
- 页面索引菜单
- 顶部导航
- 任务组菜单
- 链接选择(支持深度链接)
- 模块索引菜单(托盘)
- 模块索引菜单(模态)
- 模块菜单
- 模块组菜单
- 模块菜单模态框(支持深度链接)
|
文件管理岗位 | |
实习安排 | - 任务编辑
- 任务选择(支持深度链接)
- 任务视图
- 任务菜单
- 作业提交(支持深度链接)
- 提交类型选择(支持深度链接)
- 编辑器按钮(支持深度链接)
|
其他职位 | |
变量展开
最后一种与工具共享数据的方式是通过变量扩展。要查看 Canvas 提供的所有变量的技术文档,请参阅这里. 该列表旨在提供变量的一般类别及其提供的信息类型,以及这些变量的应用场景。
多变的 | 细节 |
|---|
账户信息 | 提供有关 Canvas 帐户的数据。这些变量在 Canvas 的任何位置都适用。 |
分析信息 | 提供 xAPI 和 caliper 用于分析的信息。 |
任务信息 | 提供有关工具所拥有的特定任务的信息。不包含与该任务相关的用户信息。这些变量仅在任务内部有效。 - com.instructure.Assignment.lti.id
- com.instructure.Assignment.description
- com.instructure.Assignment.allowedFileExtensions
- com.instructure.Assignment.anonymous_grading
- com.instructure.Assignment.restrict_quantitative_data
- Canvas.assignment.id
- Canvas.作业.描述
- Canvas.作业.标题
- Canvas.assignment.points可能
- Canvas.assignment.unlockAt.iso8601
- 画布.赋值.lockAt.iso8601
- Canvas.assignment.dueAt.iso8601
- Canvas.assignment.earliestEnrollmentDueAt.iso8601
- Canvas.assignment.allDueAts.iso8601
- Canvas.作业.已发布
- Canvas.assignment.lockdownEnabled
- Canvas.assignment.allowedAttempts
- ResourceLink.available.startDateTime
- ResourceLink.available.endDateTime
- ResourceLink.submission.endDateTime
|
背景信息 | 这些信息提供有关工具启动上下文的内容。它们在 Canvas 的任何位置都有效。 - com.instructure.Course.allow_canvas_resource_selection
- com.instructure.Course.available_canvas_resources
- 上下文标题
- Context.sourcedId
- com.instructure.Course.accept_canvas_resource_types
- com.instructure.Course.canvas_resource_type
- com.instructure.Course.canvas_resource_id
- 上下文.id
- com.instructure.Context.globalId
- com.instructure.Context.uuid
|
课程信息 | 此工具包含启动该工具的课程信息,但不包含课程内个人的信息。此功能仅在课程内访问时,才能在课程设置、作业设置和文件管理设置中使用。 - 课程提供来源 ID
- 上下文.id.历史记录
- Canvas.course.id
- vnd.instructure.Course.uuid
- Canvas课程名称
- Canvas.course.sisSourceId
- com.instructure.Course.integrationId
- Canvas.course.startAt
- Canvas.course.endAt
- Canvas.course.workflowState
- Canvas.term.startAt
- Canvas.term.endAt
- Canvas.term.name
- Canvas.term.id
- 课程部分.源ID
- Canvas.enrollment.enrollmentState
- com.instructure.Course.gradingScheme
- Canvas.course.previousContextIds
- Canvas.course.previousContextIds.recursive
- Canvas.course.previousCourseIds
- com.instructure.contextLabel
|
文件管理信息 | 关于 Canvas 文件管理系统中文件的信息。这些信息仅在文件管理位置有效。 - Canvas.file.usageRights.name
- Canvas.file.usageRights.url
- Canvas.file.usageRights.copyrightText
- Canvas.file.media.id
- Canvas.file.media.type
- Canvas.file.media.duration
- Canvas.file.media.size
- Canvas.file.media.title
|
全球信息 | 工具的技术信息不包含用户或帐户信息。这些工具可在任何环境下运行。 - com.instructure.PostMessageToken
- ToolConsumerInstance.guid
|
团体信息 | 关于某个团体的信息。不包括该团体中的学生成员。 - 课程和作业中的作品
- com.instructure.Course.groupIds
- Canvas.group.contextIds
- 作业中的作品
- com.instructure.Group.id
- com.instructure.Group.name
|
模块信息 | 模块信息。适用于大多数课程和作业安排,前提是对象可以作为模块的一部分。 - Canvas.module.id
- Canvas.moduleItem.id
|
观察员信息 | 关于正在观看课程的用户的信息。仅适用于课程和作业安排。 - com.instructure.User.observees
- com.instructure.Observee.sisIds
|
抄袭检测信息 | 抄袭检测器使用的信息。这不包括用户特定信息。 - 完成任务
- com.instructure.OriginalityReport.id
- vnd.Canvas.原创性报告.url
- vnd.Canvas.submission.url
- vnd.Canvas.submission.history.url
- com.instructure.Submission.id
- com.instructure.File.id
- 随时随地工作
- LtiLink.custom.url
- ToolProxyBinding.custom.url
- ToolConsumerProfile.url
|
RCE 信息 | 关于富文本编辑器的信息。com.instructure.Editor.contents 包含用户在富文本编辑器中提供的信息,因此如果用户在该字段中包含姓名或个人信息,这些信息将被共享。 - 编辑器按钮位置
- com.instructure.Editor.contents
- com.instructure.Editor.selection
- 任何地方都适用
- com.instructure.RCS.app_host
|
资源链接信息 | 资源链接信息,这些链接指向相关内容。工具只能访问其自身创建的资源。不会共享任何用户信息或帐户信息。 |
角色和权限信息 | 账户中可用的权限和角色类型,以及根据请求为特定用户提供的权限和角色信息(工具必须提供用户 ID 才能请求单个用户的权限)。这些变量适用于所有部署位置。 - com.Instructure.membership.roles
- Canvas.membership.roles
- Canvas.membership.concludedRoles
- 成员角色
- Canvas.xuser.allRoles
- com.instructure.User.allRoles
- Canvas.user.isRootAccountAdmin
|
章节信息 | 版块信息。不包含版块内所有用户的列表,但可以根据用户提供其所属版块。适用于课程和作业安排。 - com.instructure.User.sectionNames
- Canvas.course.sectionIds
- Canvas.course.sectionRestricted
- Canvas.course.sectionSisSourceIds
|
提交信息 | 记录学生在特定作业中提交的次数。此功能包含在“作业”模块中。 |
工具信息 | 关于如何在 Canvas 中设置该工具的信息。可在任何地方使用。 - Canvas.externalTool.global_id
- Canvas.externalTool.url
|
用户详情 | 用户信息包括其作为管理员的帐户、代词、时区、高对比度偏好等。这些变量适用于任何环境。 - Canvas.user.adminableAccounts
- Message.locale
- Canvas.user.prefersHighContrast
- 用户图像
- com.instructure.Person.pronouns
- 人员.地址.时区
|
用户邮箱 | 用户的电子邮件地址。这些变量在任何地方都适用。 - Person.email.primary
- vnd.Canvas.Person.email.sis
|
用户身份 | 代表用户的各种 ID。这些变量在任何地方都适用。 - 用户身份
- Canvas.user.id
- vnd.instructure.User.uuid
- vnd.instructure.User.current_uuid
- Canvas.user.globalId
- Canvas.user.sisSourceId
- Canvas.user.sisIntegrationId
- Person.sourcedId
- Canvas.masqueradingUser.id
- Canvas.masqueradingUser.userId
- 用户名
- Canvas.user.loginId
|
用户会话 | 用户 Canvas 会话信息。这些变量在任何地方都适用。 - com.instructure.User.student_view
- Canvas.logoutService.url
|
用户名 | 用户名。这些变量在任何地方都适用。 - 人名全名
- 人员姓名显示
- 人名.家庭
- 人名
- com.instructure.Person.name_sortable
|