SelfSubjectRulesReview

apiVersion: authorization.k8s.io/v1

import "k8s.io/api/authorization/v1"

SelfSubjectRulesReview

SelfSubjectRulesReview 枚举当前用户可以在命名空间内执行的操作集。返回的操作列表可能不完整，具体取决于服务器的授权模式，以及在评估期间遇到的任何错误。SelfSubjectRulesReview 应由 UI 用于显示/隐藏操作，或快速让最终用户了解其权限。它不应被外部系统用于驱动授权决策，因为这会引发混淆代理、缓存生命周期/撤销和正确性问题。SubjectAccessReview 和 LocalAccessReview 是将授权决策推迟到 API 服务器的正确方法。

• apiVersion: authorization.k8s.io/v1

• kind: SelfSubjectRulesReview

• metadata (ObjectMeta)

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

• spec (SelfSubjectRulesReviewSpec), required

  Spec 包含有关正在评估的请求的信息。

• status (SubjectRulesReviewStatus)

  Status 由服务器填充，并指示用户可以执行的操作集。

  SubjectRulesReviewStatus 包含规则检查的结果。此检查可能不完整，具体取决于服务器配置的授权器集以及在评估期间遇到的任何错误。由于授权规则是累加的，如果规则出现在列表中，则可以安全地假设主体具有该权限，即使该列表不完整也是如此。

  • status.incomplete (boolean), required

    Incomplete 为 true 时，表示此调用返回的规则不完整。这在授权器（例如外部授权器）不支持规则评估时最常遇到。

  • status.nonResourceRules ([]NonResourceRule), required

    NonResourceRules 是主体被允许对非资源执行的操作列表。列表排序无关紧要，可能包含重复项，并且可能不完整。

    NonResourceRule 包含描述非资源规则的信息

    • status.nonResourceRules.verbs ([]string), required

      Verb 是 kubernetes 非资源 API 动词列表，例如：get、post、put、delete、patch、head、options。"*" 表示所有。

    • status.nonResourceRules.nonResourceURLs ([]string)

      NonResourceURLs 是用户应该有权访问的一组部分 URL。s 是允许的，但只能作为路径中的完整、最终步骤。"*" 表示所有。

  • status.resourceRules ([]ResourceRule), required

    ResourceRules 是主体被允许对资源执行的操作列表。列表排序无关紧要，可能包含重复项，并且可能不完整。

    ResourceRule 是主体被允许对资源执行的操作列表。列表排序无关紧要，可能包含重复项，并且可能不完整。

    • status.resourceRules.verbs ([]string), required

      Verb 是 kubernetes 资源 API 动词列表，例如：get、list、watch、create、update、delete、proxy。"*" 表示所有。

    • status.resourceRules.apiGroups ([]string)

      APIGroups 是包含资源的 APIGroup 的名称。如果指定了多个 API 组，则允许对任何 API 组中枚举的资源之一请求的任何操作。"*" 表示所有。

    • status.resourceRules.resourceNames ([]string)

      ResourceNames 是规则适用的名称的可选白名单。空集表示允许所有内容。"*" 表示所有。

    • status.resourceRules.resources ([]string)

      Resources 是此规则适用的资源列表。"*" 表示指定 apiGroups 中的所有内容。"*"/foo" 表示指定 apiGroups 中所有资源的子资源“foo”。

  • status.evaluationError (string)

    EvaluationError 可以与 Rules 结合出现。它表示在规则评估期间发生错误，例如不支持规则评估的授权器，以及 ResourceRules 和/或 NonResourceRules 可能不完整。

SelfSubjectRulesReviewSpec

SelfSubjectRulesReviewSpec 定义了 SelfSubjectRulesReview 的规范。

• namespace (string)

  要为其评估规则的命名空间。必需。

操作

create 创建 SelfSubjectRulesReview

HTTP 请求

POST /apis/authorization.k8s.io/v1/selfsubjectrulesreviews

参数

• body: SelfSubjectRulesReview, required

• dryRun (in query): string

  dryRun

• fieldManager (in query): string

  fieldManager

• fieldValidation (in query): string

  fieldValidation

• pretty (in query): string

  pretty

响应

200 (SelfSubjectRulesReview): OK

201 (SelfSubjectRulesReview): Created

202 (SelfSubjectRulesReview): Accepted

401: Unauthorized