권한 부여 API


OpenShift Container Platform 4.14

권한 부여 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Container Platform 권한 부여 API 오브젝트 및 세부 사양에 대해 설명합니다.

1장. 권한 부여 API

1.1. LocalResourceAccessReview [authorization.openshift.io/v1]

설명

LocalResourceAccessReview는 특정 네임스페이스의 spec에서 지정한 작업을 수행할 권한이 있는 사용자 및 그룹 목록을 요청하는 수단입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.2. LocalSubjectAccessReview [authorization.openshift.io/v1]

설명

LocalSubjectAccessReview는 사용자 또는 그룹이 특정 네임스페이스에서 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.3. ResourceAccessReview [authorization.openshift.io/v1]

설명

ResourceAccessReview는 spec에서 지정한 작업을 수행할 권한이 있는 사용자 및 그룹 목록을 요청할 수 있는 수단입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.4. SelfSubjectRulesReview [authorization.openshift.io/v1]

설명

SelfSubjectRulesReview는 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.5. SubjectAccessReview [authorization.openshift.io/v1]

설명

subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.6. SubjectRulesReview [authorization.openshift.io/v1]

설명

SubjectRulesReview는 다른 사용자가 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.7. TokenRequest [authentication.k8s.io/v1]

설명
TokenRequest는 지정된 서비스 계정에 대한 토큰을 요청합니다.
유형
object

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

설명
TokenReview는 알려진 사용자에게 토큰을 인증하려고 합니다. 참고: TokenReview 요청은 kube-apiserver의 Webhook 토큰 인증 플러그인에 의해 캐시될 수 있습니다.
유형
object

1.9. LocalSubjectAccessReview [authorization.k8s.io/v1]

설명
LocalSubjectAccessReview는 사용자 또는 그룹이 지정된 네임스페이스에서 작업을 수행할 수 있는지 여부를 확인합니다. 네임스페이스 범위 리소스를 사용하면 권한 확인을 포함하는 네임스페이스 범위 정책을 훨씬 쉽게 부여할 수 있습니다.
유형
object

1.10. SelfSubjectAccessReview [authorization.k8s.io/v1]

설명
SelfSubjectAccessReview는 현재 사용자가 작업을 수행할 수 있는지 여부를 확인합니다. spec.namespace를 채우지 않으면 "모든 네임스페이스에서"를 의미합니다. 사용자가 작업을 수행할 수 있는지 항상 확인할 수 있기 때문에 Self는 특별한 경우입니다.
유형
object

1.11. SelfSubjectRulesReview [authorization.k8s.io/v1]

설명
SelfSubjectRulesReview는 현재 사용자가 네임스페이스 내에서 수행할 수 있는 작업 집합을 열거합니다. 반환된 작업 목록은 서버의 권한 부여 모드 및 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. SelfSubjectRulesReview는 UI에서 작업을 표시/해제하거나 최종 사용자가 권한에 대해 신속하게 이유하도록 하는 데 사용해야 합니다. 이로 인해 혼동되는 결정, 캐시 수명/복사 및 정확성 문제가 발생하므로 외부 시스템에서 권한 부여 결정을 내리면 안 됩니다. subjectAccessReview 및 LocalAccessReview는 API 서버에 권한 부여 결정을 지연하는 올바른 방법입니다.
유형
object

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

설명
subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지 여부를 확인합니다.
유형
object

2장. LocalResourceAccessReview [authorization.openshift.io/v1]

설명

LocalResourceAccessReview는 특정 네임스페이스의 spec에서 지정한 작업을 수행할 권한이 있는 사용자 및 그룹 목록을 요청하는 수단입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 네임스페이스
  • verb
  • resourceAPIGroup
  • resourceAPIVersion
  • resource
  • resourceName
  • path
  • isNonResourceURL

2.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

콘텐츠

RawExtension

콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다.

isNonResourceURL

boolean

IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음

path

string

path는 리소스가 아닌 URL의 경로입니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다.

