使用Taotoken管理API Key并设置访问权限与审计日志
1. 创建API Key
在Taotoken控制台中创建API Key是接入平台的第一步。登录后进入「API密钥」管理页面，点击「新建密钥」按钮即可生成具有唯一标识的访问凭证。系统会同时显示密钥的完整字符串（仅此次可见）和前缀标识符，建议立即复制保存至安全位置。
密钥创建时可添加描述信息，例如客服机器人生产环境或数据分析团队-张工，便于后续识别用途。每个账户默认可创建50个活跃密钥，满足多场景隔离需求。密钥生成后无法通过控制台查看完整内容，若遗忘需重新创建。
2. 设置访问权限
2.1 基础权限控制
创建密钥时可设置以下基础权限：
- 模型白名单：限定该密钥只能访问指定模型（如仅允许调用
claude-sonnet-4-6） - IP白名单：填写允许发起请求的IP或CIDR范围（支持IPv4/IPv6）
- 有效期：设置绝对过期时间或相对有效期（如30天后自动失效）
权限配置支持后期修改，变更将在1分钟内生效。例如开发初期可开放全部模型权限，上线前再通过编辑功能收紧限制。
2.2 高级频率限制
在「高级设置」中可配置精细化流量控制：
{ "rate_limit": { "requests_per_minute": 100, "tokens_per_minute": 50000 } }该配置表示每分钟最多接受100次请求且累计消耗不超过5万token。超出限制的请求会立即收到429 Too Many Requests响应。建议根据业务峰值需求设置合理阈值，避免突发流量被拦截。
3. 团队协作管理
对于团队使用场景，Taotoken提供两种协作模式：
子账户体系（适合中小团队）
- 主账户创建子账户并分配特定权限
- 子账户独立登录后只能查看和管理自己被授权的密钥
- 权限粒度包括「可读」「可创建」「可删除」三级控制
项目组模式（适合复杂架构）
- 创建项目组并添加成员
- 在项目组内生成共享密钥
- 通过自定义角色定义每个成员的管理权限
所有协作操作均记录在审计日志中，包括操作人、时间、具体行为等信息。
4. 审计日志与监控
4.1 日志查看
在「审计日志」页面可按以下维度筛选记录：
- 时间范围（支持最近7天/30天/自定义）
- 关联的API Key（支持前缀模糊搜索）
- 操作类型（创建/删除/修改/调用）
- 状态码（成功/失败详情）
关键日志字段示例：
[2024-03-15 14:30:22] Key: tk-abcd1234*** | IP: 203.0.113.45 Model: claude-sonnet-4-6 | Status: 200 | Tokens: 1284.2 异常告警
开启「安全告警」功能后，以下事件会触发通知：
- 单日token消耗超过预设阈值
- 高频认证失败（可能遭遇暴力破解）
- 从未登记IP发起的请求
- 调用已禁用模型的尝试
通知渠道支持站内信、邮件和Webhook，建议至少配置两种接收方式确保及时响应。
5. 最佳实践建议
- 环境隔离：为开发、测试、生产环境创建独立密钥，避免相互影响
- 定期轮换：每3-6个月更新一次关键业务密钥，旧密钥保留24小时后停用
- 最小权限：遵循最小授权原则，非必要不开放全模型权限
- 日志归档：每月导出一次完整审计日志到自有存储系统长期保存
遇到密钥泄露风险时，应立即停用相关密钥并在「安全中心」发起全账号密钥扫描，系统会标记出所有近期使用过该密钥的客户端IP地址。
Taotoken 控制台持续优化密钥管理体验，最新功能以实际界面为准。
