> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 密钥安全

> Teams OpenAPI 密钥的存储、使用、轮换与泄露应急建议。

Qoder 仅在 **创建 API Key 时** 向用户展示 **完整明文**；后续无法在控制台再次导出同一密钥的原始字符串。密钥在服务端 **安全存储**，不会以明文形式再次提供下载。使用密钥时，请遵循本节原则，降低泄露与滥用风险。

## 授权与能力边界

* 创建密钥时需设定 **过期时间**，建议按实际集成周期选择 **尽量短且可预期** 的期限，到期后轮换。
* 密钥能力 **不高于** 创建者在组织内的权限，且受产品侧 **API 可见范围** 约束；密钥 **不能** 为账号授予额外权限。

## 安全保管

请将 API Key 视为 **密码级** 凭据：

| 做法             | 说明                                 |
| -------------- | ---------------------------------- |
| 勿通过明文邮件、即时通讯群发 | 易被转发与留存，扩大泄露面。                     |
| 勿在命令行历史中长期保留   | 使用环境变量或交互式输入，并注意 shell 历史记录。       |
| 勿提交到 Git 等版本库  | 包括公开与私有仓库；使用 `.gitignore` 与环境变量隔离。 |

## 使用建议

| 做法            | 说明                       |
| ------------- | ------------------------ |
| 使用环境变量或密钥管理产品 | 应用在运行时读取，避免源码内硬编码。       |
| 避免「长期永不轮换」    | 结合过期时间与定期轮换策略。           |
| 按环境拆分密钥       | 开发 / 测试 / 生产分离，缩小单点泄露影响。 |

## 发现泄露或异常时

1. **立即** 在控制台 **删除** 或 **停用** 相关 API Key。
2. **新建** 密钥并更新所有调用方配置。
3. 若怀疑数据已被异常访问，请同步联系组织安全负责人与 Qoder 支持，并提供近期 **`requestId`**（见错误响应）。

<Note>
  最小权限原则同样适用于自动化任务：仅向需要调用的服务发放密钥，并限制可访问密钥的人员名单。
</Note>