Nexus/docs/changelog/2026-05-24-agent-api-key-auth-fix.md

2026-05-24 Agent API Key 验证修复

日期: 2026-05-24 动机: Agent 4 个端点（/exec、/exec/kill、/exec/wait、/config/reload）的 API Key 认证完全失效，属于 P0 安全 Bug 变更摘要:

• verify_api_key() 从手动调用改为 FastAPI Depends() 依赖注入
• 修复调用时 x_api_key 被误传给 request 参数导致认证永远失败的问题
• 将 verify_api_key 改为 async 以符合 FastAPI 依赖规范

涉及文件: web/agent/agent.py

是否需迁移: 否

验证方式: 向 Agent 发送带错误 X-API-Key 的请求应返回 401；不带 key 返回 401（422 若 Header 缺失）；正确 key 正常通过