TokenRequest [authentication.k8s.io/v1] - 授权API | API 参考 | OpenShift Container Platform 4.17

规范
API端点
- /api/v1/namespaces/{namespace}/serviceaccounts/{name}/token

描述

TokenRequest请求给定服务帐户的令牌。

类型

对象

必需

spec

规范

属性类型描述

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	Kind 是一个字符串值，表示此对象所代表的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不可更新。使用驼峰式命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`对象`	TokenRequestSpec 包含客户端提供的令牌请求参数。
`status`	`对象`	TokenRequestStatus 是令牌请求的结果。

apiVersion

字符串

APIVersion 定义了此对象表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind 是一个字符串值，表示此对象所代表的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不可更新。使用驼峰式命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

TokenRequestSpec 包含客户端提供的令牌请求参数。

status

对象

TokenRequestStatus 是令牌请求的结果。

.spec

描述

TokenRequestSpec 包含客户端提供的令牌请求参数。

类型

对象

必需

audiences

属性类型描述

属性	类型	描述
`audiences`	`数组 (字符串)`	Audiences 是令牌的目标受众。令牌的接收者必须使用令牌的受众列表中的标识符来识别自己，否则应拒绝令牌。为多个受众颁发的令牌可用于针对列出的任何受众进行身份验证，但这意味着目标受众之间存在高度信任关系。
`boundObjectRef`	`对象`	BoundObjectReference 是对令牌绑定到的对象的引用。
`expirationSeconds`	`整数`	ExpirationSeconds 是请求的有效期持续时间。令牌颁发者可能会返回有效期不同的令牌，因此客户端需要检查响应中的“expiration”字段。

audiences

数组 (字符串)

Audiences 是令牌的目标受众。令牌的接收者必须使用令牌的受众列表中的标识符来识别自己，否则应拒绝令牌。为多个受众颁发的令牌可用于针对列出的任何受众进行身份验证，但这意味着目标受众之间存在高度信任关系。

boundObjectRef

对象

BoundObjectReference 是对令牌绑定到的对象的引用。

expirationSeconds

整数

ExpirationSeconds 是请求的有效期持续时间。令牌颁发者可能会返回有效期不同的令牌，因此客户端需要检查响应中的“expiration”字段。

.spec.boundObjectRef

描述: BoundObjectReference 是对令牌绑定到的对象的引用。
类型: 对象

属性类型描述

属性	类型	描述
`apiVersion`	`字符串`	引用的 API 版本。
`kind`	`字符串`	引用的 Kind。有效的 Kind 为“Pod”和“Secret”。
`name`	`字符串`	引用的名称。
`uid`	`字符串`	引用的 UID。

apiVersion

字符串

引用的 API 版本。

kind

字符串

引用的 Kind。有效的 Kind 为“Pod”和“Secret”。

name

字符串

引用的名称。

uid

字符串

引用的 UID。

.status

描述

TokenRequestStatus 是令牌请求的结果。

类型

对象

必需

token
expirationTimestamp

属性类型描述

属性	类型	描述
`expirationTimestamp`	`时间`	ExpirationTimestamp 是返回令牌的过期时间。
`token`	`字符串`	Token 是不透明的承载令牌。

expirationTimestamp

时间

ExpirationTimestamp 是返回令牌的过期时间。

token

字符串

Token 是不透明的承载令牌。

API 端点

提供以下 API 端点

/api/v1/namespaces/{namespace}/serviceaccounts/{name}/token
- POST：创建 ServiceAccount 的令牌

/api/v1/namespaces/{namespace}/serviceaccounts/{name}/token

表 1. 全局路径参数
参数	类型	描述
`name`	`字符串`	TokenRequest 的名称

表 2. 全局查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
`fieldValidation`	`字符串`	fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

HTTP 方法: POST
描述: 创建 ServiceAccount 的令牌

表 3. 请求体参数
参数	类型	描述
`body`	`TokenRequest` 模式

表 4. HTTP 响应
HTTP 代码	响应体
200 - OK	`TokenRequest` 模式
201 - 已创建	`TokenRequest` 模式
202 - 已接受	`TokenRequest` 模式
401 - 未授权	空