首页 / 文档中心 / API文档

安全体系总览

多层安全防护

Neurova 从多个层面确保系统安全性:

层面机制
传输安全JWT Bearer Token 认证
访问控制基于角色的权限管理 (admin/user)
入口防护IP 黑白名单、速率限制、输入检测
数据脱敏API Key、Token、密码等敏感信息自动替换
用户隔离ContextVar 三层(agent/neuser/user)硬隔离
Agent 隔离可配置的 Agent 间沙箱隔离
文件保护敏感文件类型和路径自动拦截
信任域LLM 和模型服务内部流量不受防火墙限制

L0: 入口守护

JWT 认证

所有 API 请求必须携带有效的 JWT Token:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

IP 访问控制

  • IP 黑白名单,按来源 IP 控制访问
  • 全局速率限制,防止恶意请求
  • 输入安全检测:Prompt 注入、SQL 注入、命令注入、路径遍历

MCP 治理

MCP 集成层通过 P0-1~P0-6 六项安全治理加固:

  • 路由器鉴权(stdio 仅 admin)
  • shell 拒绝表 + 命令白名单
  • 防火墙收敛进 call_tool 主路径
  • 全参数扫描(scan_all)+ 分级 fail-closed
  • 防火墙身份按请求穿透(ContextVar)
  • SSRF 防护(url_guard:私网/环回/链路本地)

三层隔离

  • Agent 隔离 (agent_id):不同 Agent 的数据完全隔离
  • 系统用户隔离 (neuser_id):不同系统用户的数据隔离
  • 对话用户隔离 (user_id):同一 Agent 不同对话用户的数据隔离
  • 跨 Agent 共享 (shared=True):可选的数据共享机制