将 Microsoft OneDrive LTI 与 Desire2Learn Brightspace 集成

  • 项目

本指南提供 IT 管理员为 Desire2Learn (D2L) Brightspace LMS 注册 OneDrive LTI 应用的步骤。

有关 Microsoft LTI 的概述，请参阅 将 Microsoft 产品与学习管理系统集成 (LMS) 。

添加 OneDrive LTI 应用的步骤如下：

  1. 步骤 1：添加新的 Microsoft OneDrive LTI 应用。
  2. 步骤 2：在用户的 Brightspace 体验中部署 LTI 应用。
  3. 步骤 3：在快速链接活动栏上打开新的 OneDrive LTI 应用。

注意

执行此集成的人员应该是 Brightspace 的管理员和 Microsoft 365 租户的管理员。

LTI 1.3 设置的源文档位于 LTI 优势 - 管理员指南中。

步骤 1：添加新的 Microsoft OneDrive LTI 应用

注册新的 Microsoft OneDrive LTI 应用

  1. 登录到 Microsoft OneDrive LTI 注册门户。

  2. 选择“管理员同意”按钮并接受权限。

    重要

    如果不接受管理员同意，下一步将向你显示错误，并且你必须等待一个小时才能继续。

  3. 选择“ 创建新的 LTI 租户 ”按钮。

  4. 在 “LTI 使用者平台 ”列表中，选择“ D2L Brightspace”。

  5. 在 D2L Brightspace Base URL 字段中，输入 Brightspace 基本 URL，例如 https://myschool.brightspace.com。

  6. 选择 “下一步” 按钮。 将加载 “注册 LTI 1.3 应用 ”页。
    完成下一组步骤时，使此页面在自己的选项卡中保持打开状态。 所需的值将在后续步骤中生成。

将 Microsoft LTI 应用添加到 Brightspace

  1. 在新的浏览器选项卡中，使用组织的 管理员 或 超级管理员 帐户登录到 Brightspace LMS， (要将 OneDrive LTI 应用添加到其中的) 。
  2. 选择右上角的齿轮图标以访问管理员工具。
  3. 在 “组织相关 ”类别下，找到 “管理扩展性”。
    URL 应类似于此示例： https://<yourbrightspacedomain>/d2l/le/ltiadvantage/registrations/home。
  4. 选择顶部的“ LTI 优势 ”选项卡，然后选择“ 注册工具”。
  5. 为“工具注册类型”选择“标准”单选按钮。
  6. 输入应用的名称，例如 Microsoft OneDrive LTI App。
  7. 在 “域” 字段中，输入 https://onedrivelti.microsoft.com。
  8. 使用 Microsoft OneDrive LTI 注册门户导航到浏览器选项卡，复制其他必需值：
    1. 将 ToolOIDCLaunchRedirectUri 值粘贴到 “重定向 URL” 字段中。

      重要

      稍后的步骤中将使用此 重定向 URL 值。

    2. 将“OIDCLoginInitiationUri”值粘贴到 OpenID Connect 登录 URL 字段中。
    3. 将 ToolPublicJwksUri 值粘贴到 “密钥集 URL ”字段中。
  9. 在 “扩展”下，选中“ 深层链接 ”复选框。
  10. 选择页面底部的“ 注册 ”按钮。
    将显示 Brightspace 应用注册详细信息。 在完成下一组步骤时，使此页面在自己的选项卡中保持打开状态。

将 Brightspace LTI 平台注册详细信息添加到 Microsoft OneDrive LTI 注册门户