resourceAPIGroup

string

group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다.

resourceAPIVersion

string

버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다.

resourceName

string

resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다.

verb

string

동사는 get, list, watch, create, update, delete 중 하나입니다.

2.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.openshift.io/v1/namespaces/{namespace}/localresourceaccessreviews

    • POST: LocalResourceAccessReview 만들기

2.2.1. /apis/authorization.openshift.io/v1/namespaces/{namespace}/localresourceaccessreviews

표 2.1. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 2.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
LocalResourceAccessReview 만들기
표 2.3. 본문 매개변수
매개변수유형설명

body

LocalResourceAccessReview 스키마

 
표 2.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LocalResourceAccessReview 스키마

201 - 생성됨

LocalResourceAccessReview 스키마

202 - 승인됨

LocalResourceAccessReview 스키마

401 - 무단

3장. LocalSubjectAccessReview [authorization.openshift.io/v1]

설명

LocalSubjectAccessReview는 사용자 또는 그룹이 특정 네임스페이스에서 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 네임스페이스
  • verb
  • resourceAPIGroup
  • resourceAPIVersion
  • resource
  • resourceName
  • path
  • isNonResourceURL
  • user
  • groups
  • 범위

3.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

콘텐츠

RawExtension

콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다.

groups

배열(문자열)

그룹은 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다.

isNonResourceURL

boolean

IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음

path

string

path는 리소스가 아닌 URL의 경로입니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다.

resourceAPIGroup

string

group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다.

resourceAPIVersion

string

버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다.

resourceName

string

resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다.

범위

배열(문자열)

평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. Self-SAR의 경우 nil은 "이 요청에서 범위 사용"을 의미합니다. 일반 SAR의 경우 nil은 빈과 동일합니다.

user

string

사용자는 선택 사항입니다. 사용자 및 그룹이 모두 비어 있으면 현재 인증된 사용자가 사용됩니다.

verb

string

동사는 get, list, watch, create, update, delete 중 하나입니다.

3.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.openshift.io/v1/namespaces/{namespace}/localsubjectaccessreviews

    • POST: LocalSubjectAccessReview 생성

3.2.1. /apis/authorization.openshift.io/v1/namespaces/{namespace}/localsubjectaccessreviews

표 3.1. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
LocalSubjectAccessReview 생성
표 3.3. 본문 매개변수
매개변수유형설명

body

LocalSubjectAccessReview schema

 
표 3.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LocalSubjectAccessReview schema

201 - 생성됨

LocalSubjectAccessReview schema

202 - 승인됨

LocalSubjectAccessReview schema

401 - 무단

4장. ResourceAccessReview [authorization.openshift.io/v1]

설명

ResourceAccessReview는 spec에서 지정한 작업을 수행할 권한이 있는 사용자 및 그룹 목록을 요청할 수 있는 수단입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 네임스페이스
  • verb
  • resourceAPIGroup
  • resourceAPIVersion
  • resource
  • resourceName
  • path
  • isNonResourceURL

4.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

콘텐츠

RawExtension

콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다.

isNonResourceURL

boolean

IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음

path

string

path는 리소스가 아닌 URL의 경로입니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다.

resourceAPIGroup

string

group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다.

resourceAPIVersion

string

버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다.

resourceName

string

resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다.

verb

string

동사는 get, list, watch, create, update, delete 중 하나입니다.

4.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.openshift.io/v1/resourceaccessreviews

    • POST: ResourceAccessReview 생성

4.2.1. /apis/authorization.openshift.io/v1/resourceaccessreviews

표 4.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
ResourceAccessReview 생성
표 4.2. 본문 매개변수
매개변수유형설명

body

ResourceAccessReview 스키마

 
표 4.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ResourceAccessReview 스키마

201 - 생성됨

ResourceAccessReview 스키마

202 - 승인됨

ResourceAccessReview 스키마

401 - 무단

5장. SelfSubjectRulesReview [authorization.openshift.io/v1]

