Skip to content
已上线内部管理员管理

安全说明 ​

Electron 安全 ​

桌面端遵循 Electron 安全最佳实践:

配置项要求说明
nodeIntegration禁用渲染进程不可直接访问 Node.js API
contextIsolation启用主进程与渲染进程上下文隔离
webSecurity生产环境启用防止跨域攻击

IPC 通信规范 ​

  • 通道命名:模块:操作(如 store:get、window:minimize)
  • 数据序列化:所有 IPC 数据必须可 JSON 序列化
  • 敏感配置(API Key 等)存储于主进程,通过 contextBridge 暴露安全 API
javascript
// preload.js 安全暴露示例
contextBridge.exposeInMainWorld('electronAPI', {
  store: {
    get: (key) => ipcRenderer.invoke('store:get', key),
    set: (key, value) => ipcRenderer.invoke('store:set', key, value),
  }
})

认证安全 ​

JWT Token 管理 ​

  • Token 通过 SSO 登录获取,存储于 SessionStorage
  • Token 有效期由服务端控制
  • 每次 API 请求通过 Axios 拦截器自动注入 Bearer Token

SSO 集成 ​

  • 集成讯飞集团 CAS SSO
  • Electron 端通过拦截 Ticket 回调完成认证
  • Web 端通过标准 CAS 流程

代码安全 ​

禁止事项 ​

  • 硬编码 API Key、密钥等敏感信息
  • 在渲染进程使用 Node.js API
  • 在 Electron 内直接加载外部链接(应使用系统浏览器)

必须事项 ​

  • 用户输入做 XSS 过滤(尤其是 Markdown 渲染场景)
  • 外部链接使用 shell.openExternal() 打开
  • 敏感操作需用户确认(Agent 自主权 L3 级别)

Agent 安全 ​

自主权阶梯 ​

级别说明安全要求
L0仅建议无风险
L1可逆动作写文档、草拟 PR
L2可回滚动作创建分支、提 PR
L3高风险动作发版、删除 — 需用户确认

Agent 工作区安全 ​

  • 所有 Agent 配置文件(AGENTS.md、SOUL.md 等)不得包含密码、Token、密钥
  • Agent 修改自身配置必须可回滚、可追踪
  • 敏感操作在 AGENTS.md / SOUL.md 中明确标记「禁止」或「须确认」

记忆安全 ​

  • Memory Hub 通过 JWT 认证所有 API 请求
  • 记忆按用户/组织/全局三级隔离
  • 记忆插件内置敏感信息过滤
  • 个人 API Token 支持独立生成和撤销

部署安全 ​

  • Helm values 中的敏感配置使用 Kubernetes Secret
  • 容器镜像使用多阶段构建,减小攻击面
  • 生产环境启用 HTTPS
  • 数据库连接使用加密传输

WARNING

在任何配置文件、Agent 工作区文件、记忆内容中,都不应出现明文密码、API Key、Token 等敏感信息。

最后更新: