认证与安全

认证流程

LingFlow 采用基于 Token 的认证机制，支持灵活的开发/生产模式切换。 客户端首先通过 REST API 获取 Token，随后在建立 WebSocket 连接时携带 Token 完成身份校验。

图：LingFlow 认证流程概览

认证机制

开发模式 (MODE=development)

开发模式下所有认证请求直接返回成功，无需配置密钥，便于本地快速启动与调试。

• 所有 Token 请求返回 debug-token-{user_id}
• Token 有效期无限
• Origin 检查跳过
• IP 限制放宽
• 适用于本地开发和测试

生产模式 (MODE=production)

生产模式启用完整的认证流程，所有安全防护项均强制生效。

• HMAC-SHA256 Token 签名
• Token 有效期默认 24 小时
• Origin 白名单强制检查
• IP 连接数限制
• TLS 强制（wss://）

认证 API

获取 Token

通过 REST 接口提交用户 ID 与 API Key，服务端校验通过后签发带时效的 Token。

curl -X POST http://localhost:4030/api/auth/token \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"user_id": "user-123"}'

成功响应示例：

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "expires_at": 1720603800,
  "user_id": "user-123",
  "ttl": "24h"
}

WebSocket 连接认证

Token 通过查询参数或 Authorization 头传递，两种方式均受支持。

# 查询参数方式
wss://your-domain.com/chat/session-id?token=your-token

# Authorization 头方式
Authorization: Bearer your-token

安全防护体系

LingFlow 构建了 七层安全防护体系，从连接准入到内容审计全链路覆盖。

1. Token 认证

基于 HMAC-SHA256 的 Token 签名验证，保证 Token 不可伪造、可校验、可失效。

• Token 通过 REST API 获取
• 支持查询参数和 Authorization 头两种传递方式
• Token 具有时效性（默认 24h）
• 生产环境需要配置 WSS_AUTH_SECRET

2. Origin 白名单

防止跨域 WebSocket 劫持（CSWSH），仅允许配置的来源建立连接。

• 通过 WSS_ALLOWED_ORIGINS 配置允许的 Origin 列表
• 开发模式可通过 WSS_ALLOW_ALL_ORIGINS=true 跳过检查
• 生产环境强制检查 Origin

3. IP 连接数限制

防止单 IP 连接泛洪攻击，超出阈值的新连接将被直接拒绝。

• 默认每 IP 最大 10 个连接（WSS_MAX_CONNECTIONS_PER_IP）
• 超出限制的新连接被拒绝
• 连接断开后计数自动释放

4. 帧大小限制

防止恶意客户端发送超大帧耗尽内存，单帧上限默认 64KB。

const defaultMaxFrameBytes = 64 * 1024 // 64KB WebSocket frame cap

5. 速率限制

针对技能创建等敏感操作实施速率限制，避免滥用与暴力调用。

• 每用户每分钟最多 5 次技能创建请求
• 基于 IP + User ID 的双重限流
• 超出限制返回速率限制错误

6. 提示注入检测

针对 #create_skill 命令的双重检测机制，分别在输入层与输出层拦截注入模式。

• 输入层：检测用户输入中的注入模式
• 输出层：检测 AI 生成内容中的注入模式
• 基于正则表达式的模式匹配
• 可选集成 AWS Bedrock Guardrail

输入层检测模式：

var injectionPatterns = []*regexp.Regexp{
    regexp.MustCompile(`(?i)ignore|override|bypass|disregard|forget|cancel`),
    regexp.MustCompile(`(?i)system.*prompt|instructions.*override|hidden.*prompt`),
    regexp.MustCompile(`(?i)secret|password|api.?key|token|credentials`),
    regexp.MustCompile(`(?i)execute|run.*code|eval|shell|command`),
    regexp.MustCompile(`(?i)inject|poison|corrupt|manipulate`),
    regexp.MustCompile(`(?i)read.*file|write.*file|delete.*file|access.*data`),
    regexp.MustCompile(`(?i)role.*play|simulate|pretend|as.*if`),
    regexp.MustCompile(`(?i)evil|malicious|attack|exploit`),
}

输出层检测模式：

var outputInjectionPatterns = []*regexp.Regexp{
    regexp.MustCompile(`(?i)system.*prompt|instructions.*override|ignore.*previous`),
    regexp.MustCompile(`(?i)secret|password|api.?key|token|credentials`),
    regexp.MustCompile(`(?i)execute|run.*code|eval|shell|command`),
    regexp.MustCompile(`(?i)read.*file|write.*file|delete.*file`),
    regexp.MustCompile(`(?i)rm\s+-rf|sudo|chmod|curl.*pipe|wget.*pipe`),
    regexp.MustCompile(`(?i)