Hermes Agent防SQL注入需五重防护：一、强制参数化查询；二、输入白名单校验与净化；三、最小权限账户与环境隔离；四、提示注入与上下文扫描检测；五、WAF规则与执行计划监控协同防护。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用Hermes Agent处理用户输入并执行数据库操作，但担心恶意SQL代码可能被注入执行，则可能是由于未对输入进行安全隔离或未采用防御性查询机制。以下是针对Hermes Agent防止SQL注入攻击的具体防护措施：
一、强制使用参数化查询
参数化查询将SQL语句结构与用户数据严格分离，确保输入内容始终被数据库引擎视为纯数据而非可执行指令，从根本上阻断注入路径。Hermes Agent在hermes_state.py等核心状态管理模块中已明确要求所有数据库交互必须采用占位符方式绑定参数。
1、定位所有直接拼接SQL字符串的代码段，例如cursor.execute("SELECT * FROM sessions WHERE user_id = " + user_id)。
2、将其替换为参数化形式：cursor.execute("SELECT * FROM sessions WHERE user_id = ?", (user_id,))。
3、对多参数查询统一使用元组或字典传参，如cursor.execute("INSERT INTO logs VALUES (?, ?, ?)", (action, timestamp, session_id))。
4、验证所有SQL执行点是否调用execute或executemany方法时第二个参数为非空序列或映射对象。
二、实施输入白名单校验与参数净化
在SQL执行前对用户输入进行结构化约束，仅允许符合预定义格式的值通过，避免依赖黑名单过滤的不可靠性。Hermes Agent已在tools/image_generation_tool.py中实现类似机制，可复用于数据库上下文。
1、为每个数据库字段定义合法输入范围，例如user_id仅接受长度≤32的字母数字组合。
2、调用_sanitize_id函数（位于honcho_integration/session.py）对会话标识类参数进行字符清洗：re.sub(r'[^a-zA-Z0-9_-]', '', id_str)。
3、对全文检索关键词使用FTS5专用转义函数，防止MATCH子句中出现通配符滥用或逻辑绕过。
4、禁止将用户输入直接用于ORDER BY、GROUP BY或表名/列名动态构造场景；确有需要时，仅从预置枚举列表中映射获取。
三、启用最小权限数据库账户与执行环境隔离
限制数据库连接账户的操作边界，即使注入成功也无法执行高危指令，大幅压缩攻击面。该策略在Hermes Agent部署规范中被列为强制性配置项。
1、为应用创建专用SQLite数据库文件，并设置操作系统级读写权限为600（仅属主可读写）。
2、若使用外部数据库（如PostgreSQL），为Hermes Agent分配仅具备SELECT、INSERT、UPDATE权限的角色，显式拒绝DROP、ALTER、EXECUTE等权限。
3、禁用数据库错误详情回显，在hermes_state.py初始化连接时设置sqlite3.connect(..., check_same_thread=False)并捕获异常后返回泛化错误消息。
4、在终端命令调用链中（如tools/file_operations.py），避免通过os.system或subprocess.Popen执行含SQL逻辑的shell脚本；确需调用，必须经_escape_shell_arg方法转义全部参数。
四、集成提示注入与上下文扫描双重检测
利用Hermes Agent内置的提示注入识别能力，对参与SQL构建的自然语言上下文进行前置扫描，拦截潜在的指令混淆攻击。该机制覆盖从用户query到数据库查询生成的完整链路。
1、在agent/prompt_builder.py中调用scan_context_for_injection函数，对包含SQL意图的用户输入片段进行关键词与模式匹配。
2、识别并阻断常见注入特征，如' OR '1'='1、UNION SELECT、; DROP TABLE、--及base64编码的SQL片段。
3、对检测到可疑内容的请求，自动触发降级逻辑：改用预编译模板查询、返回空结果集或抛出受控异常，不进入真实数据库执行阶段。
4、记录所有触发扫描拦截的原始输入至审计日志，字段包括时间戳、会话ID、客户端IP及净化后上下文快照。
五、部署WAF规则与执行计划监控协同防护
在应用层之外叠加网络层防护，并结合SQLite执行计划分析持续验证查询安全性，形成纵深防御闭环。此方案不修改业务代码，适用于快速加固已有部署。
1、在反向代理或云WAF中配置规则，拦截含SELECT.*FROM、INSERT INTO.*VALUES、EXEC等敏感模式且无合法Referer头的HTTP请求。
2、对所有数据库查询语句前缀添加EXPLAIN QUERY PLAN，定期采集输出结果，识别是否存在全表扫描、临时表创建或未命中FTS5索引的情况。
3、将高频慢查询（执行时间＞100ms）自动归档至slow_queries.db，供安全团队人工复核是否存在隐式拼接痕迹。
4、在CI/CD流水线中嵌入SQL静态分析步骤，使用sqlfluff或自定义正则扫描源码，禁止提交含".format("、%s、f"SELECT等危险模式的Python文件。