설명

SelfSubjectRulesReview는 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • spec

5.1. 사양

속성유형설명

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

spec

object

SelfSubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.

status

object

SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.

5.1.1. .spec

설명
SelfSubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.
유형
object
필수 항목
  • 범위
속성유형설명

범위

배열(문자열)

평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. nil은 "이 요청에서 범위 사용"을 의미합니다.

5.1.2. .status

설명
SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.
유형
object
필수 항목
  • 규칙
속성유형설명

evaluationError

string

evaluationError는 규칙과 함께 표시될 수 있습니다. 이는 평가 중에 추가 규칙이 채워지지 않을 수 있는 일부 오류가 발생했음을 의미합니다.

규칙

array

규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.

rules[]

object

PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

5.1.3. .status.rules

설명
규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.
유형
array

5.1.4. .status.rules[]

설명
PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.
유형
object
필수 항목
  • verbs
  • resources
속성유형설명

apiGroups

배열(문자열)

APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다.

attributeRestrictions

RawExtension

AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다.

nonResourceURLs

배열(문자열)

NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다.

resourceNames

배열(문자열)

resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다.

resources

배열(문자열)

리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다.

verbs

배열(문자열)

동사는 이 규칙에 포함된 모든 ResourceKinds 및 AttributeRestrictions에 적용되는 Verbs 목록입니다. VerbAll는 모든 종류를 나타냅니다.

5.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.openshift.io/v1/namespaces/{namespace}/selfsubjectrulesreviews

    • POST: SelfSubjectRulesReview 생성

5.2.1. /apis/authorization.openshift.io/v1/namespaces/{namespace}/selfsubjectrulesreviews

표 5.1. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 5.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SelfSubjectRulesReview 생성
표 5.3. 본문 매개변수
매개변수유형설명

body

SelfSubjectRulesReview 스키마

 
표 5.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

SelfSubjectRulesReview 스키마

201 - 생성됨

SelfSubjectRulesReview 스키마

202 - 승인됨

SelfSubjectRulesReview 스키마

401 - 무단

6장. SubjectAccessReview [authorization.openshift.io/v1]

설명

subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • 네임스페이스
  • verb
  • resourceAPIGroup
  • resourceAPIVersion
  • resource
  • resourceName
  • path
  • isNonResourceURL
  • user
  • groups
  • 범위

6.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

콘텐츠

RawExtension

콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다.

groups

배열(문자열)

GroupsSlice는 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다.

isNonResourceURL

boolean

IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음

path

string

path는 리소스가 아닌 URL의 경로입니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다.

resourceAPIGroup

string

group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다.

resourceAPIVersion

string

버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다.

resourceName

string

resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다.

범위

배열(문자열)

평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. Self-SAR의 경우 nil은 "이 요청에서 범위 사용"을 의미합니다. 일반 SAR의 경우 nil은 빈과 동일합니다.

user

string

사용자는 선택 사항입니다. 사용자 및 그룹이 모두 비어 있으면 현재 인증된 사용자가 사용됩니다.

verb

string

동사는 get, list, watch, create, update, delete 중 하나입니다.

6.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

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

    • POST: SubjectAccessReview 생성

6.2.1. /apis/authorization.openshift.io/v1/subjectaccessreviews

표 6.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SubjectAccessReview 생성
표 6.2. 본문 매개변수
매개변수유형설명

body

subjectAccessReview 스키마

 
표 6.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

subjectAccessReview 스키마

201 - 생성됨

subjectAccessReview 스키마

202 - 승인됨

subjectAccessReview 스키마

401 - 무단

7장. SubjectRulesReview [authorization.openshift.io/v1]

설명

SubjectRulesReview는 다른 사용자가 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • spec

7.1. 사양

속성유형설명

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

spec

object

SubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.

status

object

SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.

7.1.1. .spec

설명
SubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.
유형
object
필수 항목
  • user
  • groups
  • 범위
속성유형설명

groups

배열(문자열)

그룹은 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다. 사용자 및 그룹 중 하나 이상을 지정해야 합니다.

범위

배열(문자열)

평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다.

user

string

사용자는 선택 사항입니다. 사용자 및 그룹 중 하나 이상을 지정해야 합니다.

7.1.2. .status

설명
SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.
유형
object
필수 항목
  • 규칙
속성유형설명

evaluationError

string

evaluationError는 규칙과 함께 표시될 수 있습니다. 이는 평가 중에 추가 규칙이 채워지지 않을 수 있는 일부 오류가 발생했음을 의미합니다.

규칙

array

규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.

rules[]

object

PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

7.1.3. .status.rules

설명
규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.
유형
array

7.1.4. .status.rules[]

설명
PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.
유형
object
필수 항목
  • verbs
  • resources
속성유형설명

apiGroups

배열(문자열)

APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다.

attributeRestrictions

RawExtension

AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다.

nonResourceURLs

배열(문자열)

NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다.

resourceNames

배열(문자열)

resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다.

resources

배열(문자열)

리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다.

verbs

배열(문자열)

동사는 이 규칙에 포함된 모든 ResourceKinds 및 AttributeRestrictions에 적용되는 Verbs 목록입니다. VerbAll는 모든 종류를 나타냅니다.

7.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.openshift.io/v1/namespaces/{namespace}/subjectrulesreviews

    • POST: SubjectRulesReview 생성

7.2.1. /apis/authorization.openshift.io/v1/namespaces/{namespace}/subjectrulesreviews

표 7.1. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SubjectRulesReview 생성
표 7.3. 본문 매개변수
매개변수유형설명

body

SubjectRulesReview 스키마

 
표 7.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

SubjectRulesReview 스키마

201 - 생성됨

SubjectRulesReview 스키마

202 - 승인됨

SubjectRulesReview 스키마

401 - 무단

8장. TokenRequest [authentication.k8s.io/v1]

설명
TokenRequest는 지정된 서비스 계정에 대한 토큰을 요청합니다.
유형
object
필수 항목
  • spec

8.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

TokenRequestSpec에는 토큰 요청의 클라이언트 제공 매개변수가 포함되어 있습니다.

status

object

TokenRequestStatus는 토큰 요청의 결과입니다.

8.1.1. .spec

설명
TokenRequestSpec에는 토큰 요청의 클라이언트 제공 매개변수가 포함되어 있습니다.
유형
object
필수 항목
  • 대상
속성유형설명

대상

배열(문자열)

대상은 토큰의 의도적인 대상입니다. 토큰 수신자는 토큰 대상 목록에 있는 식별자로 해당 ID를 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 여러 대상자에게 발행되는 토큰은 나열된 대상자에 대해 인증하는 데 사용할 수 있지만 대상 대상 그룹 간의 높은 신뢰 수준을 의미합니다.

boundObjectRef

object

BoundObjectReference는 토큰이 바인딩된 오브젝트에 대한 참조입니다.

expirationSeconds

integer

ExpirationSeconds는 요청된 요청의 유효 기간입니다. 토큰 발행자는 다른 유효 기간이 있는 토큰을 반환할 수 있으므로 클라이언트가 응답에서 '종료' 필드를 확인해야 합니다.

8.1.2. .spec.boundObjectRef

설명
BoundObjectReference는 토큰이 바인딩된 오브젝트에 대한 참조입니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

kind

string

일종의 추천입니다. 유효한 종류는 'Pod' 및 'Secret'입니다.

name

string

추천자의 이름입니다.

uid

string

참조의 UID입니다.

8.1.3. .status

설명
TokenRequestStatus는 토큰 요청의 결과입니다.
유형
object
필수 항목
  • token
  • expirationTimestamp
속성유형설명

expirationTimestamp

시간

ExpirationTimestamp는 반환된 토큰의 만료 시간입니다.

token

string

