# 安全策略

## 报告问题

请通过 GitHub 的 **Private vulnerability reporting / Security Advisories** 提交：

<https://github.com/dyh886/dsh-llm-net-router/security/advisories/new>

不要在公开 issue 里贴可复现的凭据泄漏路径、完整的请求头或任何 API key。若无法使用 Advisories，请开一个不含细节的 issue，说明“需要私下通道”，维护者会回复联系方式。

## 这个插件的攻击面

插件运行在 Harness 进程内，值得关注的面只有三块：

1. **回环 HTTP API** `POST /llm-net-router/api`
   - 只绑定在 Harness 的 webServer 上；本机回环放行，非回环要求 `Origin` 与 `Host` 同源。
   - 它能读规则、改规则、用已配置的凭据发起探测请求。任何“同源绕过”或“DNS rebinding 后可写规则”的报告都算安全问题。
2. **凭据的读取与落盘**
   - 探测时按 `apiKeyEnv` 从 Harness 的凭据引用取值；插件不把 key 写进规则文件、决策日志或错误信息。
   - 决策日志只记录 `origin+path`，不记录 query（避免 `?api_key=` 落进环形缓冲）。
3. **传输层**
   - `lib/httpclient.js` 自己实现 HTTP(S) 代理与 SOCKS5 握手。TLS 校验、代理认证、重定向边界上的问题都算安全问题。

## 不在范围内

- 中转站自身的客户端校验策略，以及“如何绕过它”的对抗性研究
- 用户在本机 `$DSH_HOME` 下自行写入的规则文件内容
- 需要先拿到本机任意代码执行能力才能触发的本地提权

## 支持版本

| 版本 | 支持 |
|---|---|
| 0.1.x | ✅ |