# 网络与安全
> 传输加密、数据处理方式与接入时的网络建议
> 密钥如何保管、如何在网络上传输
> 排查连接问题见[常见问题](faq.html)
## 传输安全
- 全部接口通过 HTTPS 提供，**不要在客户端关闭证书校验**（TLS 校验保持开启）
- Key 通过 `Authorization: Bearer` 头传递，不要放进 URL 查询参数
- 网关会拒绝查询参数形式的密钥，返回认证错误
只走 443 端口，全部 TLS，不需要开放其他端口：
| 域名 | 端口 | 协议 |
|---|---|---|
| `api.oairoute.com` | 443 | HTTPS |
| `ark.oairoute.com` | 443 | HTTPS |
流式响应用的是长连接，中间代理如果有「空闲超时」设置，要调到 5 分钟以上，否则长回答会被中途切断。
## 数据处理
- 网关只转发请求与响应，不修改模型输入与输出，也不会注入与业务无关的内容
- 请求内容会转发到对应的上游模型厂商
- 用量记录保存请求的元数据：时间、Key 标识、模型、token 数、费用、耗时与状态，用于计费与排障
- 请求与响应正文仅用于完成本次调用
- 生成结果的 URL 有有效期，过期后自动失效
> **Note:** 不要把密钥、身份证号、银行卡号这类敏感信息写进提示词。请求内容要经过上游处理，这不在平台的完全控制范围内。
## 密钥安全
- Key 只在创建时完整显示一次，之后只能看到前缀，**丢了就重新建一把**
- 不要写进代码。用环境变量或密钥管理服务，前端代码里的 Key 等于公开
- 不要提交进仓库。把 `.env` 加进 `.gitignore`；已经提交过的，光删掉不够，历史记录里还在，必须轮换
- 按环境分开。开发、测试、生产各用各的 Key，一个泄露不影响其他
- 定期轮换，尤其是有人员变动时。轮换前先建新 Key 并切换，确认稳定后再删旧的
- 服务端集成建议用固定出口 IP，便于在控制台配置白名单
- 发给他人或嵌入前端的 Key，建议单独创建并设置额度上限，出问题可以单独吊销
**泄露了怎么办：**
1. 立刻在控制台删除泄露的 Key
2. 建新 Key 替换到各处
3. 查用量接口，看泄露期间有没有异常调用
4. 检查代码历史，确认没有其他硬编码
删除是立即生效的，但已经发生的调用费用不会退还，只能从用量记录里追查范围。
## 账户安全
- 用强密码，不要与其他站点复用
- 定期在控制台检查「令牌」列表，删掉不再使用的 Key
- 开启低余额提醒，异常消耗能更早发现
- 团队协作时按人分 Key，不要共用一个，便于追溯
## 代理与防火墙
企业内网如果走统一出口，需要放行 `api.oairoute.com` 与 `ark.oairoute.com` 的 443 出站流量。
如果用的是 HTTP 代理，注意流式请求可能被缓冲，表现为「等了很久然后一次性吐出全部内容」。解决方式是在代理配置里对这两个域名关闭响应缓冲。
## 网络建议
**超时设置**：客户端超时建议不低于 60 秒。长文生成与推理模型耗时更久，建议按场景放宽。流式模式按事件间隔判断超时，而不是按总时长——有数据持续返回就说明连接正常。
自建服务可以参考这组配置：
| 配置 | 建议值 |
|---|---|
| 请求超时 | 非流式 60 秒，流式首 token 30 秒 |
| 连接超时 | 10 秒 |
| 最大重试 | 2 次，只对 5xx 与超时 |
| 并发上限 | 先用 5，按 429 情况调整 |
| TLS 校验 | 保持开启 |
**重试策略**：遇到 429 按 `Retry-After` 等待，不要立即重试，详见[错误码与限流](errors.html)。
## 审计
需要审计能力时，在自己的服务侧记录每次调用的：
- 调用时间与耗时
- 使用的模型与 Key 标识
- 输入输出 token 数
- 状态码与错误类型
平台侧的用量接口能提供聚合数据，但细到单条请求的记录要在自己的网关层留。
## 报告安全问题
发现漏洞或可疑行为，请发送邮件到 [support@oairoute.com](mailto:support@oairoute.com)，我们会尽快处理。请附上复现步骤与影响范围，不要在公开渠道披露细节。