Appearance
安全说明
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 等敏感信息。
