권한 부여 API
권한 부여 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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| 콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다. | |
|
| IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음 |
|
| path는 리소스가 아닌 URL의 경로입니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. |
|
| group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다. |
|
| 버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다. |
|
| resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다. |
|
| 동사는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- LocalResourceAccessReview 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
3장. LocalSubjectAccessReview [authorization.openshift.io/v1]
- 설명
LocalSubjectAccessReview는 사용자 또는 그룹이 특정 네임스페이스에서 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
네임스페이스
-
verb
-
resourceAPIGroup
-
resourceAPIVersion
-
resource
-
resourceName
-
path
-
isNonResourceURL
-
user
-
groups
-
범위
-
3.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| 콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다. | |
|
| 그룹은 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다. |
|
| IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음 |
|
| path는 리소스가 아닌 URL의 경로입니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. |
|
| group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다. |
|
| 버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다. |
|
| resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다. |
|
| 평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. Self-SAR의 경우 nil은 "이 요청에서 범위 사용"을 의미합니다. 일반 SAR의 경우 nil은 빈과 동일합니다. |
|
| 사용자는 선택 사항입니다. 사용자 및 그룹이 모두 비어 있으면 현재 인증된 사용자가 사용됩니다. |
|
| 동사는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- LocalSubjectAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
4장. ResourceAccessReview [authorization.openshift.io/v1]
- 설명
ResourceAccessReview는 spec에서 지정한 작업을 수행할 권한이 있는 사용자 및 그룹 목록을 요청할 수 있는 수단입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
네임스페이스
-
verb
-
resourceAPIGroup
-
resourceAPIVersion
-
resource
-
resourceName
-
path
-
isNonResourceURL
-
4.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| 콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다. | |
|
| IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음 |
|
| path는 리소스가 아닌 URL의 경로입니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. |
|
| group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다. |
|
| 버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다. |
|
| resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다. |
|
| 동사는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- ResourceAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
5장. SelfSubjectRulesReview [authorization.openshift.io/v1]
- 설명
SelfSubjectRulesReview는 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
5.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 |
|
| SelfSubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다. |
|
| SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다. |
5.1.1. .spec
- 설명
- SelfSubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.
- 유형
-
object
- 필수 항목
-
범위
-
속성 | 유형 | 설명 |
---|---|---|
|
| 평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. nil은 "이 요청에서 범위 사용"을 의미합니다. |
5.1.2. .status
- 설명
- SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.
- 유형
-
object
- 필수 항목
-
규칙
-
속성 | 유형 | 설명 |
---|---|---|
|
| evaluationError는 규칙과 함께 표시될 수 있습니다. 이는 평가 중에 추가 규칙이 채워지지 않을 수 있는 일부 오류가 발생했음을 의미합니다. |
|
| 규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다. |
|
| PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다. |
5.1.3. .status.rules
- 설명
- 규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.
- 유형
-
array
5.1.4. .status.rules[]
- 설명
- PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.
- 유형
-
object
- 필수 항목
-
verbs
-
resources
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다. |
| AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다. | |
|
| NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다. |
|
| resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다. |
|
| 리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다. |
|
| 동사는 이 규칙에 포함된 모든 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SelfSubjectRulesReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
6장. SubjectAccessReview [authorization.openshift.io/v1]
- 설명
subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지에 대한 정보를 요청하는 오브젝트입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
네임스페이스
-
verb
-
resourceAPIGroup
-
resourceAPIVersion
-
resource
-
resourceName
-
path
-
isNonResourceURL
-
user
-
groups
-
범위
-
6.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| 콘텐츠는 생성 및 업데이트 요청의 실제 콘텐츠입니다. | |
|
| GroupsSlice는 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다. |
|
| IsNonResourceURL은 리소스가 아닌 URL에 대한 요청(리소스 계층 구조 외부)인 경우 True입니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 네임스페이스와 모든 네임스페이스가 구분되지 않음 |
|
| path는 리소스가 아닌 URL의 경로입니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. |
|
| group은 인라인할 때 'groups' 필드와 혼동하지 않도록 하려면 resourceAPIGroup으로 직렬화된 리소스의 API 그룹입니다. |
|
| 버전이 resourceAPIVersion으로 직렬화된 리소스의 API 버전으로, 인라인할 때 TypeMeta.apiVersion 및 ObjectMeta.resourceVersion과 혼동을 방지합니다. |
|
| resourceName은 "get"에 대해 요청하거나 "삭제"에 대해 삭제되는 리소스의 이름입니다. |
|
| 평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. Self-SAR의 경우 nil은 "이 요청에서 범위 사용"을 의미합니다. 일반 SAR의 경우 nil은 빈과 동일합니다. |
|
| 사용자는 선택 사항입니다. 사용자 및 그룹이 모두 비어 있으면 현재 인증된 사용자가 사용됩니다. |
|
| 동사는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SubjectAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
7장. SubjectRulesReview [authorization.openshift.io/v1]
- 설명
SubjectRulesReview는 다른 사용자가 네임스페이스에서 수행할 수 있는 작업을 결정하기 위해 생성할 수 있는 리소스입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
7.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 |
|
| SubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다. |
|
| SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다. |
7.1.1. .spec
- 설명
- SubjectRulesReviewSpec은 검사를 수행하는 방법에 대한 정보를 추가합니다.
- 유형
-
object
- 필수 항목
-
user
-
groups
-
범위
-
속성 | 유형 | 설명 |
---|---|---|
|
| 그룹은 선택 사항입니다. 그룹은 사용자가 속한 그룹 목록입니다. 사용자 및 그룹 중 하나 이상을 지정해야 합니다. |
|
| 평가에 사용할 범위입니다. 비어 있는 것은 "사용자/그룹의 범위가 지정되지 않은(완전) 권한 사용"을 의미합니다. |
|
| 사용자는 선택 사항입니다. 사용자 및 그룹 중 하나 이상을 지정해야 합니다. |
7.1.2. .status
- 설명
- SubjectRulesReviewStatus는 규칙 검사 결과를 포함합니다.
- 유형
-
object
- 필수 항목
-
규칙
-
속성 | 유형 | 설명 |
---|---|---|
|
| evaluationError는 규칙과 함께 표시될 수 있습니다. 이는 평가 중에 추가 규칙이 채워지지 않을 수 있는 일부 오류가 발생했음을 의미합니다. |
|
| 규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다. |
|
| PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다. |
7.1.3. .status.rules
- 설명
- 규칙은 제목에 허용되는 규칙 목록(특정 정렬 없음)입니다.
- 유형
-
array
7.1.4. .status.rules[]
- 설명
- PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.
- 유형
-
object
- 필수 항목
-
verbs
-
resources
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다. |
| AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다. | |
|
| NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다. |
|
| resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다. |
|
| 리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다. |
|
| 동사는 이 규칙에 포함된 모든 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SubjectRulesReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
8장. TokenRequest [authentication.k8s.io/v1]
- 설명
- TokenRequest는 지정된 서비스 계정에 대한 토큰을 요청합니다.
- 유형
-
object
- 필수 항목
-
spec
-
8.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 | |
|
| TokenRequestSpec에는 토큰 요청의 클라이언트 제공 매개변수가 포함되어 있습니다. |
|
| TokenRequestStatus는 토큰 요청의 결과입니다. |
8.1.1. .spec
- 설명
- TokenRequestSpec에는 토큰 요청의 클라이언트 제공 매개변수가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
대상
-
속성 | 유형 | 설명 |
---|---|---|
|
| 대상은 토큰의 의도적인 대상입니다. 토큰 수신자는 토큰 대상 목록에 있는 식별자로 해당 ID를 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 여러 대상자에게 발행되는 토큰은 나열된 대상자에 대해 인증하는 데 사용할 수 있지만 대상 대상 그룹 간의 높은 신뢰 수준을 의미합니다. |
|
| BoundObjectReference는 토큰이 바인딩된 오브젝트에 대한 참조입니다. |
|
| ExpirationSeconds는 요청된 요청의 유효 기간입니다. 토큰 발행자는 다른 유효 기간이 있는 토큰을 반환할 수 있으므로 클라이언트가 응답에서 '종료' 필드를 확인해야 합니다. |
8.1.2. .spec.boundObjectRef
- 설명
- BoundObjectReference는 토큰이 바인딩된 오브젝트에 대한 참조입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 일종의 추천입니다. 유효한 종류는 'Pod' 및 'Secret'입니다. |
|
| 추천자의 이름입니다. |
|
| 참조의 UID입니다. |
8.1.3. .status
- 설명
- TokenRequestStatus는 토큰 요청의 결과입니다.
- 유형
-
object
- 필수 항목
-
token
-
expirationTimestamp
-
속성 | 유형 | 설명 |
---|---|---|
| ExpirationTimestamp는 반환된 토큰의 만료 시간입니다. | |
|
| 토큰은 opaque 전달자 토큰입니다. |
8.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/api/v1/namespaces/{namespace}/serviceaccounts/{name}/token
-
POST
: ServiceAccount의 토큰 생성
-
8.2.1. /api/v1/namespaces/{namespace}/serviceaccounts/{name}/token
매개변수 | 유형 | 설명 |
---|---|---|
|
| TokenRequest의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- ServiceAccount의 토큰 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
9장. TokenReview [authentication.k8s.io/v1]
- 설명
- TokenReview는 알려진 사용자에게 토큰을 인증하려고 합니다. 참고: TokenReview 요청은 kube-apiserver의 Webhook 토큰 인증 플러그인에 의해 캐시될 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
9.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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는 토큰 인증 요청의 결과입니다. |
9.1.1. .spec
- 설명
- TokenReviewSpec은 토큰 인증 요청에 대한 설명입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 대상자는 토큰과 함께 제공되는 리소스 서버가 로 식별되는 식별자 목록입니다. 대상자 인식 토큰 인증자는 토큰이 이 목록의 대상 중 하나 이상을 대상으로 되었는지 확인합니다. 대상자가 제공되지 않는 경우 대상자는 기본적으로 Kubernetes apiserver 대상으로 설정됩니다. |
|
| 토큰은 opaque 전달자 토큰입니다. |
9.1.2. .status
- 설명
- TokenReviewStatus는 토큰 인증 요청의 결과입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 대상자는 인증자가 선택한 대상 식별자로, TokenReview 및 토큰과 호환됩니다. 식별자는 TokenReviewSpec 대상 및 토큰의 대상의 교차점에 있는 식별자입니다. spec.audiences 필드를 설정하는 TokenReview API의 클라이언트는 호환되는 대상 식별자가 status.audiences 필드에서 반환되어 TokenReview 서버가 인식되는지 확인해야 합니다. TokenReview에서 status.authenticated가 "true"인 빈 status.audience 필드를 반환하는 경우 토큰은 Kubernetes API 서버의 대상에 대해 유효합니다. |
|
| authenticated은 토큰이 알려진 사용자와 연결되어 있음을 나타냅니다. |
|
| 오류는 토큰을 확인할 수 없음을 나타냅니다. |
|
| userinfo에는 user.Info 인터페이스를 구현하는 데 필요한 사용자에 대한 정보가 들어 있습니다. |
9.1.3. .status.user
- 설명
- userinfo에는 user.Info 인터페이스를 구현하는 데 필요한 사용자에 대한 정보가 들어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 인증자가 제공하는 추가 정보. |
|
| |
|
| 이 사용자가 속한 그룹의 이름입니다. |
|
| 시간 경과에 따라 이 사용자를 식별하는 고유한 값입니다. 이 사용자가 삭제되고 동일한 이름의 다른 사용자가 추가되면 UID가 다릅니다. |
|
| 모든 활성 사용자 중에서 이 사용자를 고유하게 식별하는 이름입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- TokenReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
9.2.2. /apis/authentication.k8s.io/v1/tokenreviews
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- TokenReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
10장. LocalSubjectAccessReview [authorization.k8s.io/v1]
- 설명
- LocalSubjectAccessReview는 사용자 또는 그룹이 지정된 네임스페이스에서 작업을 수행할 수 있는지 여부를 확인합니다. 네임스페이스 범위 리소스를 사용하면 권한 확인을 포함하는 네임스페이스 범위 정책을 훨씬 쉽게 부여할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
10.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 | |
|
| SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다. |
|
| SubjectAccessReviewStatus |
10.1.1. .spec
- 설명
- SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다. |
|
| |
|
| 그룹은 테스트 중인 그룹입니다. |
|
| NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
|
| ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
|
| 요청하는 사용자에 대한 UID 정보입니다. |
|
| 사용자가 테스트 중인 사용자입니다. "User"를 지정하지만 "그룹"은 지정하지 않으면 "사용자가 어떤 그룹의 멤버가 아닌 경우 어떻게 해야 합니까? |
10.1.2. .spec.extra
- 설명
- extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.
- 유형
-
object
10.1.3. .spec.nonResourceAttributes
- 설명
- NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| path는 요청의 URL 경로입니다. |
|
| 동사는 표준 HTTP 동사입니다. |
10.1.4. .spec.resourceAttributes
- 설명
- ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다. |
|
| name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다. |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다. |
|
| 하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다. |
|
| 동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다. |
|
| 버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다. |
10.1.5. .status
- 설명
- SubjectAccessReviewStatus
- 유형
-
object
- 필수 항목
-
허용됨
-
속성 | 유형 | 설명 |
---|---|---|
|
| 허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다. |
|
| 거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다. |
|
| evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다. |
|
| 이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- LocalSubjectAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
11장. SelfSubjectAccessReview [authorization.k8s.io/v1]
- 설명
- SelfSubjectAccessReview는 현재 사용자가 작업을 수행할 수 있는지 여부를 확인합니다. spec.namespace를 채우지 않으면 "모든 네임스페이스에서"를 의미합니다. 사용자가 작업을 수행할 수 있는지 항상 확인할 수 있기 때문에 Self는 특별한 경우입니다.
- 유형
-
object
- 필수 항목
-
spec
-
11.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 | |
|
| SelfSubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다. |
|
| SubjectAccessReviewStatus |
11.1.1. .spec
- 설명
- SelfSubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
|
| ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
11.1.2. .spec.nonResourceAttributes
- 설명
- NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| path는 요청의 URL 경로입니다. |
|
| 동사는 표준 HTTP 동사입니다. |
11.1.3. .spec.resourceAttributes
- 설명
- ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다. |
|
| name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다. |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다. |
|
| 하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다. |
|
| 동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다. |
|
| 버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다. |
11.1.4. .status
- 설명
- SubjectAccessReviewStatus
- 유형
-
object
- 필수 항목
-
허용됨
-
속성 | 유형 | 설명 |
---|---|---|
|
| 허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다. |
|
| 거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다. |
|
| evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다. |
|
| 이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다. |
11.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/authorization.k8s.io/v1/selfsubjectaccessreviews
-
POST
: SelfSubjectAccessReview 생성
-
11.2.1. /apis/authorization.k8s.io/v1/selfsubjectaccessreviews
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SelfSubjectAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
12장. SelfSubjectRulesReview [authorization.k8s.io/v1]
- 설명
- SelfSubjectRulesReview는 현재 사용자가 네임스페이스 내에서 수행할 수 있는 작업 집합을 열거합니다. 반환된 작업 목록은 서버의 권한 부여 모드 및 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. SelfSubjectRulesReview는 UI에서 작업을 표시/해제하거나 최종 사용자가 권한에 대해 신속하게 이유하도록 하는 데 사용해야 합니다. 이로 인해 혼동되는 결정, 캐시 수명/복사 및 정확성 문제가 발생하므로 외부 시스템에서 권한 부여 결정을 내리면 안 됩니다. subjectAccessReview 및 LocalAccessReview는 API 서버에 권한 부여 결정을 지연하는 올바른 방법입니다.
- 유형
-
object
- 필수 항목
-
spec
-
12.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 | |
|
| SelfSubjectRulesReviewSpec은 SelfSubjectRulesReview의 사양을 정의합니다. |
|
| SubjectRulesReviewStatus에는 규칙 검사 결과가 포함되어 있습니다. 이 검사는 서버가 구성된 인증자 세트와 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. 권한 부여 규칙이 추가되므로 목록에 규칙이 표시되면 제목에 해당 권한이 있다고 가정하는 것이 안전합니다. |
12.1.1. .spec
- 설명
- SelfSubjectRulesReviewSpec은 SelfSubjectRulesReview의 사양을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 규칙을 평가할 네임스페이스입니다. 필수 항목입니다. |
12.1.2. .status
- 설명
- SubjectRulesReviewStatus에는 규칙 검사 결과가 포함되어 있습니다. 이 검사는 서버가 구성된 인증자 세트와 평가 중에 발생한 오류에 따라 불완전할 수 있습니다. 권한 부여 규칙이 추가되므로 목록에 규칙이 표시되면 제목에 해당 권한이 있다고 가정하는 것이 안전합니다.
- 유형
-
object
- 필수 항목
-
resourceRules
-
비ResourceRules
-
incomplete
-
속성 | 유형 | 설명 |
---|---|---|
|
| evaluationError는 규칙과 함께 표시될 수 있습니다. 규칙 평가를 지원하지 않는 인증자와 같이 규칙 평가 중에 발생한 오류를 나타내며 ResourceRules 및/또는 NonResourceRules가 불완전할 수 있습니다. |
|
| 이 호출에서 반환된 규칙이 불완전하면 불완전합니다. 이는 외부 인증자와 같은 승인자가 규칙 평가를 지원하지 않는 경우 가장 일반적으로 발생합니다. |
|
| NonResourceRules는 리소스가 아닌 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다. |
|
| NonResourceRule는 리소스가 아닌 리소스에 대한 규칙을 설명하는 정보를 보유합니다. |
|
| ResourceRules는 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다. |
|
| ResourceRule은 주체가 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다. |
12.1.3. .status.nonResourceRules
- 설명
- NonResourceRules는 리소스가 아닌 리소스에서 수행할 수 있는 작업 목록입니다. 목록 순서는 중요하지 않으며 중복을 포함할 수 있으며 불완전할 수 있습니다.
- 유형
-
array
12.1.4. .status.nonResourceRules[]
- 설명
- NonResourceRule는 리소스가 아닌 리소스에 대한 규칙을 설명하는 정보를 보유합니다.
- 유형
-
object
- 필수 항목
-
verbs
-
속성 | 유형 | 설명 |
---|---|---|
|
| NonResourceURLs는 사용자가 액세스할 수 있어야 하는 부분적인 URL 세트입니다. s는 허용되지만 경로의 전체 최종 단계로만 허용됩니다. "모두를 의미합니다. |
|
| 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는 리소스가 포함된 APIGroup의 이름입니다. 여러 API 그룹이 지정되면 API 그룹에서 열거된 리소스 중 하나에 대해 요청된 모든 작업이 허용됩니다. "*"는 모든 것을 의미합니다. |
|
| resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다. "*"는 모든 것을 의미합니다. |
|
| resources는 이 규칙이 적용되는 리소스 목록입니다."은 지정된 apiGroups에 있는 모든 리소스를 의미합니다. "/foo"는 지정된 apiGroups의 모든 리소스에 대한 하위 리소스 'foo'를 나타냅니다. |
|
| 동사는 다음과 같은 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SelfSubjectRulesReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
13장. SubjectAccessReview [authorization.k8s.io/v1]
- 설명
- subjectAccessReview는 사용자 또는 그룹이 작업을 수행할 수 있는지 여부를 확인합니다.
- 유형
-
object
- 필수 항목
-
spec
-
13.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 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 | |
|
| SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다. |
|
| SubjectAccessReviewStatus |
13.1.1. .spec
- 설명
- SubjectAccessReviewSpec은 액세스 요청에 대한 설명입니다. ResourceAuthorizationAttributes 및 NonResourceAuthorizationAttributes 중 하나를 설정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다. |
|
| |
|
| 그룹은 테스트 중인 그룹입니다. |
|
| NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
|
| ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다. |
|
| 요청하는 사용자에 대한 UID 정보입니다. |
|
| 사용자가 테스트 중인 사용자입니다. "User"를 지정하지만 "그룹"은 지정하지 않으면 "사용자가 어떤 그룹의 멤버가 아닌 경우 어떻게 해야 합니까? |
13.1.2. .spec.extra
- 설명
- extra는 Authenticator의 user.Info.GetExtra() 메서드에 해당합니다. 이는 승인자에 대한 입력이므로 여기에 반영이 필요합니다.
- 유형
-
object
13.1.3. .spec.nonResourceAttributes
- 설명
- NonResourceAttributes에는 Authorizer 인터페이스에 대한 리소스가 아닌 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| path는 요청의 URL 경로입니다. |
|
| 동사는 표준 HTTP 동사입니다. |
13.1.4. .spec.resourceAttributes
- 설명
- ResourceAttributes에는 Authorizer 인터페이스에 리소스 요청에 사용할 수 있는 권한 부여 속성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| group은 리소스의 API 그룹입니다. "*"는 모든 것을 의미합니다. |
|
| name은 "get"에 대해 요청되거나 "삭제"에 대해 요청된 리소스의 이름입니다. ""(비어 있음)는 모두 의미합니다. |
|
| namespace는 요청된 작업의 네임스페이스입니다. 현재는 LocalSubjectAccessReviews ""(비어 있음)에 대해 네임스페이스와 모든 네임스페이스 ""(빈)가 기본적으로 비어 있는 경우 클러스터 범위 리소스 ""(빈)는 SubjectAccessReview 또는 SelfSubjectAccessReview의 네임스페이스 범위 리소스에 대해 "all"을 의미합니다. |
|
| 리소스는 기존 리소스 유형 중 하나입니다. "*"는 모든 것을 의미합니다. |
|
| 하위 리소스는 기존 리소스 유형 중 하나입니다. ""는 none을 의미합니다. |
|
| 동사는 get, list, watch, create, update, delete, proxy와 같은 kubernetes 리소스 API 동사입니다. "*"는 모든 것을 의미합니다. |
|
| 버전은 리소스의 API 버전입니다. "*"는 모든 것을 의미합니다. |
13.1.5. .status
- 설명
- SubjectAccessReviewStatus
- 유형
-
object
- 필수 항목
-
허용됨
-
속성 | 유형 | 설명 |
---|---|---|
|
| 허용되는 것이 필요합니다. 작업이 허용되면 true이고, 그렇지 않으면 false입니다. |
|
| 거부됨은 선택 사항입니다. 작업이 거부되면 true이고, 그렇지 않으면 false입니다. 허용되는 것이 모두 false이고 거부된 경우 승인자는 작업을 승인할지 여부에 대한 의견이 없습니다. Allowed가 true인 경우 거부되지 않을 수 있습니다. |
|
| evaluationError는 권한 부여 확인 중에 일부 오류가 발생했음을 나타냅니다. 오류가 발생하여 권한 부여 상태를 계속 확인할 수 있습니다. 예를 들어 RBAC는 역할을 누락할 수 있지만 충분한 역할이 여전히 존재하며 요청에 대한 이유에 바인딩됩니다. |
|
| 이유는 선택 사항입니다. 요청이 허용 또는 거부된 이유를 나타냅니다. |
13.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/authorization.k8s.io/v1/subjectaccessreviews
-
POST
: SubjectAccessReview 생성
-
13.2.1. /apis/authorization.k8s.io/v1/subjectaccessreviews
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- SubjectAccessReview 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
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.