在 Brightspace 中注册应用后，你将将值从 Brightspace 的注册门户复制到 Microsoft 的 LTI 注册门户中。

  1. 导航回打开的 Microsoft OneDrive LTI 注册门户页的浏览器选项卡。
  2. 复制所需的 Brightspace 应用注册详细信息页，并将其粘贴到 Microsoft 的 LTI 注册门户中。
    1. 将 Brightspace 的 颁发者 值粘贴到 Microsoft 的 LTI 颁发者 字段中。
    2. 将 Brightspace 的 OpenID Connect 身份验证终结点 值粘贴到 Microsoft 的 LTI 授权 URL 字段中。
    3. 将 Brightspace 的 Brightspace Keyset URL 值粘贴到 Microsoft 的 LTI 公共 Jwks URL 字段中。
    4. 将 Brightspace 的 Brightspace OAuth2 访问令牌 URL 值粘贴到 Microsoft 的 LTI 访问令牌 URL 字段中。
    5. 将 Brightspace 的 “客户端 ID ”值粘贴到 Microsoft 的 LTI 客户端 ID 字段中。
  3. 选择“ 下一步>保存”。
    将显示一条消息，指出 已成功创建 LTI 使用者。
    可选：可以通过选择主页上的“ 查看 LTI 租户 ”按钮来查看注册详细信息。

步骤 2：在用户的 Brightspace 体验中部署 LTI 应用

连接 Microsoft OneDrive LTI 和 Brightspace 后，需要在用户的 Brightspace 体验中部署 OneDrive LTI 应用。

  1. 在具有 Brightspace 管理员体验的选项卡中，导航到“管理员工具>管理扩展性>LTI 优势”以查看 LTI Advantage 应用列表。
  2. 选择在上一步中创建的 LTI Advantage 应用的名称。
  3. 滚动到页面底部，然后选择“ 查看部署 ”链接。
    URL 应类似于以下示例： https://<yourbrightspacedomain>/d2l/le/ltiadvantage/deployments/home
  4. 选择“ 新建部署”。
  5. 按创建 Brightspace 应用注册时输入的名称选择应用，例如 Microsoft OneDrive LTI App。
  6. 输入此部署的部署名称，例如 Microsoft OneDrive Deployment。
  7. 在 “扩展 ”部分中，选择“ 深层链接”。
  8. 选中除 “类列表 ”和“ 匿名”之外的所有安全设置复选框。
  9. 不要选择任何配置设置、替换参数或客户参数。
  10. 选择“ 添加组织单位 ”，然后选择要使用新 LTI 应用的组织单位。
    可以选择：
    • 根组织以及包含所有人的“所有后代”选项。
    • 单个组织单位，仅包括这些单位。
    • 使用“选项”列中的单选按钮的所有后代单位。
  11. 选择“ 创建部署”。
    新部署将显示在列表中。 请保留此选项卡选项，然后继续执行后续步骤。

此步骤将 OneDrive LTI 应用添加到 Brightspace LMS 中的菜单中，用户在其中选择插入 OneDrive 文件。

  1. 在具有 Brightspace 管理员体验的选项卡中，导航到“管理员工具>管理扩展性>LTI 优势”以查看 LTI Advantage 应用列表。
  2. 选择创建的 LTI Advantage 应用的名称。
  3. 滚动到页面底部，然后选择“ 查看部署 ”链接。
  4. 选择在上一步中创建的部署的名称。
  5. 滚动到页面底部，然后选择“ 查看链接”。
  1. 在“ 查看链接” 页中，选择“ 新建链接”。
  2. 输入链接的名称，例如 Microsoft OneDrive。
    用户在其 Brightspace 体验中可以看到此名称。
  3. 将 “重定向 URL” 粘贴到 “URL” 字段中。
    这与前面步骤中使用的 重定向 URL 相同，在 Microsoft 的 OneDrive LTI 注册门户中作为 ToolOIDCLaunchRedirectUri 列出。
  4. 将 “类型” 设置为 “深层链接快速链接”。
  5. 选择“+添加客户参数”，并为“名称”字段和linkSelection“值”字段输入 launchType 。
  6. 选择“ 保存并关闭 ”按钮。
  1. 在“ 查看链接” 页中，选择“ 新建链接”。
  2. 输入链接的名称，例如 Microsoft OneDrive。
    用户在其 Brightspace 体验中可以看到此名称。
  3. 将 “重定向 URL” 粘贴到 “URL” 字段中。
    这与前面步骤中使用的 重定向 URL 相同，在 Microsoft 的 OneDrive LTI 注册门户中作为 ToolOIDCLaunchRedirectUri 列出。
  4. 将 “类型” 设置为 “深层链接插入内容”。
  5. 选择“ 保存并关闭 ”按钮。

