必须绕过前端ui直接验证后端权限控制，因前端隐藏可被绕过，真正起作用的只有服务端身份校验与资源归属判断；需依次检查网关认证配置、双身份水平越权测试、反向代理头传递安全性及运行内置审计器全覆盖检测。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要确认AionClaw部署后的API接口是否存在越权访问风险，必须绕过前端UI限制，直接验证后端权限控制逻辑是否生效——因为所有前端隐藏、按钮禁用、菜单折叠都可被绕过，真正起作用的只有服务端对每个请求的身份校验与资源归属判断。
第一步：确认网关是否启用强身份认证
打开 ~/.aionclaw/config.yaml，检查 gateway.authToken 字段是否已配置为32位以上随机字符串。若值为 "test"、"123456" 或为空，【网关将完全不校验身份，任何请求均可直达内部接口】。
同时确认 gateway.bind 值不是 0.0.0.0:8080；若确需外网访问，必须搭配 allowFrom 白名单（如 ["192.168.1.0/24", "2001:db8::/32"]），否则监听全网等于主动开放越权入口。
第二步：构造双身份对比测试请求
准备两个合法用户凭证：
- 用户A（普通权限）：ID为
user_7a2f，能访问自身订单列表/api/v1/orders?uid=user_7a2f - 用户B（同级用户）：ID为
user_8c9d，业务规则明确禁止查看他人订单
使用 curl 发起水平越权探测：
curl -X GET "http://localhost:8080/api/v1/orders?uid=user_8c9d" -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
若返回 HTTP 200 + 正常订单数据，则存在水平越权；若返回 403 或空数组且含 "forbidden_by_policy" 字段，则权限控制有效。注意：不要仅依赖状态码，必须比对响应体内容是否包含本不该出现的他人数据。
第三步：验证反向代理层是否被绕过
若AionClaw前部署了 Nginx，检查其配置中是否缺失关键头传递指令：
错误配置（存在绕过风险）：proxy_pass http://127.0.0.1:8080;
正确配置（必须包含）：
proxy_set_header X-Real-IP $remote_addr;<br> proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<br> proxy_set_header Host $host;
构造伪造请求验证绕过可能性：
curl -X POST "http://your-domain.com/api/v1/execute" \<br>
-H "Host: localhost" \<br>
-H "X-Forwarded-For: 127.0.0.1" \<br>
-d '{"action":"list_users"}'
若该请求成功返回全量用户列表，说明反向代理未做可信头校验，攻击者可借此绕过网关身份识别，直抵后端服务。
第四步：运行内置安全审计器
在部署目录下执行：
aionclaw audit --check auth,rbac,api-permission
该命令会自动扫描以下项：
- 所有
/api/路由是否绑定@require_auth中间件 - 敏感工具调用（如
shell_exec、file_read）是否强制要求role: admin - 资源级接口（如
/api/v1/docs/{doc_id}）是否在 handler 内部执行check_owner(doc_id, current_user.id)
审计结果中若出现 MISSING_OWNER_CHECK 或 UNPROTECTED_ROUTE 标记，对应接口必须立即加固。这一步不能跳过，【人工漏检率高达67%，而审计器可100%覆盖路由注册表】。
