防御目标
MCP 工具会将由模型指向的请求连接到能够读取数据、修改记录、执行进程或调用外部服务的系统。在生产环境中,应将每次工具调用都视为跨越信任边界的请求。模型不是授权系统,工具描述也不是安全控制。应在服务器或受保护资源的所有者组件中执行策略,以便统一地检查决策。
本课程将分层控制应用于一个从文档中提取文本的工具。请求可能格式错误、范围过大,或受到不受信任内容的影响。集成组件也可能遭到入侵,或返回旨在误导下游组件的数据。没有任何单一验证步骤能够解决所有这些风险:输入检查、授权、执行隔离、输出处理和运行限制分别应对不同的故障模式。
验证输入和输出
在执行前,根据严格的 schema 验证工具参数。要求字段和类型符合预期,并在可行时拒绝未预期字段,同时强制执行最大路径长度或文档大小等边界限制。schema 验证能够确定数据的形状,但不能确定权限。字符串即使类型正确,也可能指向敏感文件或利用下游解析器,因此应根据操作的实际策略执行语义检查。
对于文件读取工具,应接受文档标识符,或将路径解析到配置根目录之下。规范化路径后,验证解析出的目标仍位于该根目录内;仅检查原始字符串是否以目录名称开头并不足够。应考虑符号链接、特定平台的路径分隔符,以及检查时与使用时之间的竞态条件。优先通过受限目录句柄打开文件,或使用应用层标识符将请求映射到获准对象。
在将结果返回给 MCP 客户端之前验证结果。强制限制输出大小和预期结构,明确处理解码失败,并避免返回机密信息、内部路径或原始异常详情。将提取出的文本视为不受信任的数据:其中可能包含指令或误导性陈述。验证可以确认响应在结构上可接受,但无法确认其内容真实,也无法确认按照其内容操作是安全的。
允许工具并执行授权
仅公开部署所需的工具。应通过明确的允许列表标识获准的工具名称,并在相关情况下标识获准的参数值或资源范围。不要仅依赖不在面向模型的列表中显示某个工具作为唯一限制:请求可能格式错误,不同客户端的行为可能不同,而且必须在调用时检查授权。
将工具可用性与用户授权分开。能够调用文档提取工具的用户,不应因此自动获得读取服务器进程可见的所有文档的权限。在执行前,应根据策略检查已认证主体、请求的资源和操作。集成支持时,应向其传递范围狭窄且生命周期短的凭证或限定范围的能力;避免向每个工具提供通用的服务凭证。
确保允许列表和授权策略可供审查,并进行版本管理。添加第三方集成时,应记录其负责人、用途、所需权限、数据流和故障行为。移除未使用的工具和凭证。记录策略决策时,应包含足够的上下文以便调查,同时排除文档内容、访问令牌和其他敏感值。

隔离执行并限制资源
以完成任务所需的最低权限运行集成。文档提取器不应继承广泛的主机文件系统访问权限、不受限制的网络访问权限或管理员权限。根据威胁模型,使用适当的操作系统或容器隔离边界,仅挂载所需数据,将不必要的文件系统设为只读,并限制出站连接。仅有容器并不构成完整的沙箱;其配置、主机内核、挂载的机密信息和运行时权限决定了其大部分防护能力。
在平台支持的情况下,为时间、内存、CPU、进程数量、文件大小和临时存储设置资源限制。终止超过截止时间的工作,并确保清理临时文件。对于远程第三方服务,隔离还包括限制发送的数据、验证目标身份、核实传输安全性,以及定义故障或超时的处理方式。如果较小的摘录或经过批准的标识符已经足够,应避免发送完整文档。
有意设计故障行为。对于敏感操作,超时或无效响应应采取默认拒绝策略:不要悄悄替换为未经验证的结果,也不要继续使用权限更广的备用凭证。向调用方返回受控错误,在受保护的日志中保留诊断细节,并避免在工具响应中暴露堆栈跟踪或机密信息。
速率限制与运维防护措施
应针对每个主体和工具分别应用限制,而不只是设置一个全局阈值。限制并发工作数、时间窗口内的请求数、输入大小以及高成本操作。根据预期工作负载和资源成本选择阈值,然后监控拒绝率和延迟。突发流量额度可以支持正常流量,而并发上限则可防止少数缓慢调用占用所有工作进程。
速率限制可以减少滥用和意外过载,但不能替代授权或沙箱。使限制行为保持可预测:对于超出限制的工作,使用清晰且不含敏感信息的错误进行拒绝或延迟处理,并避免会放大负载的重试循环。如果客户端会重试,应使用有上限且带退避机制的重试,并确保会改变状态的操作具备适当的幂等性处理。
对于不受信任的集成或第三方集成,应维护所有权和版本信息,固定依赖版本或审查依赖更新,并在上线前测试变更。监控工具调用量、超时、验证失败、被拒绝的资源以及异常的输出大小。针对有意义的偏差发出告警,并确保能够禁用集成或撤销其凭证。日志应支持事件响应,同时避免成为敏感数据的另一份副本。
实践审查与常见故障
审查一次从请求到响应的完整调用。确认格式错误的参数会在产生副作用之前被拒绝;有效参数仍会根据调用方的权限进行检查;该过程无法访问无关的文件或网络;并且返回的数据受到大小限制且经过检查。测试路径遍历、符号链接、超大文档、无效编码、响应缓慢的集成、格式错误的响应以及重复请求等边界情况。
常见的失败方式包括把 schema validation 当作授权、信任模型生成的路径、为方便起见而向工具授予过于宽泛的凭据,以及假设容器天然安全,或者将第三方的原始输出作为可信指令返回。另一个运营层面的错误是为了调试而记录完整的参数和响应,这可能暴露敏感信息。默认进行脱敏,只保留安全监控所需的字段。
生产环境的控制措施应当有明确的负责人和验证方法。对于每项控制措施,说明其阻止的风险、实施位置,以及哪些证据能够证明其正在发挥作用。确认未授权路径被拒绝的测试,比一份仅仅声称限制了路径的策略文档更有价值。当工具代码、权限、依赖项或部署边界发生变化时,应重新执行这些检查。
课程检查点
巩固所学知识,获取作业反馈。