토큰은 opaque 전달자 토큰입니다.

8.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

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

    • POST: ServiceAccount의 토큰 생성

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

표 8.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

TokenRequest의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
ServiceAccount의 토큰 생성
표 8.3. 본문 매개변수
매개변수유형설명

body

TokenRequest 스키마

 
표 8.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

TokenRequest 스키마

201 - 생성됨

TokenRequest 스키마

202 - 승인됨

TokenRequest 스키마

401 - 무단

9장. TokenReview [authentication.k8s.io/v1]

설명
TokenReview는 알려진 사용자에게 토큰을 인증하려고 합니다. 참고: TokenReview 요청은 kube-apiserver의 Webhook 토큰 인증 플러그인에 의해 캐시될 수 있습니다.
유형
object
필수 항목
  • spec

9.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

TokenReviewSpec은 토큰 인증 요청에 대한 설명입니다.

status

object

TokenReviewStatus는 토큰 인증 요청의 결과입니다.

9.1.1. .spec

설명
TokenReviewSpec은 토큰 인증 요청에 대한 설명입니다.
유형
object
속성유형설명

대상

배열(문자열)

대상자는 토큰과 함께 제공되는 리소스 서버가 로 식별되는 식별자 목록입니다. 대상자 인식 토큰 인증자는 토큰이 이 목록의 대상 중 하나 이상을 대상으로 되었는지 확인합니다. 대상자가 제공되지 않는 경우 대상자는 기본적으로 Kubernetes apiserver 대상으로 설정됩니다.

token

string

토큰은 opaque 전달자 토큰입니다.

9.1.2. .status

설명
TokenReviewStatus는 토큰 인증 요청의 결과입니다.
유형
object
속성유형설명

대상

배열(문자열)

대상자는 인증자가 선택한 대상 식별자로, TokenReview 및 토큰과 호환됩니다. 식별자는 TokenReviewSpec 대상 및 토큰의 대상의 교차점에 있는 식별자입니다. spec.audiences 필드를 설정하는 TokenReview API의 클라이언트는 호환되는 대상 식별자가 status.audiences 필드에서 반환되어 TokenReview 서버가 인식되는지 확인해야 합니다. TokenReview에서 status.authenticated가 "true"인 빈 status.audience 필드를 반환하는 경우 토큰은 Kubernetes API 서버의 대상에 대해 유효합니다.

인증됨

boolean

authenticated은 토큰이 알려진 사용자와 연결되어 있음을 나타냅니다.

error

string

오류는 토큰을 확인할 수 없음을 나타냅니다.

user

object

userinfo에는 user.Info 인터페이스를 구현하는 데 필요한 사용자에 대한 정보가 들어 있습니다.

9.1.3. .status.user

설명
userinfo에는 user.Info 인터페이스를 구현하는 데 필요한 사용자에 대한 정보가 들어 있습니다.
유형
object
속성유형설명

extra

object

인증자가 제공하는 추가 정보.

extra{}

배열(문자열)

 

groups

배열(문자열)

이 사용자가 속한 그룹의 이름입니다.

uid

string

시간 경과에 따라 이 사용자를 식별하는 고유한 값입니다. 이 사용자가 삭제되고 동일한 이름의 다른 사용자가 추가되면 UID가 다릅니다.

사용자 이름

string

모든 활성 사용자 중에서 이 사용자를 고유하게 식별하는 이름입니다.

9.1.4. .status.user.extra

설명
인증자가 제공하는 추가 정보.
유형
object

9.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/oauth.openshift.io/v1/tokenreviews

    • POST: TokenReview 생성
  • /apis/authentication.k8s.io/v1/tokenreviews

    • POST: TokenReview 생성

9.2.1. /apis/oauth.openshift.io/v1/tokenreviews

표 9.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
TokenReview 생성
표 9.2. 본문 매개변수
매개변수유형설명

body

TokenReview 스키마

 
표 9.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

TokenReview 스키마

