使用`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用户凭据:
- 先移除原有不带自定义scope的凭据:
gcloud auth revoke 你的账号邮箱@gmail.com - 重新发起登录授权,携带自定义scopes参数:
gcloud auth login --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/drive.readonly" --no-launch-browser - 按照提示在浏览器完成授权后,直接执行
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生成令牌:
- 激活服务账号凭据:
gcloud auth activate-service-account --key-file=./svc-account-key.json - 生成带自定义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
相关产品推荐
相关产品推荐

