Spring AI MCP 多租户安全实战:共享 Session 会串数据吗?工具权限与隔离边界

Spring AI 接入 MCP 后,Java 服务可以让模型查询远程资料、调用工具,甚至执行写操作。但一个常见误解是:只要每次请求都携带不同用户的 Token,MCP 会话就自动隔离。Spring AI 1.1 官方文档明确讨论了应用级单例客户端与共享 Session 的边界。本文从工具发现、会话状态、资源授权、隔离方案和测试矩阵讲清风险。

技术范围:Spring Boot 3.x、Java 17+、Spring AI 1.1 MCP Client 文档;代码展示授权设计骨架,具体版本需与项目 BOM 核对。

一、Token、Client 与 Session 必须分开理解

1.1 应用级 Client 不等于用户级 Client

Spring AI MCP Client Boot Starter 自动配置的 McpSyncClient / McpAsyncClient Bean 是应用范围单例。一个配置的 MCP Server 连接通常对应一个 Client,协议 Session 在客户端生命周期中复用。

text 复制代码
用户 A(Token A) ─┐
                   ├─ Spring Boot / MCP Client 单例
用户 B(Token B) ─┘              │
                                 ▼
                          共享 MCP Session
                                 │
                                 ▼
                             MCP Server

Token 可以按请求传递给 Server 做身份鉴别,但底层 Session 并不会因为用户变化就自动分裂。Session 不是租户隔离边界。

1.2 什么情况下可能发生跨用户状态污染

如果 Server 仅按 Session 保存"当前项目""工作目录""分页游标""上次选中的文档",用户 A 改变状态后,用户 B 复用同一 Session 就可能受到影响。这是需要验证的架构风险,不是宣称 Spring AI 已发生某个真实漏洞。

是否造成泄露,取决于 MCP Server 是否每次请求都鉴权,以及服务端是否把用户敏感状态错误地挂在共享 Session 上。

二、工具发现与工具执行是两道不同的权限关

2.1 tools/list 可能只在连接初始化时运行

官方文档指出,自动配置 Client 的 initialize 和 tools/list 通常在连接时执行一次。如果 Server 按连接初始身份返回不同工具清单,后续其他用户共享 Client 时看到的工具定义可能不符合其权限。

text 复制代码
应用启动 → initialize / tools/list
                     ↓
              工具元数据缓存
                     ↓
用户 B 请求 → 模型选择工具 → tools/call

注意: 能看到工具不代表有权执行工具。MCP Server 必须在每一次 tools/call 中重新校验用户、租户、操作和资源。

2.2 不要把模型参数当成身份

java 复制代码
// 反例:tenantId 可由模型或请求参数伪造
public List<Document> search(String tenantId, String query) {
    return repository.search(tenantId, query);
}

正确设计是从可信认证上下文提取调用者身份:

java 复制代码
public List<Document> search(AuthenticatedPrincipal caller,
                             String query) {
    return repository.searchAuthorized(
        caller.tenantId(), caller.userId(), query
    );
}

这里 AuthenticatedPrincipal 与 repository 是业务抽象,不是 Spring AI 内置类。Server 必须先验证 JWT/OAuth2 令牌的签名、issuer、audience、过期时间和权限,再构建 Principal;绝不能让模型生成 Principal。

三、三种会话隔离方案如何选择

模式 Session 必须满足
共享 Client + 无状态 Server 共享 每次请求鉴权,无用户会话状态
共享 Client + 按身份隔离状态 共享 状态读写按用户/租户授权
每用户/租户独立 Client 独立 自行管理连接生命周期,仍需逐请求鉴权

官方说明自动配置 Bean 不适合需要独立用户 Session 的场景。独立 Session 需要程序自行创建 Transport 和 Client,并负责关闭、回收、限流;不要假设 Spring AI 默认提供按用户池化。

3.1 先关掉自动暴露工具,再建立授权网关

xml 复制代码
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-mcp-client</artifactId>
</dependency>
yaml 复制代码
spring:
  ai:
    mcp:
      client:
        enabled: true
        type: SYNC
        request-timeout: 20s
        toolcallback:
          enabled: false

上面示例假设版本由 Spring AI BOM 管理。toolcallback.enabled=false 可关闭 MCP 工具回调自动集成,但不会自动建立权限控制;需要业务代码显式选择可暴露工具并在调用前授权。

3.2 工具网关骨架

java 复制代码
public record ToolRequest(
    String toolName, String resourceId,
    Map<String, Object> arguments) {}

public interface ToolPolicy {
    void authorize(AuthenticatedPrincipal caller,
                   ToolRequest request);
}

public final class GuardedToolGateway {
    private final ToolPolicy policy;
    private final McpInvoker invoker;

    public GuardedToolGateway(ToolPolicy policy, McpInvoker invoker) {
        this.policy = policy;
        this.invoker = invoker;
    }

    public Object execute(AuthenticatedPrincipal caller,
                          ToolRequest request) {
        policy.authorize(caller, request);
        return invoker.call(caller, request);
    }
}

McpInvoker 是本文自定义的抽象,用于封装真实 MCP Client 调用。该骨架不是可直接启动的完整 Spring AI 项目;必须保证所有工具调用都经过网关,且 MCP Server 端仍独立执行资源鉴权,避免绕过客户端。

四、两种最容易遗漏的共享状态

4.1 服务端发起的交互

MCP 允许服务端发起部分交互,例如 sampling 和 elicitation。共享 Session 的服务端发起请求可能无法单凭 Session 确定用户归属。需要在可信业务层绑定请求 ID、用户、租户、操作摘要、超时和一次性审批记录。

危险做法: 将共享 Session 上的审批请求随意发给当前在线用户,或者把模型自行生成的"用户已同意"视为授权。

4.2 工具清单与权限缓存

如果工具可见性因用户而异,却只按 serverId 缓存 tools/list,可能让不同用户看到错误的工具信息。缓存只能保存身份无关的工具定义,或者按用户/租户/权限版本分区并设置失效策略。不要把原始 Bearer Token 写进日志或长期缓存。

五、设计一组能够暴露串租户问题的测试

测试 操作 预期
正常读取 A 读 A 的文档 允许
越权读取 A 读 B 的文档 拒绝
会话污染 A 设置当前目录,B 再读取 B 不可见 A 状态
并发交错 A/B 同时调用同一工具 无数据交叉
工具发现差异 初始化 A,后续 B 调用 B 无法执行未授权工具
Token 过期 Session 仍然存活 新调用拒绝
参数伪造 模型传 tenantId=B 不改变真实身份
Server 重启 Session 失效后重连 重新鉴权,无旧状态泄漏

5.1 最小授权测试骨架

java 复制代码
@Test
void rejectCrossTenantRead() {
    AuthenticatedPrincipal alice =
        new AuthenticatedPrincipal("alice", "tenant-a");
    ToolRequest request = new ToolRequest(
        "document.read", "tenant-b:doc-42", Map.of());

    assertThrows(AccessDeniedException.class,
        () -> gateway.execute(alice, request));
    verifyNoInteractions(invoker);
}

这里 AuthenticatedPrincipal 是业务 record,gateway 和 invoker 是 Mockito 测试夹具。该片段需要 JUnit 5、Mockito、Spring Security 与业务策略实现才能编译。重点断言是:拒绝授权后根本没有发起远程工具调用。

集成测试可使用一个故意按 Session 存 currentTenant 的模拟 MCP Server,让 A、B 交错操作,对比共享 Client 和隔离 Client 的行为。不要使用生产 Token 或客户数据测试。

六、生产落地的四道防线

身份: 每次 Tool Call 验证 issuer、audience、签名、过期时间和 scope,不信任模型传入的 tenantId。

权限: 客户端网关与 Server 双重校验,尤其是导出、删除、发送通知等写操作。高风险动作必须由可信后端审批,不能仅靠提示词约束。

隔离: 明确 Session、tools/list、缓存、工作目录、订阅和审计的归属;未知第三方 Server 优先做隔离评估。

恢复: Session 失效、HTTP 404、Token 轮换后安全重建连接;有副作用的 Tool Call 需要幂等键,避免超时重试重复执行。

七、常见误区与版本边界

  • "传不同 Token 就隔离了":只代表请求身份可能不同,不保证 Session 状态隔离。
  • "tools/list 不显示就不能调用":隐藏清单不等于授权,Server 必须独立检查。
  • "提示词写明租户就安全":提示词不能替代可信的身份和数据层权限。
  • "每个用户都必须独立 Client":无状态、逐请求授权的 Server 可以安全共享,关键是验证其行为。

本文以 Spring AI 1.1 参考文档为主要依据,不把 SNAPSHOT 文档特性当作稳定发布 API;第三方 MCP Server 的实现可能不同,实际依赖版本与传输方式必须核实。

结论: MCP 多租户安全首先是身份、会话状态与工具权限的边界问题。先弄清 Client 生命周期,再决定共享或隔离 Session,并通过交错并发测试验证,才能避免把模型工具接入变成数据越权入口。

八、官方参考

相关推荐
chh5639 小时前
从 BERT 到大模型:让模型从“会接龙”到“会回答
人工智能·深度学习·bert
TomEval10 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
ZhengEnCi10 小时前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程
Resean022311 小时前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿11 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
GitCode官方11 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
老金带你玩AI12 小时前
GPT-6.2更强更便宜了,为什么还有人骂?
人工智能
CyrusYiVPP12 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
泯泷12 小时前
OpenClaw 退潮背后,是 AI 圈“技术自嗨”的终结
人工智能·chatgpt·llm