201 - 생성됨

TokenReview 스키마

202 - 승인됨

TokenReview 스키마

401 - 무단

9.2.2. /apis/authentication.k8s.io/v1/tokenreviews

표 9.4. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
TokenReview 생성
표 9.5. 본문 매개변수
매개변수유형설명

body

TokenReview 스키마

 
표 9.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

TokenReview 스키마

201 - 생성됨

TokenReview 스키마

202 - 승인됨

TokenReview 스키마

401 - 무단

10장. LocalSubjectAccessReview [authorization.k8s.io/v1]

설명
LocalSubjectAccessReview는 사용자 또는 그룹이 지정된 네임스페이스에서 작업을 수행할 수 있는지 여부를 확인합니다. 네임스페이스 범위 리소스를 사용하면 권한 확인을 포함하는 네임스페이스 범위 정책을 훨씬 쉽게 부여할 수 있습니다.
유형
object
필수 항목
  • spec

10.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 목록 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.

status

object

SubjectAccessReviewStatus

10.1.1. .spec

설명
SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
유형
object
속성유형설명

extra

object

extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.

extra{}

배열(문자열)

 

groups

배열(문자열)

그룹은 테스트 중인 그룹입니다.

nonResourceAttributes

object

NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

resourceAttributes

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

uid

string

요청하는 사용자에 대한 UID 정보입니다.

user

string

사용자가 테스트 중인 사용자입니다. "User"를 지정하지만 "그룹"은 지정하지 않으면 "사용자가 어떤 그룹의 멤버가 아닌 경우 어떻게 해야 합니까?

10.1.2. .spec.extra

설명
extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.
유형
object

10.1.3. .spec.nonResourceAttributes

설명
NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

path

string

path는 요청의 URL 경로입니다.

verb

string

동사는 표준 HTTP 동사입니다.

10.1.4. .spec.resourceAttributes

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

10.1.5. .status

설명
SubjectAccessReviewStatus
유형
object
필수 항목
  • 허용됨
속성유형설명

허용됨

boolean

허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다.

거부됨

boolean

거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다.

evaluationError

string

evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다.

reason

string

이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다.

10.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/authorization.k8s.io/v1/namespaces/{namespace}/localsubjectaccessreviews

    • POST: LocalSubjectAccessReview 생성

10.2.1. /apis/authorization.k8s.io/v1/namespaces/{namespace}/localsubjectaccessreviews

표 10.1. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 10.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
LocalSubjectAccessReview 생성
표 10.3. 본문 매개변수
매개변수유형설명

body

LocalSubjectAccessReview schema

 
표 10.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

LocalSubjectAccessReview schema

201 - 생성됨

LocalSubjectAccessReview schema

202 - 승인됨

LocalSubjectAccessReview schema

401 - 무단

11장. SelfSubjectAccessReview [authorization.k8s.io/v1]

설명
SelfSubjectAccessReview는 현재 사용자가 작업을 수행할 수 있는지 여부를 확인합니다. spec.namespace를 채우지 않으면 "모든 네임스페이스에서"를 의미합니다. 사용자가 작업을 수행할 수 있는지 항상 확인할 수 있기 때문에 Self는 특별한 경우입니다.
유형
object
필수 항목
  • spec

11.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 목록 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

SelfSubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.

status

object

SubjectAccessReviewStatus

11.1.1. .spec

설명
SelfSubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
유형
object
속성유형설명

nonResourceAttributes

object

NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

resourceAttributes

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

11.1.2. .spec.nonResourceAttributes

설명
NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

path

string

path는 요청의 URL 경로입니다.

verb

string

동사는 표준 HTTP 동사입니다.

11.1.3. .spec.resourceAttributes

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

11.1.4. .status

설명
SubjectAccessReviewStatus
유형
object
필수 항목
  • 허용됨
속성유형설명

허용됨

boolean

허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다.

거부됨

boolean

거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다.

evaluationError

string

evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다.

reason

