主页
产品
Red Hat Quay
3.2
测试 REST
6.9. TokenReview [authentication.k8s.io/v1]

6.9. TokenReview [authentication.k8s.io/v1]

描述

TokenReview 尝试向已知用户进行身份验证令牌。注： TokenReview 请求可由 kube-apiserver 中的 webhook 令牌验证器插件缓存。

类型

对象

必填

spec

6.9.1. 规格
复制链接

Expand

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`
`spec`	`对象`	TokenReviewSpec 是令牌身份验证请求的描述。
`status`	`对象`	TokenReviewStatus 是令牌身份验证请求的结果。

6.9.1.1. .spec
复制链接

描述: TokenReviewSpec 是令牌身份验证请求的描述。
类型: 对象

Expand

属性	类型	描述
`使用者`	`数组（字符串）`	使用者是令牌提供的资源服务器标识为的标识符的列表。Audience-aware 令牌验证器将验证令牌是否专用于此列表中的至少一个使用者。如果没有提供使用者，则使用者将默认为 Kubernetes apiserver 的人员。
`token`	`字符串`	token 是不透明 bearer 令牌。

6.9.1.2. .status
复制链接

描述: TokenReviewStatus 是令牌身份验证请求的结果。
类型: 对象

Expand

属性	类型	描述
`使用者`	`数组（字符串）`	使用者是由与 TokenReview 和 token 兼容的验证器选择的使用者标识符。标识符是 TokenReviewSpec 使用者和令牌使用者的交集中的任何标识符。设置 spec.audiences 字段的 TokenReview API 客户端应验证在 status.audiences 字段中返回兼容的使用者标识符，以确保 TokenReview 服务器被感知。如果 TokenReview 返回空 status.audience 字段，其中 status.authenticated 为 "true"，则令牌对 Kubernetes API 服务器的使用者有效。
`经过身份验证的`	`布尔值`	Authentication 表示令牌已与已知用户关联。
`错误`	`字符串`	Error 表示无法检查令牌
`user`	`对象`	userinfo 包含有关实现 user.Info 接口所需的用户的信息。

6.9.1.3. .status.user
复制链接

描述: userinfo 包含有关实现 user.Info 接口所需的用户的信息。
类型: 对象

Expand

属性	类型	描述
`extra`	`对象`	验证器提供的任何其他信息。
`extra{}`	`数组（字符串）`
`groups`	`数组（字符串）`	此用户所属的组名称。
`uid`	`字符串`	在一段时间内标识此用户的唯一值。如果删除了此用户并且添加相同名称的其他用户，则它们将具有不同的 UID。
`username`	`字符串`	在所有活跃用户中唯一标识此用户的名称。

6.9.1.4. .status.user.extra
复制链接

描述: 验证器提供的任何其他信息。
类型: 对象

6.9.2. API 端点
复制链接

可用的 API 端点如下：

/apis/oauth.openshift.io/v1/tokenreviews
- POST ：创建 TokenReview
/apis/authentication.k8s.io/v1/tokenreviews
- POST ：创建 TokenReview

6.9.2.1. /apis/oauth.openshift.io/v1/tokenreviews
复制链接

Expand

表 6.27. 全局查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: POST
描述: 创建 TokenReview

Expand

表 6.28. 主体参数
参数	类型	描述
`正文（body）`	`TokenReview_v2` schema

Expand

表 6.29. HTTP 响应
HTTP 代码	响应正文
200 - OK	`TokenReview_v2` schema
201 - Created	`TokenReview_v2` schema
202 - Accepted	`TokenReview_v2` schema
401 - Unauthorized	空

6.9.2.2. /apis/authentication.k8s.io/v1/tokenreviews
复制链接

Expand

表 6.30. 全局查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: POST
描述: 创建 TokenReview

Expand

表 6.31. 主体参数
参数	类型	描述
`正文（body）`	`TokenReview` 模式

Expand

表 6.32. HTTP 响应
HTTP 代码	响应正文
200 - OK	`TokenReview` 模式
201 - Created	`TokenReview` 模式
202 - Accepted	`TokenReview` 模式
401 - Unauthorized	空

返回顶部

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat