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
相关产品推荐
相关产品推荐

