agents-cli 部署安全完整指南如何用 IAP 身份感知代理与 IAM 最小权限保护你的 AI 智能体【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cliagents-cli 部署安全是 AI 智能体上生产环境绕不开的核心议题。agents-cli 是 Google 官方提供的 CLI 工具与技能集能把任意编程助手变成在 Google Cloud 上创建、评估和部署 AI 智能体的专家。它的部署链路自带两道安全防线**IAPIdentity-Aware Proxy身份感知代理**负责谁能访问per-agent 专属服务账户 IAM 最小权限负责能做什么。本文带你快速理解这两层机制及其落地方式。一、为什么部署安全是 AI 智能体的第一风险 一个部署在公网的 AI 智能体本质上是一个会自动调用模型、读写数据、执行动作的服务。风险集中在两点谁在调用它默认公开入口意味着任何人都能消耗你的 token、触发它的工具调用它能做什么如果智能体拿着一个万能钥匙式的凭据运行一旦代码被注入或逻辑被诱导影响面会极大。agents-cli 的设计思路是把这两点分别交给 Google Cloud 的两个成熟能力IAP 挡在门口最小权限的 IAM 角色锁住手脚——而且两者都通过一条部署命令和一套脚手架模板自动完成不需要改业务代码。二、一键开启 IAPagents-cli deploy --iap 完整步骤IAP 是部署在智能体前面的身份感知代理层。开启后只有完成 Google 身份认证的授权用户/服务才能到达智能体其余请求在边缘就被拒绝。启用 IAP 的三步操作完成 agents-cli 脚手架生成并确认目标为 Cloud RunIAP 目前仅支持 Cloud Run 部署目标执行部署命令并追加--iap标志agents-cli deploy --iap在 Google Cloud 控制台的 IAM 授权中为团队分配 IAP 访问者角色即可正常访问。对应实现见 cmd_deploy.py--iap是一个独立的布尔开关部署时会被透传给底层gcloud run deploy整个过程不产生任何需要手写的 Terraform 变量。官方技能文档中的说明位于 cloud-run.mdIAP (Identity-Aware Proxy) can be enabled by runningagents-cli deploy --iap(Cloud Run only), which adds Google identity authentication without code changes.要点IAP 是零代码改动的身份层——智能体应用本身不需要感知认证逻辑接入成本几乎为零。三、隐藏的第二道防线--no-allow-unauthenticated 很多人不知道agents-cli 在 Cloud Run 部署时无条件追加--no-allow-unauthenticated参数见 cmd_deploy.py同时按需透传--service-account指定运行身份。这意味着参数作用安全收益--no-allow-unauthenticated关闭未认证访问匿名流量永远到不了智能体--service-account email指定智能体运行身份身份可审计、可单独回收即使你忘记加--iap未认证请求也默认被拦截属于fail-closed默认收紧的安全姿态。四、per-agent 专属服务账户脚手架自动生成 agents-cli 脚手架会在 Terraform 模板中为每个智能体项目单独创建一个应用服务账户而不是共享默认 SAService Account。核心定义位于共享模板 iam.tf账户命名{项目名}-app显示名为{项目名} Agent Service Account——账户与智能体一一对应审计日志里一眼就能定位是哪个智能体产生的行为绑定部署Cloud Run 服务通过service_account google_service_account.app_sa.email明确引用该账户见 service.tf。per-agent 隔离的价值下线某个智能体时只需删除/禁用它自己的 SA其他智能体完全不受影响攻击面随资产规模线性可控而不是牵一发而动全身。五、最小权限清单app_sa_roles 默认授予什么创建 SA 之后脚手架通过app_sa_roles变量为它分配角色variables.tf。默认清单是精心裁剪过的覆盖跑智能体所需的最低集合角色用途roles/aiplatform.user调用 Gemini / Vertex AI 模型roles/logging.logWriter写日志roles/cloudtrace.agent上报调用链追踪roles/storage.admin读写遥测/完成日志桶roles/serviceusage.serviceUsageConsumer消费已启用的 APIroles/cloudsql.clientroles/secretmanager.secretAccessor仅当选择cloud_sql会话类型时追加roles/bigquery.dataOwnerroles/bigquery.jobUser仅当开启 BQ 遥测分析时追加注意最后两行的条件追加权限跟随功能开关按需扩展而不是全量预授。这正是 IAM 最小权限Least Privilege的典型工程化实践——每多一项能力才多给一个角色。六、组合拳IAP 专属 SA 入口收紧的最佳搭配 ️单独使用任何一项都不够agents-cli 鼓励三者叠加IAPdeploy --iap解决谁能访问智能体Google 身份认证前置per-agent 服务账户解决智能体以谁的身份运行隔离与可审计入口策略ingressservice.tf默认INGRESS_TRAFFIC_ALL公开可改为INGRESS_TRAFFIC_INTERNAL_ONLY仅 VPC或INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER内部GCLB把智能体完全关进内网——配置位置见 service.tf 与文档 cloud-run.md。一个推荐的组合外部用户 →IAP 认证→ 内网入口 → 以最小权限 SA运行的智能体。任何一环失守其余环节仍能兜底。七、延伸阅读与关键文件索引 文件说明cmd_deploy.pydeploy命令全部安全相关参数--iap、--service-account等iam.tfper-agent 服务账户与角色绑定模板variables.tfapp_sa_roles最小权限默认清单cloud-run.mdCloud Run 网络与入口策略参考SKILL.md部署技能IAP、资源配额与生产化建议lifecycle.md智能体完整生命周期开发 → 部署 → 运维总结agents-cli 的部署安全模型可以浓缩为一句话用--iap把智能体锁在 Google 身份后面用自动生成的 per-agent 服务账户和条件化的app_sa_roles把它的权限压到最低。整套机制由脚手架模板与部署命令默认生效无需手写 IAM 配置新手也能在一条命令内获得生产级的访问控制与最小权限隔离。【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考