如何在 LTI 1.3 中正确获取用户身份与调用 NRPS 服务|完整集成指南

梦墨吖_5869

梦墨吖_5869

2026-09-27

573人浏览

原创

如何在 LTI 1.3 中正确获取用户身份与调用 NRPS 服务|完整集成指南

本文详解 LTI 1.3 工具中获取用户信息的两种标准方式(JWT 声明解析与 Names and Role Provisioning Service 调用),明确 auth.php 与 token.php 的职责边界,并提供 scope 配置、JWT 解析示例及关键注意事项,助开发者合规对接 Moodle 等主流 LMS。

本文详解 lti 1.3 工具中获取用户信息的两种标准方式(jwt 声明解析与 names and role provisioning service 调用),明确 `auth.php` 与 `token.php` 的职责边界,并提供 scope 配置、jwt 解析示例及关键注意事项,助开发者合规对接 moodle 等主流 lms。

在构建符合 IMS Global LTI 1.3 标准的学习工具时,准确、安全地获取用户身份是实现个性化体验(如自动填充姓名/角色、同步成绩、创建 OneNote 笔记本)的前提。许多开发者(尤其在本地调试 Moodle 时)会困惑于:为何调用 /mod/lti/token.php 获得了 Bearer Token,却无法直接从中提取用户邮箱或角色?这本质上源于对 LTI 1.3 安全架构与服务分层的误解。下面我们将从核心流程、关键端点、标准实践三方面系统梳理。

? 一、两个关键端点的职责不可混淆

  • /mod/lti/auth.php(OpenID Connect 认证端点)
    这是 LTI 1.3 启动流程的第一道门,严格遵循 OpenID Connect Authorization Code Flow。当 LMS(如 Moodle)发起资源链接(Resource Link)启动时,会重定向至该地址,携带 client_id、login_hint、target_link_uri 等参数。其核心作用是:
    ✅ 验证 LMS 的 JWT ID Token 签名与声明(如 iss, aud, exp);
    ✅ 生成授权码(authorization code),供后续换取访问令牌(Access Token);
    ❌ 它不返回用户数据本身,也不处理 scope——它只负责身份认证与授权流转。

  • /mod/lti/token.php(OAuth 2.0 Token 端点)
    工具后端用上一步获得的 code,向此端点发起 POST 请求(含 client_id, client_secret, redirect_uri, grant_type=authorization_code),换取:
    ✅ 一个短期有效的 Bearer Access Token(用于调用 LTI Advantage 服务);
    ✅ 一个 ID Token(JWT 格式,含基础用户身份声明)。
    ⚠️ 注意:你手动构造 JWT 并调用此接口绕过 auth.php 是非标准且不安全的调试行为,生产环境必须走完整 OIDC 流程。

? 二、获取用户信息的两种标准路径

LTI 1.3 明确区分“启动时的基础身份”与“运行时的扩展成员信息”,开发者需按需选择:

✅ 方式 1:解析 Launch JWT 中的 User Identity Claims(推荐首选)

每次 LMS 启动工具时,都会在 id_token 参数中附带一个已签名 JWT。解码后(无需验签即可查看 payload),你将获得标准化的用户声明,例如:

{
  "sub": "user_12345",
  "name": "Zhang San",
  "given_name": "San",
  "family_name": "Zhang",
  "email": "zhangsan@school.edu",
  "https://purl.imsglobal.org/spec/lti/claim/roles": [
    "http://purl.imsglobal.org/vocab/lis/v2/membership#Instructor"
  ],
  "https://purl.imsglobal.org/spec/lti/claim/custom": {
    "canvas_user_id": "112233"
  }
}

? 关键点:这些字段由 LMS 在启动时主动提供,无需额外 API 调用,零延迟、零 scope 依赖,适用于绝大多数场景(如显示用户名、判断教师/学生角色)。

✅ 方式 2:调用 Names and Role Provisioning Service(NRPS)获取上下文级成员列表

当你需要获取当前课程(Context)内所有成员(如全班学生邮箱列表、助教名单),或需确认用户在该课程中的精确角色(如 TeachingAssistant),则必须调用 NRPS 服务。其流程为:

  1. 确保 Token 请求包含正确 scope
    在调用 token.php 换取 Access Token 时,scope 参数必须显式声明:

    scope=https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly

    若未声明,即使成功获取 Token,后续 NRPS 请求也会返回 403 Forbidden。

  2. 调用 NRPS Endpoint
    从 Launch JWT 的 https://purl.imsglobal.org/spec/lti/claim/tool_platform 声明中提取 nrps 服务 URL(如 https://moodle.example.com/mod/lti/services/nrps/v2/courses/course-123/memberships),然后发送带 Bearer Token 的 GET 请求:

    curl -X GET \
      -H "Authorization: Bearer eyJhbGciOi..." \
      "https://moodle.example.com/mod/lti/services/nrps/v2/courses/course-123/memberships"

    响应示例(简化):

    {
      "memberships": [
        {
          "status": "Active",
          "user": {
            "user_id": "user_12345",
            "name": "Zhang San",
            "email": "zhangsan@school.edu",
            "picture": "https://..."
          },
          "roles": ["http://purl.imsglobal.org/vocab/lis/v2/membership#Instructor"]
        }
      ]
    }

⚠️ 三、重要注意事项与避坑指南

  • 永远不要注释或绕过 scope:token.php 中的 scope 是 OAuth 2.0 授权的核心契约。删除它等于放弃权限声明,导致服务调用失败。开发时可先固定写死 scope 字符串,上线前再动态注入。
  • JWT 解析 ≠ Token 验证:调试阶段可用 jwt.io 快速解码 id_token 查看内容,但生产环境必须验证 JWT 签名、iss(LMS 发行者)、aud(你的 client_id)、exp(有效期),否则存在严重安全风险。
  • Moodle 特别提醒:确保 LMS 管理员已在站点管理 → 插件 → 外部工具 → LTI 工具设置中,为你的工具启用 "Names and Roles Provisioning Service"(NRPS)和 "Deep Linking"(深层链接)服务,否则相关 claim 和 endpoint 将不会出现在 Launch JWT 中。
  • 时间戳敏感:LTI 1.3 对 JWT 的 iat(issued at)和 exp(expires at)有严格校验(通常允许 ±5 分钟偏差)。确保服务器时间与 NTP 同步,否则频繁出现 invalid_token 错误。

通过严格遵循上述规范,你的 LTI 1.3 工具不仅能稳定获取用户身份,更能无缝适配 Canvas、Brightspace、Schoology、Blackboard 等所有 LTI 1.3 Advantage 平台——这也是 Microsoft 365 LTI 应用能在多 LMS 中统一部署的技术基石。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习