You need to enable JavaScript to run this app. gcloud中identity token与access token的区别、适用场景及命令差异
优惠活动
大模型
产品
解决方案
定价
更多

gcloud中identity token与access token的区别、适用场景及命令差异

Google Cloud gcloud令牌常见问题解答

1. gcloud auth print-access-token和gcloud auth print-identity-token输出令牌的核心区别

两者同属OAuth 2.0体系下的凭证,但核心定位完全不同:

  • access-token(访问令牌):是授权类凭证,核心作用是证明持有者拥有特定Google Cloud资源的访问权限,本身不携带完整的身份标识信息,默认有效期1小时,权限校验需要GCP服务端对接权限系统完成。
  • identity-token(身份令牌):是遵循OIDC协议的身份认证类凭证,核心作用是证明持有者的身份,本身为JWT格式,Payload中自带签发者、受众、账号ID、账号邮箱等身份信息,验证签名后无需额外调用接口即可直接读取身份字段。

2. 二者的适用场景及互斥场景

对应适用场景

  • 访问令牌适用场景:
    • 调用绝大多数Google Cloud资源类API,比如Compute Engine实例管理、Cloud Storage对象操作、BigQuery数据查询等,这类场景只需要校验操作权限,不需要识别调用方身份
    • 直接作为Authorization: Bearer <令牌>请求头传递给GCP资源服务端点
  • 身份令牌适用场景:
    • 需要识别调用方身份的场景,比如调用Cloud Run、Cloud Functions的受保护端点,这类服务需要明确调用方身份做细粒度权限控制
    • Workload Identity联邦场景下的身份交换,用自身身份令牌兑换其他异构系统的访问权限
    • 多服务间的身份透传,无需额外查询接口即可获取调用方身份信息

只能使用单一令牌的场景

  • 仅能使用访问令牌:所有GCP资源操作类API,比如创建GCS存储桶、修改VPC路由规则,这类API的权限校验逻辑仅识别访问令牌,不支持身份令牌
  • 仅能使用身份令牌:调用配置了受众(aud)校验的服务端点,比如IAP保护的应用、Cloud Run私有服务,这类校验逻辑要求令牌携带指定aud字段,访问令牌无该字段无法通过校验。

3. 命令调用路径差异的原因

首先明确两个调用路径的定位差异:

  • gcloud auth对应当前gcloud客户端已登录的实体身份(用户账号、服务账号),这类身份有明确的OIDC身份标识,既可以生成授权用的访问令牌,也可以生成对应身份的身份令牌。
  • gcloud auth application-default对应*应用默认凭据(ADC)*的上下文,ADC的设计定位是给本地开发/运行的应用提供统一的授权凭据获取路径,核心作用是给应用提供访问GCP资源的访问令牌。

另外身份令牌生成必须指定明确的--audience参数,且依赖对应身份的OIDC签发权限,ADC本身是适配多场景的凭据抽象(可能是本地密钥、虚拟机元数据服务、托管身份凭证等),部分ADC场景的凭据来源不支持生成身份令牌,因此Google没有在gcloud auth application-default下提供print-identity-token实现,仅在明确关联了具体登录身份的gcloud auth路径下提供该能力。


内容的提问来源于stack exchange,提问作者MBHA Phoenix

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.09 18:06:01