Kiro Gateway 安全要点凭据保护、API密钥配置与合规风险提示【免费下载链接】kiro-gateway Proxy API gateway for Kiro IDE CLI (Amazon Q Developer / AWS CodeWhisperer). Use free Claude models with any client.项目地址: https://gitcode.com/gh_mirrors/ki/kiro-gatewayKiro Gateway 是一款免费的 Kiro API 代理网关可将 Kiro IDE / CLI 的 Claude 模型开放给任意 OpenAI、Anthropic 兼容客户端使用。正因为它处理你的Kiro 凭据与API 密钥安全配置是使用前必须搞懂的三件事凭据如何存放与刷新、PROXY_API_KEY 如何正确设置、以及使用免费额度的合规风险。本文用最少代码讲清全部要点。一、先搞懂 Kiro Gateway 的两层密钥设计Kiro Gateway 涉及两套完全不同的钥匙很多人第一次配置时容易混淆密钥作用谁来生成Kiro 凭据refresh token / SSO 缓存网关用它向上游 Kiro API 换取 access tokenKiro IDE / kiro-cli 登录时自动产生PROXY_API_KEY保护你自己的网关客户端连接时必须携带你自己随意发明一个强密码也就是说Kiro 凭据决定能不能调用模型而PROXY_API_KEY决定谁能使用你这个网关。前者来自 AWS 侧后者完全是你自定义的。两层都保护到位才是完整的安全配置。二、凭据存放的三种方式与保护要点网关支持多种凭据来源配置入口都在 .env.example 中给出模板JSON 凭据文件Kiro IDE 用户KIRO_CREDS_FILE指向登录 Kiro IDE 后自动生成的缓存文件如~/.aws/sso/cache/kiro-auth-token.json。kiro-cli SQLite 数据库KIRO_CLI_DB_FILE指向~/.local/share/kiro-cli/data.sqlite3网关会自动识别 AWS SSOOIDC认证。环境变量直填REFRESH_TOKEN直接写入.env简单但安全性最低。要点 1.env与credentials.json绝不要提交到代码仓库。项目已通过 .gitignore 忽略.env、.env.local等文件但如果你在.env里直接填写 refresh token请务必确认该文件不会被同步工具网盘、备份软件意外带出去。要点 2token 自动刷新与回写机制。网关会在 access token 到期前 10 分钟自动刷新阈值定义在 kiro/config.py并把新 token 写回凭据文件实现逻辑见 kiro/auth.py 中的凭据保存方法。如果你同时在使用 kiro-cli两边都会更新同一份数据库建议在.env中开启SQLITE_READONLYtrue让网关只读不回写避免互相干扰——官方注释也明确推荐此用法见 .env.example。要点 3多账号模式下的集中管理。开启ACCOUNT_SYSTEMtrue后首次启动会把.env中的凭据一次性迁移到 credentials.json之后账户统一由该文件管理。多账号文件里可能存放多个 refresh token请把它当作密码本对待放在私有目录、限制读取权限。三、PROXY_API_KEY网关 API 密钥的最快正确配置这是新手最容易踩坑的一项。看 kiro/config.py它的默认值是一个公开的示例字符串my-super-secret-password-123任何人都能在源码里看到。客户端请求/v1/chat/completions时必须携带Authorization: Bearer {PROXY_API_KEY}校验逻辑见 kiro/routes_openai.pyAnthropic 风格接口的x-api-key头同样支持见 kiro/routes_anthropic.py。因此正确配置只有三步复制模板cp .env.example .env把PROXY_API_KEY改成一串你自己发明的长随机密码模板注释特意强调这不是从哪获取的 token要你自己编客户端Claude Code、Cursor、OpenAI SDK 等连接网关时把这个密码填入api_key字段。额外提醒网关默认监听0.0.0.0kiro/config.py即局域网内所有机器都能访问。如果只在自己电脑上用建议在.env设置SERVER_HOST127.0.0.1只允许本机连接从网络层面杜绝未授权访问。四、日志与运行环境的安全习惯风险点说明建议调试日志含完整请求体DEBUG_MODEall会把每一轮对话的完整内容含你的代码写入debug_logs/默认保持off排错时短期开启errors用完关闭Docker 凭据挂载官方推荐以只读方式挂载凭据目录挂载参数带:ro见 docker-compose.yml 的 volumes 配置密钥进入镜像不要把REFRESH_TOKEN、PROXY_API_KEY写进 Dockerfile用docker run -e或--env-file运行时注入容器运行权限官方镜像已内置非 root 用户kiro运行构建自己的镜像时同样避免 root见 Dockerfile五、合规风险使用免费额度前必读 ⚠️这一部分不关技术、只关风险请务必看完可能违反上游服务条款。Kiro Gateway 是与 AWS、Anthropic、Kiro 无关联的第三方个人项目见 README 免责声明。它把 Kiro IDE / CLI 的免费额度转发给其他客户端使用这不属于 Kiro 的官方支持场景理论上存在账号被限流甚至封禁的风险。请用自己的、非主力账号测试重要工作走官方付费渠道。额度与模型会变动。免费层模型名单随订阅层级和时间变化例如 Claude Opus 4.5 已于 2026 年 1 月从免费层移除不要基于永久免费做生产依赖。AGPL-3.0 许可证。本项目采用 AGPL-3.0见 LICENSE个人自用没问题但如果你修改了代码并部署为对他人开放的网络服务必须向用户公开你的完整源码。不要对外商业化分发。把网关架设成公共推理服务卖给第三方同时触及服务条款与许可证双重风险强烈不建议。六、安全配置速查清单 ✅.env与credentials.json已排除在版本控制/备份同步之外PROXY_API_KEY已改为自创的长随机密码不是示例默认值仅本机使用时设置SERVER_HOST127.0.0.1与 kiro-cli 共用数据库时开启SQLITE_READONLYtrueDEBUG_MODE保持offdebug_logs/不长期留存Docker 场景凭据目录只读挂载、密钥经环境变量注入、非 root 运行已阅读服务条款风险说明仅以个人学习/自用为目的只要守住凭据不外泄、密钥不裸奔、端口不敞开、合规有底线这 16 个字Kiro Gateway 就能在安全的前提下帮你省下一笔可观的模型调用费用。【免费下载链接】kiro-gateway Proxy API gateway for Kiro IDE CLI (Amazon Q Developer / AWS CodeWhisperer). Use free Claude models with any client.项目地址: https://gitcode.com/gh_mirrors/ki/kiro-gateway创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考