TeleportScopedRoleV1
Teleport v18.11요약
이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportScopedRoleV1 리소스의 필드를 나열합니다. apiVersion: resources.teleport.dev/v1
이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportScopedRoleV1
리소스의 필드를 나열합니다.
resources.teleport.dev/v1#
apiVersion: resources.teleport.dev/v1
| 필드 | 타입 | 설명 |
|---|---|---|
| apiVersion | string | APIVersion은 이 객체 표현의 버전이 지정된 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값은 거부할 수 있습니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
| kind | string | Kind는 이 객체가 나타내는 REST 리소스를 나타내는 문자열 값입니다. 서버는 클라이언트가 요청을 제출하는 엔드포인트에서 이를 추론할 수 있습니다. 업데이트할 수 없습니다. CamelCase 형식입니다. 자세한 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| metadata | object | |
| scope | string | 역할 리소스의 스코프입니다. |
| spec | object | Teleport의 ScopedRole 리소스 정의 v1 |
spec#
| 필드 | 타입 | 설명 |
|---|---|---|
| app | object | 스코프 지정 역할에 대한 애플리케이션 접근 전용 구성입니다. |
| assignable_scopes | []string | AssignableScopes는 이 역할을 할당할 수 있는 스코프 목록입니다. 비어 있으면 기본적으로 리소스 스코프와 그 모든 하위 스코프에 할당할 수 있습니다. 루트 스코프 역할에는 기본값이 없으므로 할당 가능한 스코프를 명시적으로 지정해야 합니다. |
| defaults | object | Defaults는 여러 프로토콜에 공통으로 적용되는 제어 항목의 기본값을 지정합니다. defaults에 지정한 제어 항목이 프로토콜 블록에도 지정된 경우 프로토콜 블록의 값이 우선합니다. |
| evaluation | object | Evaluation은 역할이 평가되는 방식을 결정하는 역할 수준 설정을 묶습니다. |
| kube | object | 스코프 지정 역할에 대한 쿠버네티스 전용 구성입니다. |
| rules | []object | Rules는 기본적인 resource:verb 권한(예: scoped_role:read)을 설명합니다. |
| ssh | object | Ssh는 SSH 접근을 제어하는 항목을 지정합니다. |
| workload_identity | object | WorkloadIdentity는 WorkloadIdentity 리소스를 사용한 발급을 제어하는 항목을 지정합니다. |
spec.app#
| 필드 | 타입 | 설명 |
|---|---|---|
| aws | object | AWS는 스코프 지정 역할에 대한 AWS 구성을 포함합니다. |
| client_idle_timeout | string | defaults 블록의 유휴 타임아웃을 애플리케이션 세션에 한해 재정의합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| disconnect_expired_cert | boolean | DisconnectExpiredCert는 사용자 인증서가 만료될 때 애플리케이션 세션의 연결을 끊을지 여부를 제어합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| label_expression | string | LabelExpression은 애플리케이션의 라벨을 대상으로 평가되는 선택적 프레디킷 표현식입니다. |
| labels | []object | RBAC에 사용되는 애플리케이션 라벨 집합입니다. |
| lock | object | Lock은 애플리케이션 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
spec.app.aws#
| 필드 | 타입 | 설명 |
|---|---|---|
| role_arns | []string | RoleArns는 이 스코프 지정 애플리케이션에 허용할 AWS 역할 ARN을 지정합니다. |
spec.app.labels items#
| 필드 | 타입 | 설명 |
|---|---|---|
| name | string | 라벨의 이름입니다. |
| values | []string | 라벨에 연결된 값입니다. |
spec.app.lock#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | 허용되는 값: strict 또는 best_effort. 설정하지 않으면 클러스터 전체 인증 환경 설정의 값이 기본값으로 사용됩니다. |
spec.defaults#
| 필드 | 타입 | 설명 |
|---|---|---|
| client_idle_timeout | string | ClientIdleTimeout은 자체 값을 지정하지 않은 모든 프로토콜의 접근 세션에 대한 기본 유휴 타임아웃을 설정합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 이 항목과 프로토콜의 해당 제어 항목이 모두 설정되지 않은 경우에만 클러스터 전체 기본값이 사용됩니다. |
| disconnect_expired_cert | boolean | DisconnectExpiredCert는 세션의 인증서가 만료될 때 모든 프로토콜에 적용되는 기본 동작을 정의합니다. 이 항목과 프로토콜의 해당 제어 항목이 모두 설정되지 않은 경우에만 클러스터 전체 기본값이 사용됩니다. |
| lock | object | Lock은 자체 값을 지정하지 않은 모든 프로토콜의 접근 세션에 대한 기본 잠금 모드를 지정합니다. 이 항목과 프로토콜의 해당 제어 항목이 모두 설정되지 않은 경우에만 클러스터 전체 기본값이 사용됩니다. |
| session_recording | object | SessionRecording은 세션 녹화 모드를 명시적으로 설정하지 않은 모든 프로토콜의 세션 녹화 전략을 구성합니다. 이 항목과 프로토콜의 해당 제어 항목이 모두 설정되지 않으면 best_effort가 사용됩니다. |
spec.defaults.lock#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | 허용되는 값: strict 또는 best_effort. 설정하지 않으면 클러스터 전체 인증 환경 설정의 값이 기본값으로 사용됩니다. |
spec.defaults.session_recording#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | Mode는 세션 녹화 모드를 설정합니다. 허용되는 값: strict 또는 best_effort. |
spec.evaluation#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | Mode는 역할의 평가 모드를 결정합니다. 허용되는 값은 'inclusive'(기본값)와 'exclusive'입니다. 기본값인 inclusive 모드에서는 일치하는 여러 역할의 권한을 결합할 수 있습니다. 역할을 exclusive로 설정하면 처음 일치한 역할이 해당 접근 시도의 모든 권한과 제어 항목을 전적으로 결정합니다. Inclusive는 일상적인 관리가 더 쉽고, exclusive는 더 엄격한 제어를 제공합니다. |
spec.kube#
| 필드 | 타입 | 설명 |
|---|---|---|
| client_idle_timeout | string | defaults 블록의 유휴 타임아웃을 쿠버네티스 세션에 한해 재정의합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| disconnect_expired_cert | boolean | DisconnectExpiredCert는 사용자 인증서가 만료될 때 쿠버네티스 세션의 연결을 끊을지 여부를 제어합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| groups | []string | 이 역할이 허용하는 쿠버네티스 그룹 목록입니다. |
| label_expression | string | LabelExpression은 쿠버네티스 서버의 라벨을 대상으로 평가되는 선택적 프레디킷 표현식입니다. |
| labels | []object | RBAC에 사용되는 쿠버네티스 클러스터 라벨 맵입니다. |
| lock | object | Lock은 쿠버네티스 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| resources | []object | 이 역할이 접근을 허용하는 쿠버네티스 리소스입니다. |
| users | []string | 이 역할이 허용하는, 임퍼소네이션할 수 있는 쿠버네티스 사용자의 선택적 목록입니다. |
spec.kube.labels items#
| 필드 | 타입 | 설명 |
|---|---|---|
| name | string | 라벨의 이름입니다. |
| values | []string | 라벨에 연결된 값입니다. |
spec.kube.lock#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | 허용되는 값: strict 또는 best_effort. 설정하지 않으면 클러스터 전체 인증 환경 설정의 값이 기본값으로 사용됩니다. |
spec.kube.resources items#
| 필드 | 타입 | 설명 |
|---|---|---|
| api_group | string | 쿠버네티스 리소스의 API 그룹입니다. 와일드카드를 지원합니다. |
| kind | string | 쿠버네티스 리소스 유형입니다. |
| name | string | 쿠버네티스 리소스 이름입니다. 와일드카드를 지원합니다. |
| namespace | string | 쿠버네티스 리소스 네임스페이스입니다. 와일드카드를 지원합니다. |
| verbs | []string | 쿠버네티스 리소스와 상호 작용할 때 허용되는 쿠버네티스 verb입니다. |
spec.rules items#
| 필드 | 타입 | 설명 |
|---|---|---|
| resources | []string | Resources는 아래 verb가 적용되는 리소스 종류(예: 'scoped_token')의 목록입니다. |
| verbs | []string | Verbs는 위 리소스에 적용되는 동작 verb(예: 'read')의 목록입니다. |
spec.ssh#
| 필드 | 타입 | 설명 |
|---|---|---|
| client_idle_timeout | string | ClientIdleTimeout은 defaults 블록의 유휴 타임아웃을 SSH 세션에 한해 재정의합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| disconnect_expired_cert | boolean | DisconnectExpiredCert는 사용자 인증서가 만료될 때 SSH 세션의 연결을 끊을지 여부를 제어합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| enhanced_recording | object | EnhancedRecording은 향상된 세션 녹화를 위해 기록할 BPF 이벤트 집합입니다. |
| file_copy | boolean | FileCopy는 SSH 세션에서 SCP 또는 SFTP를 통한 원격 파일 작업을 허용할지 여부를 나타냅니다. 설정하지 않으면 원격 파일 작업이 허용되지 않습니다. |
| forward_agent | boolean | ForwardAgent는 SSH 에이전트 포워딩을 활성화합니다. |
| host_sudoers | []string | Sudoers는 사용자의 sudoer 파일에 포함할 항목의 목록입니다. |
| host_user_creation | object | HostUserCreation은 호스트 사용자 생성을 구성합니다. |
| label_expression | string | LabelExpression은 SSH 노드의 라벨을 대상으로 평가되는 선택적 프레디킷 표현식입니다. |
| labels | []object | Labels는 이 역할이 적용되는 노드를 동적으로 선택하는 데 사용되는 노드 라벨 집합입니다. |
| lock | object | Lock은 SSH 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. |
| logins | []string | Logins는 이 역할이 일치하는 노드에서 허용하는 OS 로그인 목록입니다. |
| max_sessions | integer | MaxSessions는 연결당 최대 동시 세션 수를 정의합니다. |
| permit_x11_forwarding | boolean | PermitX11Forwarding이 true이면 SSH 세션에서 X11 포워딩 사용을 허용합니다. 설정하지 않으면 X11 포워딩이 허용되지 않습니다. |
| port_forwarding | object | SSHPortForwarding은 역할이 허용하는 SSH 포트 포워딩의 유형을 구성합니다. |
| session_recording | object | SessionRecording은 SSH 세션의 세션 녹화 전략을 구성합니다. |
spec.ssh.enhanced_recording#
| 필드 | 타입 | 설명 |
|---|---|---|
| command | boolean | Command는 감사 로그의 session.command를 활성화합니다. |
| disk | boolean | Disk는 감사 로그의 session.disk를 활성화합니다. |
| network | boolean | Network는 감사 로그의 session.network를 활성화합니다. |
spec.ssh.host_user_creation#
| 필드 | 타입 | 설명 |
|---|---|---|
| groups | []string | Groups는 사용자를 추가할 호스트 그룹의 목록입니다. |
| mode | string | Mode는 호스트 사용자를 생성하는 방식을 지정합니다. |
| shell | string | Shell은 사용자에게 설정할 셸입니다. |
spec.ssh.labels items#
| 필드 | 타입 | 설명 |
|---|---|---|
| name | string | 라벨의 이름입니다. |
| values | []string | 라벨에 연결된 값입니다. |
spec.ssh.lock#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | 허용되는 값: strict 또는 best_effort. 설정하지 않으면 클러스터 전체 인증 환경 설정의 값이 기본값으로 사용됩니다. |
spec.ssh.port_forwarding#
spec.ssh.port_forwarding.local#
| 필드 | 타입 | 설명 |
|---|---|---|
| enabled | boolean | Enabled가 true이면 로컬 포트 포워딩을 허용합니다. 설정하지 않으면 로컬 포트 포워딩이 허용되지 않습니다. |
spec.ssh.port_forwarding.remote#
| 필드 | 타입 | 설명 |
|---|---|---|
| enabled | boolean | Enabled가 true이면 원격 포트 포워딩을 허용합니다. 설정하지 않으면 원격 포트 포워딩이 허용되지 않습니다. |
spec.ssh.session_recording#
| 필드 | 타입 | 설명 |
|---|---|---|
| mode | string | Mode는 세션 녹화 모드를 설정합니다. 허용되는 값: strict 또는 best_effort. |
spec.workload_identity#
| 필드 | 타입 | 설명 |
|---|---|---|
| labels | []object | Labels는 이 역할이 발급을 허용하는 WorkloadIdentity 리소스를 동적으로 선택하는 데 사용되는 WorkloadIdentity 라벨 집합입니다. 발급하려면 호출자가 해당 스코프에서 workload_identity 종류에 대한 read_no_secrets 규칙(다중 발급 RPC의 경우 list 규칙도)을 보유해야 합니다. |
spec.workload_identity.labels items#
| 필드 | 타입 | 설명 |
|---|---|---|
| name | string | 라벨의 이름입니다. |
| values | []string | 라벨에 연결된 값입니다. |