6.13. SubjectAccessReview [authorization.k8s.io/v1]


Description
SubjectAccessReview は、ユーザーまたはグループがアクションを実行できるかどうかをチェックします。
タイプ
object
必須
  • spec

6.13.1. 仕様

Expand
プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、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

object

SubjectAccessReviewSpec は、アクセス要求の説明です。ResourceAuthorizationAttributes と NonResourceAuthorizationAttributes の正確に 1 つを設定する必要があります

status

object

SubjectAccessReviewStatus

6.13.1.1. .spec

Description
SubjectAccessReviewSpec は、アクセス要求の説明です。ResourceAuthorizationAttributes と NonResourceAuthorizationAttributes の正確に 1 つを設定する必要があります
タイプ
object
Expand
プロパティータイプDescription

extra

object

Extra は、オーセンティケーターの user.Info.GetExtra () メソッドに対応します。それは承認者に入力されるので、ここで反映する必要があります。

extra{}

array (string)

 

groups

array (string)

グループは、テストしているグループです。

nonResourceAttributes

object

NonResourceAttributes には、Authorizer インターフェイスへの非リソース要求に使用できる承認属性が含まれています

resourceAttributes

object

ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています

uid

string

要求しているユーザーに関する UID 情報。

user

string

ユーザーは、テストしているユーザーです。ユーザーを指定し、グループを指定しない場合、ユーザーがどのグループのメンバーでもなかった場合はどうなりますかと解釈されますか ?

6.13.1.2. .spec.extra

Description
Extra は、オーセンティケーターの user.Info.GetExtra () メソッドに対応します。それは承認者に入力されるので、ここで反映する必要があります。
タイプ
object

6.13.1.3. .spec.nonResourceAttributes

Description
NonResourceAttributes には、Authorizer インターフェイスへの非リソース要求に使用できる承認属性が含まれています
タイプ
object
Expand
プロパティータイプDescription

path

string

パスはリクエストの URL パスです

verb

string

動詞は標準の HTTP 動詞です

6.13.1.4. .spec.resourceAttributes

Description
ResourceAttributes には、Authorizer インターフェイスへのリソース要求に使用できる許可属性が含まれています
タイプ
object
Expand
プロパティータイプDescription

group

string

グループは、リソースの API グループです。*はすべてを意味します。

name

string

名前は、取得のために要求されているリソース、または削除のために削除されているリソースの名前です。""(空) はすべてを意味します。

namespace

string

namespace は、要求されているアクションの namespace です。現在、名前空間なしとすべての名前空間の区別はありません ""(空) は LocalSubjectAccessReviews のデフォルトです ""(空) はクラスタースコープのリソースでは空です ""(空) は SubjectAccessReview からの名前空間スコープのリソースの " すべて " を意味します SelfSubjectAccessReview

resource

string

リソースは、既存のリソースタイプの 1 つです。* はすべてを意味します。

subresource

string

サブリソースは、既存のリソースタイプの 1 つです。"" は何もないことを意味します。

verb

string

動詞は、get、list、watch、create、update、delete、proxy などの kubernetes リソース API 動詞です。* はすべてを意味します。

version

string

バージョンは、リソースの API バージョンです。* はすべてを意味します。

6.13.1.5. .status

Description
SubjectAccessReviewStatus
タイプ
object
必須
  • allowed
Expand
プロパティータイプDescription

allowed

ブール値

許可が必要です。アクションが許可される場合は true、それ以外の場合は false。

拒否

ブール値

拒否はオプションです。アクションが拒否される場合は true、それ以外の場合は false。許可されたものと拒否されたものの両方が false である場合、承認者はアクションを承認するかどうかについて意見を持っていません。許可が true の場合、拒否は true ではない可能性があります。

evaluationError

string

EvaluationError は、許可チェック中にエラーが発生したことを示します。エラーが発生し、それにもかかわらず許可ステータスを判別し続けることは完全に可能です。たとえば、RBAC にロールがない可能性がありますが、十分なロールがまだ存在しており、要求についての理由に拘束されています。

reason

string

理由はオプションです。リクエストが許可または拒否された理由を示します。

6.13.2. API エンドポイント

以下の API エンドポイントを利用できます。

  • /apis/authorization.k8s.io/v1/subjectaccessreviews

    • POST:SubjectAccessReview を作成します

6.13.2.1. /apis/authorization.k8s.io/v1/subjectaccessreviews

Expand
表6.43 グローバルクエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
POST
Description
SubjectAccessReview の作成
Expand
表6.44 ボディパラメーター
パラメータータイプ説明

ボディー

SubjectAccessReview schema

 
Expand
表6.45 HTTP 応答
HTTP コードレスポンス本文

200 - OK

SubjectAccessReview schema

201 - Created

SubjectAccessReview schema

202 - Accepted

SubjectAccessReview schema

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat