目录
Amazon Bedrock AgentCore Gateway 的拦截器可以通过调用 Amazon Bedrock Guardrails,遮蔽 MCP 工具参数和结果中的日本个人编号。在所展示的测试中,拦截器发生故障时,请求或响应会被阻断,不会返回未经遮蔽的编号。
要点#
- 为模型调用配置的 Guardrails 不会检查工具的参数、结果和定义。
- Gateway 的 REQUEST 拦截器和 RESPONSE 拦截器可以分别遮蔽参数和结果。
- 日本身份识别号码需要使用自定义正则表达式,并明确支持全角数字。
- 对于需要身份识别号码的工具,应通过访问受限的路径传入号码,并在遮蔽结果后再返回给智能体。
保护工具边界#
仅在 Bedrock Converse 请求中配置 Guardrail,仍会留下防护缺口。敏感信息过滤不会评估 toolUse.input、toolResult、工具描述或架构。因此,身份识别号码可能未经筛查就在模型与工具之间传递。
将工具部署在 AgentCore Gateway 后方,并在两个拦截点配置 Lambda 拦截器。REQUEST 在工具执行前处理参数,RESPONSE 在智能体接收前处理结果。此防护仅适用于经过 Gateway 的调用。
所展示的验证使用了两个 Lambda 工具:get_worker 返回包含身份识别号码的虚构员工信息,register_worker 原样返回收到的参数。工具端日志证实,在注册工具收到参数之前,REQUEST 遮蔽已替换了身份识别号码。
配置遮蔽路径#
配置以下组件。
1. 创建带有自定义正则表达式的 Guardrail,以匹配日本身份识别号码。将 inputEnabled 和 outputEnabled 显式设为 true,并将两项操作均设为 ANONYMIZE。测试中的拦截器在两条路径上均使用了 source="INPUT"。 2. 授予拦截器 Lambda 对该 Guardrail 调用 bedrock:ApplyGuardrail 的权限。授予 Gateway 调用拦截器和目标 Lambda 的权限。 3. 按照测试时的配置,创建使用 IAM 身份验证并禁用响应流式传输的 MCP Gateway。 4. 为 REQUEST 和 RESPONSE 均配置拦截器。仅在拦截器需要时转发请求头。
在 REQUEST 中,递归检查 params.arguments 下的字符串值,并返回 transformedGatewayRequest。如果此时返回 transformedGatewayResponse,则会跳过工具执行。在 RESPONSE 中,检查文本内容和 structuredContent 中的值。
对 tools/call 以外的方法直接放行。测试还确认,处理 initialize 和 tools/list 时也会调用拦截器。使用 IAM 身份验证的客户端需要通过 SigV4 签署请求,并在后续请求中附加协商确定的 MCP-Protocol-Version 请求头。
按工具选择策略#
遮蔽参数会改变工具收到的内容。如果 REQUEST 已将号码替换为 {JP_MY_NUMBER},注册工具就无法保存原始身份识别号码。
| 工具用途 | REQUEST | RESPONSE | |---|---|---| | 搜索文档、汇总报告、获取考勤记录 | 遮蔽 | 遮蔽 | | 注册身份识别号码、按身份识别号码查询记录 | 保留所需的身份识别号码 | 遮蔽 |
对于例外情况,请使用明确指定准确工具名称的允许列表。限制哪些用户和智能体可以调用接收原始身份识别号码的工具。响应遮蔽无法保护已经发送给工具、存入数据库或写入日志的数据。
所展示的测试也证实了这一区别。省略 register_worker 的 REQUEST 遮蔽后,工具收到了原始值,而 RESPONSE 遮蔽替换了返回结果中的身份识别号码。
处理正则表达式和 JSON 的限制#
在所展示的调查中,查阅的 Guardrails 内置 PII 列表没有日本身份识别号码专用类型。部署前请确认最新列表,并按需添加自定义正则表达式。如果可能包含全角数字,请加入 [0-90-9]。仅使用 [0-9] 无法检测出全角数字示例。
自定义正则表达式不支持前瞻和后顾。将周围字符也纳入匹配的表达式,可能在遮蔽时删除标点或 JSON 引号。请解析 JSON 文本并提取值,遮蔽这些值后再重新序列化。对于内部还包含 JSON 的嵌套字符串,需要单独处理。为保留前导零,请将身份识别号码保存为字符串。
正则表达式也会匹配格式相同的业务编号。在 1,950 条合成的制造业相关语句中,测试所用的正则表达式将所有 12 位订单号都检测为个人编号。正则表达式重叠时,部分值会生成多个替换标签。不要将格式匹配视为个人编号的证明,应按工具和字段限定遮蔽范围。
故障时阻断处理,并降低开销#
测试注入了四类故障:无效的 Guardrail ID、Guardrail 权限不足、Lambda 超时以及拦截器调用权限不足。所有情况下均未返回未经遮蔽的身份识别号码。REQUEST 故障阻止了工具执行,RESPONSE 故障则在工具执行后阻止了结果返回。请在自己的部署环境中复现并确认这些行为。
捕获应用程序异常,并返回 -32603 Internal error 等通用 JSON-RPC 错误。在生产环境中,请勿将 Gateway 的异常详细信息设为 DEBUG。测试中,此模式暴露了堆栈跟踪和资源标识符。日志应记录数量和错误类型,而非包含敏感信息的载荷。
测得的拦截器处理时间为:REQUEST 约 150~420 ms,RESPONSE 约 130~280 ms。逐个字符串单独调用会增加延迟,启用内置 PII 检测时还会增加计费用量。请测试批量处理,并限制结果大小。在所展示的测试中,遮蔽约 100 KB 的内容耗时约 10 秒,处理 2.5 MB 及以上的响应时失败。
后续步骤#
将一个工具部署在已配置两个拦截器的 Gateway 后方,使用虚构的身份识别号码,确认参数到达时已被遮蔽、结果返回时已被遮蔽,以及移除 ApplyGuardrail 权限后调用会被阻断。
来源: https://zenn.dev/aws_japan/articles/49bf6abcee64bc
目录
