Skip to content

Security: zzugbb/InsightAgent

Security

SECURITY.md

安全政策与运行边界

InsightAgent 当前有本地实现与契约验证基线,外部试点/生产安全验收尚未完成。本文说明实际保护与部署责任,不构成安全认证、服务等级或版本维护承诺。

公开静态展示

展示站仅包含预设公开记录与图片,无登录、上传、访客 Key、自由提问或完整应用 API / 模型调用。素材提交与发布前按来源说明复核;静态站上线不意味着完整应用可以直接向不可信用户开放。下方鉴权、网络、费用和存储约束针对完整应用。

报告安全问题

请优先使用仓库托管平台已启用的私密漏洞报告渠道。若平台没有私密渠道,先向维护者发送不含敏感细节的联系请求,待获得私密方式后再提供复现。当前未公布专用安全邮箱或响应时限;不要虚构渠道或在公开 issue / PR 中放入可利用载荷、真实凭据、业务数据与数据库备份。

报告应包含受影响提交、脱敏的触发步骤、影响范围和最小示例。仅测试获授权的环境,避免修改他人数据。

已有保护

  • JWT HS256 / header / 过期 / subject 校验,refresh 会话轮换与撤销;生产默认 JWT 和 wildcard CORS 拒绝。
  • 会话、任务和用户设置按用户鉴权;共享知识库普通用户只读、管理员写入。首个注册账号自动为管理员,初始化必须在受控环境完成。
  • 用户 API Key 加密入库,设置接口不返回 Key;HTTP 工具结果、诊断与导出使用既有投影/脱敏。
  • 数据库定位摘要隐藏密码并移除查询参数/片段;健康与 operator 摘要只暴露限定状态。
  • 试点镜像非 root、固定依赖/镜像摘要、构建期 embedding 缓存;模板排除真实 env,试点数据库和 Chroma 不发布主机端口。

部署必须考虑的边界

  • access / refresh token 当前在浏览器 localStorage;可被同源脚本读取,不具备 HttpOnly Cookie 隔离。控制脚本来源与用户访问,HTTPS 由目标入口提供。
  • 注册不是邀请码、SSO 或公网准入系统;没有通用模型 URL 网络白名单。用户模型地址与服务端 HTTP 工具可发起外部请求,部署需限制访问边界和网络出口。
  • 未覆盖全局分布式调用额度、供应商账单限额与所有暴力登录防护。全局默认 Key 可被继承,开放注册前明确凭据归属和费用责任。
  • 数据库中的 Key 为自有 v1 加密格式,不是 KMS / Vault;没有主密钥在线迁移流程。主密钥和数据库备份分开保存,轮换按配置指南评估。
  • Trace、消息、文档和导出仍可能含业务事实;脱敏不能代替业务访问控制。日志、截图和导出分享前需复核。
  • 工具输入、检索资料与模型输出视为不可信。AST 与结果绑定白名单限制执行范围,提示词注入与自然语言误述不能仅靠提示保证避免。
  • 取消/超时不能撤销已发送的外部操作;失败后台导入可能部分写入,先复核再决定重试。

compose.full.yml / docker-compose.yml 是开发文件,loopback 绑定仅对新应用配置生效。禁止未经备份重建旧存储容器。正式部署、升级回滚、备份恢复及 RPO/RTO 需目标环境实测,流程见部署预检与恢复说明。

凭据误提交后的处理

先在供应商/认证系统撤销或轮换凭据,再处理仓库和发布产物;仅删除当前文件不能撤销已经暴露的秘密。涉及 Git 历史清理、强推或删除备份时先与维护者确认影响,不把真实值复制到报告。常见特征扫描无命中不等于完整历史无泄露。

There aren't any published security advisories