8.3. TokenReview [authentication.k8s.io/v1]
- 描述
- TokenReview 会尝试向一个已知用户验证令牌。备注：TokenReview 请求可能会被 kube-apiserver 中的 Webhook 令牌验证器插件缓存。
- 类型
-
object - 必填
-
spec
-
8.3.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| TokenReviewSpec 是令牌身份验证请求的描述。 |
|
|
| TokenReviewStatus 是令牌身份验证请求的结果。 |
8.3.1.1. .spec
- 描述
- TokenReviewSpec 是令牌身份验证请求的描述。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| Audiences 是资源服务器通过令牌标识的标识符的列表。支持 Audiences 的令牌验证器将验证至少针对此列表中的一个 audience 的令牌。如果没有提供 audiences，则 audiences 将默认为 Kubernetes apiserver 的 audiences。 |
|
|
| 令牌是 opaque bearer 令牌。 |
8.3.1.2. .status
- 描述
- TokenReviewStatus 是令牌身份验证请求的结果。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| audiences 是由与 TokenReview 和 token 兼容的验证器选择的 audiences 标识符。标识符是 TokenReviewSpec audiences 的交集和令牌的受众中的任何标识符。设置 spec.audiences 字段的 TokenReview API 客户端应该验证 status.audiences 字段中是否返回兼容的受众标识符，以确保 TokenReview 服务器可被受众了解。如果 TokenReview 返回了一个空 status.audience 字段，其中 status.authenticated 为 "true"，则令牌对 Kubernetes API 服务器的受众有效。 |
|
|
| 已验证表示令牌已与一个已知的用户关联。 |
|
|
| Error 表示无法检查令牌 |
|
|
| userinfo 包含有关实现 user.Info 接口所需的用户的信息。 |
8.3.1.3. .status.user
- 描述
- userinfo 包含有关实现 user.Info 接口所需的用户的信息。
- 类型
-
object
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 验证器提供的任何额外信息。 |
|
|
| |
|
|
| 此用户所属的组的名称。 |
|
|
| 一次标识此用户的唯一值。如果删除了此用户，并且添加了相同名称的另一个用户，则它们将具有不同的 UID。 |
|
|
| 在所有活跃用户间唯一标识此用户的名称。 |
8.3.1.4. .status.user.extra
- 描述
- 验证器提供的任何额外信息。
- 类型
-
object
8.3.2. API 端点
可用的 API 端点如下：
/apis/authentication.k8s.io/v1/tokenreviews-
POST：创建一个 TokenReview
-
8.3.2.1. /apis/authentication.k8s.io/v1/tokenreviews
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
|
| fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。 |
|
|
| 如果为 'true'，则输出会经过 pretty print 处理。 |
- HTTP 方法
-
POST - 描述
- 创建 TokenReview
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 201 - Created |
|
| 202 - Accepted |
|
| 401 - Unauthorized | 空 |