OneDrive LTI 应用现在可供用户使用，但旧版 OneDrive 应用现在必须关闭。

  1. 登录到 Brightspace 管理门户。
  2. 导航到管理员>配置变量浏览器
  3. 找到标题为 d2l.3rdParty.OneDrive.EnableOneDrivePicker 的变量，并将值设置为 off。

若要将 OneDrive LTI 应用添加到 Brightspace 的活动栏以便快速访问，需要将组织单元 配置变量 设置为 LTI 应用的链接 ID。

注意

你需要对希望 OneDrive LTI 应用显示在活动栏中的每个组织 ID (或父组织 ID) 重复这些步骤。

  1. 以管理员或超级管理员身份登录到 Brightspace。
  2. 通过选择右上角的齿轮图标导航到“管理员工具”。
  3. 选择“ 管理扩展性 ”以查看 LTI 优势部署 列表。
  4. 选择创建的 LTI Advantage 应用的名称。
  5. 滚动到页面底部，然后选择“ 查看部署”。
  6. 选择你创建的应用部署的名称。
  7. 向下滚动到页面底部，然后选择“ 查看链接”。
  8. 选择具有 深层链接快速链接类型的链接 的名称。
  9. 将鼠标移动到浏览器中的 URL 地址栏。
  10. 复制 URL 中最后 / 一个数字之后的数字。
    例如，如果链接 URL 为 https://example.desire2learn.com/d2l/le/ltiadvantage/deployments/3bfcc0b7-2fb6-4ffe-b353-95b520d4bae6/links/details/259，请 259 复制数值。

更新配置变量

  1. 在 Brightspace 管理门户中，通过选择右上角的齿轮图标导航到“管理员工具”。
  2. 选择 “配置变量浏览器”。
  3. 在左侧的“ 所有变量 ”菜单中，导航到 “3rdParty>Microsoft> ”，然后选择“ OneDriveLTI”。
    应在右窗格中看到变量名称 3rdparty.microsoft.onedriveLTI.linkId 。
  4. 选择 LinkId 变量 名称。
  5. 在 “LinkId 配置 ”屏幕上，选择“ 添加值 ”以选择 组织单位 ，并粘贴之前收集的数字 “链接 ID ”值。
    需要对希望使用 快速链接活动栏的每个组织单元重复此操作。
  6. 若要将此设置应用于所添加的子代组织类型，可以编辑 级联组织单位类型 ，并选择设置应用的类型和顺序。

OneDrive LTI 应用现在将显示在 Brightspace 中的 “添加现有内容”、“ 快速链接”和“ 插入内容 ”菜单中。

用户将看到通用链接图标，而不是 OneDrive 云图标。 菜单中显示的名称将是应用 LTI 链接设置中提供的名称。

这些链接可以根据需要关闭和打开，并按配置针对特定的 Orgs 和 decedents。

有关在 Brightspace 中配置应用程序的详细信息，请访问 Brightspace 帮助。

有关 OneDrive LTI 应用的常见问题

新的 OneDrive LTI FilePicker 是否支持个人帐户？

是的，允许个人帐户打开 OneDrive 以上传文件。 OneDrive LTI 注册门户中的应用中有一个复选框，用于是否允许多个帐户。 如果选中，则允许个人帐户。

FilePicker 是否支持多种语言？

OneDrive LTI FilePicker 查看从 LMS 传递的 LTI 语言设置参数，并 (作为备份) 浏览器设置 (，因为前者是确定要使用的语言的可选声明) 。