string

이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다.

11.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

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

    • POST: SelfSubjectAccessReview 생성

11.2.1. /apis/authorization.k8s.io/v1/selfsubjectaccessreviews

표 11.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SelfSubjectAccessReview 생성
표 11.2. 본문 매개변수
매개변수유형설명

body

SelfSubjectAccessReview 스키마

 
표 11.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

SelfSubjectAccessReview 스키마

201 - 생성됨

SelfSubjectAccessReview 스키마

202 - 승인됨

SelfSubjectAccessReview 스키마

401 - 무단

12장. SelfSubjectRulesReview [authorization.k8s.io/v1]

설명
SelfSubjectRulesReview는 현재 사용자가 네임스페이스 내에서 수행할 수 있는 작업 집합을 열거합니다. 반환된 작업 목록은 서버의 권한 부여 모드 및 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. SelfSubjectRulesReview는 UI에서 작업을 표시/해제하거나 최종 사용자가 권한에 대해 신속하게 이유하도록 하는 데 사용해야 합니다. 이로 인해 혼동되는 결정, 캐시 수명/복사 및 정확성 문제가 발생하므로 외부 시스템에서 권한 부여 결정을 내리면 안 됩니다. subjectAccessReview 및 LocalAccessReview는 API 서버에 권한 부여 결정을 지연하는 올바른 방법입니다.
유형
object
필수 항목
  • spec

12.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 목록 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

SelfSubjectRulesReviewSpec은 SelfSubjectRulesReview의 사양을 정의합니다.

status

object

SubjectRulesReviewStatus에는 규칙 검사 결과가 포함되어 있습니다. 이 검사는 서버가 구성된 인증자 세트와 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. 권한 부여 규칙이 추가되므로 목록에 규칙이 표시되면 제목에 해당 권한이 있다고 가정하는 것이 안전합니다.

12.1.1. .spec

설명
SelfSubjectRulesReviewSpec은 SelfSubjectRulesReview의 사양을 정의합니다.
유형
object
속성유형설명

네임스페이스

string

규칙을 평가할 네임스페이스입니다. 필수 항목입니다.

12.1.2. .status

설명
SubjectRulesReviewStatus에는 규칙 검사 결과가 포함되어 있습니다. 이 검사는 서버가 구성된 인증자 세트와 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. 권한 부여 규칙이 추가되므로 목록에 규칙이 표시되면 제목에 해당 권한이 있다고 가정하는 것이 안전합니다.
유형
object
필수 항목
  • resourceRules
  • 비ResourceRules
  • incomplete
속성유형설명

evaluationError

string

evaluationError는 규칙과 함께 표시될 수 있습니다. 규칙 평가를 지원하지 않는 인증자와 같이 규칙 평가 중에 발생한 오류를 나타내며 ResourceRules 및/또는 NonResourceRules가 불완전할 수 있습니다.

incomplete

boolean

이 호출에서 반환된 규칙이 불완전하면 불완전합니다. 이는 외부 인증자와 같은 승인자가 규칙 평가를 지원하지 않는 경우 가장 일반적으로 발생합니다.

비ResourceRules

array

NonResourceRules는 리소스가 아닌 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.

nonResourceRules[]

object

NonResourceRule는 리소스가 아닌 리소스에 대한 규칙을 설명하는 정보를 보유합니다.

resourceRules

array

ResourceRules는 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.

resourceRules[]

object

ResourceRule은 주체가 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.

12.1.3. .status.nonResourceRules

설명
NonResourceRules는 리소스가 아닌 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.
유형
array

12.1.4. .status.nonResourceRules[]

설명
NonResourceRule는 리소스가 아닌 리소스에 대한 규칙을 설명하는 정보를 보유합니다.
유형
object
필수 항목
  • verbs
속성유형설명

nonResourceURLs

배열(문자열)

NonResourceURLs는 사용자가 액세스할 수 있어야 하는 부분적인 URL 세트입니다. s는 허용되지만 경로의 전체 최종 단계로만 허용됩니다. "모두를 의미합니다.

