You need to enable JavaScript to run this app. 使用`gcloud auth` CLI创建访问令牌时如何设置自定义scopes?
优惠活动
大模型
产品
解决方案
定价
更多

使用`gcloud auth` CLI创建访问令牌时如何设置自定义scopes?

gcloud CLI 生成带自定义Scopes的访问令牌方法

首先明确:gcloud CLI 没有在print-access-token环节暴露scopes参数不是设计遗漏,它的scope配置逻辑和你在Java/Python SDK里看到的运行时动态指定的逻辑不同——CLI将scope绑定放到了凭据初始化/授权登录的环节,最终拿到的带自定义scope的令牌效力和SDK方式完全一致,具体可按你使用的凭据类型选择对应操作:

场景1:使用个人用户账号作为凭据

不管是普通gcloud凭据还是应用默认凭据(ADC),都在登录授权阶段直接指定scopes即可,无需在后续打印令牌的命令中追加参数:

  • 针对普通CLI用户凭据:
  1. 先移除原有不带自定义scope的凭据:gcloud auth revoke 你的账号邮箱@gmail.com
  2. 重新发起登录授权,携带自定义scopes参数:
    gcloud auth login --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/drive.readonly" --no-launch-browser
  3. 按照提示在浏览器完成授权后,直接执行gcloud auth print-access-token,拿到的令牌就已经包含你指定的所有scopes。
  • 针对应用默认凭据(ADC)场景:
    直接把上面的登录命令换成gcloud auth application-default login --scopes="你的自定义scope列表"即可,后续执行gcloud auth application-default print-access-token拿到的令牌就会携带对应scopes。

场景2:使用服务账号作为凭据

服务账号场景下不需要交互式登录,有两种直接生成自定义scope令牌的方式:

  • 如果你拥有目标服务账号的模拟权限(绑定了roles/iam.serviceAccountTokenCreator角色),不需要下载本地密钥文件,直接执行命令即可生成:
    gcloud auth print-access-token --impersonate-service-account=你的服务账号@xxx.iam.gserviceaccount.com --scope="https://www.googleapis.com/auth/bigquery"
  • 如果你本地已经下载了服务账号的JSON格式密钥文件,先激活该凭据再指定scope生成令牌:
  1. 激活服务账号凭据:gcloud auth activate-service-account --key-file=./svc-account-key.json
  2. 生成带自定义scope的令牌:gcloud auth print-access-token --scope="你需要的完整scope URI列表"

常见注意事项

  • scope必须填写完整的Google OAuth2授权URI格式(例如https://www.googleapis.com/auth/devstorage.read_only),不能只写短标识,否则CLI会识别失败。
  • 不要尝试在print-access-token命令行追加--scopes参数,该命令的作用是按照当前绑定凭据已授权的scope签发短期令牌,无法在令牌生成阶段临时追加权限。
  • 自动化脚本场景可以搭配--no-launch-browser参数,跳过自动拉起浏览器的环节,直接拿到授权链接在其他环境完成授权,不会中断脚本流程。
  • 如果需要同时保留默认scope的凭据和自定义scope的凭据,不需要反复执行revoke操作,可以通过gcloud config configurations create [独立配置名]创建独立的配置环境,在独立配置里完成带自定义scope的登录,之后切换配置即可直接获取对应scope的令牌,不会干扰原有默认配置。

内容的提问来源于stack exchange,提问作者Hunor Kovács

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 09:06:03