应启用API Key作用域隔离、IP白名单与Referer限制、密钥时效性与自动轮换、项目级上下文隔离及操作审计日志五项措施，实现细粒度权限管控与风险防控。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在企业环境中部署Qoder并开始接入内部代码库与敏感服务，但尚未对API Key及项目私密信息实施细粒度权限管控，则可能面临密钥泄露、越权调用或敏感上下文外泄等高风险场景。以下是保障Qoder安全权限配置的具体操作路径：
一、启用API Key作用域（Scope）隔离
通过为每个API Key绑定最小必要权限范围，可确保其仅能访问指定模型、接口或数据源，避免因单一密钥失陷导致全系统暴露。
1、登录Qoder企业控制台，进入“安全中心”>“API凭据管理”页面。
2、点击“新建密钥”，在权限配置区域取消全选默认项。
3、根据业务角色勾选对应scope：例如为CI/CD流水线密钥仅启用infer:qwen3-reranker和read:metrics；为开发IDE插件密钥启用read:repo、write:snippet但禁用admin:config。
4、确认提交后，该密钥将无法调用未显式授权的任何端点，系统返回403 Forbidden并记录审计事件。
二、配置IP白名单与Referer限制
限制API Key仅可在可信网络出口或指定前端域名下生效，从源头阻断跨域盗用与公网暴力探测行为。
1、在“API凭据管理”中定位目标密钥，点击“编辑访问策略”。
2、开启“网络访问控制”，选择“IP白名单模式”并输入企业办公网段，如192.168.10.0/24和2001:db8:abcd::/64。
3、若用于Web前端集成，同步启用“HTTP Referer限制”，填写允许调用的域名前缀，例如https://dev.internal.company.com/*和https://staging.company-app.net/*。
4、保存后，来自非白名单IP或非法Referer的请求将被立即拒绝，并触发安全告警推送至管理员邮箱。
三、实施密钥时效性与自动轮换
设定API Key生命周期并启用平台级自动刷新机制，显著压缩密钥泄露后的危害窗口期，满足等保2.0对凭证时效性的强制要求。
1、在创建或编辑密钥时，勾选“启用有效期控制”选项。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、设置固定有效期为60天，系统将在到期前5个工作日发送邮件与站内信双重提醒。
3、开启“自动轮换”开关，平台将在密钥到期前24小时生成新密钥对，并通过Webhook向企业SIEM系统推送更新事件。
4、旧密钥进入只读降级状态，仅允许调用/v1/keys/self查询自身元信息，所有业务接口调用均返回401 Unauthorized。
四、启用项目级上下文隔离策略
防止Qoder在代码理解、补全或重构过程中意外暴露跨项目敏感信息，确保各业务线代码上下文严格物理隔离。
1、进入Qoder管理后台“项目设置”>“安全策略”，选择目标项目空间。
2、开启“上下文沙箱模式”，系统将自动为该项目分配独立向量索引与缓存命名空间。
3、在“数据源绑定”中，仅关联本项目Git仓库地址与指定分支，禁用全局仓库扫描权限。
4、配置“敏感词屏蔽规则”，添加正则表达式如\b(AKIA[0-9A-Z]{16}|sk-[a-zA-Z0-9]{32})\b，使含密钥字样的代码块在IDE中自动脱敏显示为***。
五、开启操作审计日志与密钥行为分析
记录所有API Key的调用时间、源IP、请求路径、响应状态及生成内容摘要，支撑事后溯源与异常行为识别。
1、在“安全中心”>“审计日志”模块，点击“启用全量日志捕获”。
2、设置日志保留周期为180天，并绑定企业OSS Bucket用于长期归档。
3、进入“行为分析”面板，启用“高频调用检测”，当单密钥每分钟调用超300次时自动触发限流并标记为可疑会话。
4、配置“高危操作告警”，对包含delete、admin、export等关键词的API调用实时推送钉钉机器人通知至安全响应群。