verbs

배열(문자열)

verb은 다음과 같은 kubernetes 비 리소스 API 동사 목록입니다. get, post, put, delete, patch, head, options. "*"는 모두 의미합니다.

12.1.5. .status.resourceRules

설명
ResourceRules는 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.
유형
array

12.1.6. .status.resourceRules[]

설명
ResourceRule은 주체가 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.
유형
object
필수 항목
  • verbs
속성유형설명

apiGroups

배열(문자열)

APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 여러 API 그룹이 지정되면 API 그룹에서 열거된 리소스 중 하나에 대해 요청된 모든 작업이 허용됩니다. "*"는 모든 것을 의미합니다.

resourceNames

배열(문자열)

resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다. "*"는 모든 것을 의미합니다.

resources

배열(문자열)

resources는 이 규칙이 적용되는 리소스 목록입니다."은 지정된 apiGroups에 있는 모든 리소스를 의미합니다. "/foo"는 지정된 apiGroups의 모든 리소스에 대한 하위 리소스 'foo'를 나타냅니다.

verbs

배열(문자열)

동사는 다음과 같은 kubernetes 리소스 API 동사 목록입니다. get, list, watch, create, update, delete, proxy. "*"는 모두 의미합니다.

12.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

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

    • POST: SelfSubjectRulesReview 생성

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

표 12.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SelfSubjectRulesReview 생성
표 12.2. 본문 매개변수
매개변수유형설명

body

SelfSubjectRulesReview 스키마

 
표 12.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

SelfSubjectRulesReview 스키마

201 - 생성됨

SelfSubjectRulesReview 스키마

202 - 승인됨

SelfSubjectRulesReview 스키마

401 - 무단

13장. SubjectAccessReview [authorization.k8s.io/v1]

설명
subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지 여부를 확인합니다.
유형
object
필수 항목
  • spec

13.1. 사양

속성유형설명

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

메타데이터

ObjectMeta

표준 목록 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.

status

object

SubjectAccessReviewStatus

13.1.1. .spec

설명
SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
유형
object
속성유형설명

extra

object

extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.

extra{}

배열(문자열)

 

groups

배열(문자열)

그룹은 테스트 중인 그룹입니다.

nonResourceAttributes

object

NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

resourceAttributes

object

ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.

uid

string

요청하는 사용자에 대한 UID 정보입니다.

user

string

사용자가 테스트 중인 사용자입니다. "User"를 지정하지만 "그룹"은 지정하지 않으면 "사용자가 어떤 그룹의 멤버가 아닌 경우 어떻게 해야 합니까?

13.1.2. .spec.extra

설명
extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.
유형
object

13.1.3. .spec.nonResourceAttributes

설명
NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

path

string

path는 요청의 URL 경로입니다.

verb

string

동사는 표준 HTTP 동사입니다.

13.1.4. .spec.resourceAttributes

설명
ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
유형
object
속성유형설명

group

string

group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다.

name

string

name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다.

네임스페이스

string

namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다.

resource

string

리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다.

하위 리소스

string

하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다.

verb

string

동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다.

version

string

버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다.

13.1.5. .status

설명
SubjectAccessReviewStatus
유형
object
필수 항목
  • 허용됨
속성유형설명

허용됨

boolean

허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다.

거부됨

boolean

거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다.

evaluationError

string

evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다.

reason

string

이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다.

13.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

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

    • POST: SubjectAccessReview 생성

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

표 13.1. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
SubjectAccessReview 생성
표 13.2. 본문 매개변수
매개변수유형설명

body

subjectAccessReview 스키마

 
표 13.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

subjectAccessReview 스키마

201 - 생성됨

subjectAccessReview 스키마

202 - 승인됨

subjectAccessReview 스키마

401 - 무단

Legal Notice

Copyright © 2024 Red Hat, Inc.

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.