teleport_scoped_role Terraform 리소스 참조
Teleport v18.11이 페이지는 Teleport Terraform 공급자의 teleport_scoped_role 리소스에서 지원되는 값을 설명합니다.
사용 예제#
# Teleport Scoped Role resource
resource "teleport_scoped_role" "example" {
version = "v1"
metadata = {
name = "example-scoped-role"
description = "An example scoped role for managing resources within /staging"
labels = {
env = "staging"
}
}
scope = "/staging"
spec = {
assignable_scopes = ["/staging/aa", "/staging/bb"]
rules = [{
resources = ["scoped_token"]
verbs = ["read", "list"]
}]
ssh = {
logins = ["root"]
}
}
}
스키마#
필수#
metadata(Attributes) Metadata는 리소스 메타데이터를 포함합니다. (아래 중첩 스키마 참조)scope(String) Scope는 역할 리소스의 스코프입니다.spec(Attributes) Spec은 역할 명세입니다. (아래 중첩 스키마 참조)version(String) Version은 리소스 버전입니다.
선택적#
sub_kind(String) SubKind는 리소스 하위 종류입니다.
metadata에 대한 중첩 스키마#
필수:
name(String) name은 객체 이름입니다.
선택적:
description(String) description은 객체 설명입니다.expires(String) expires는 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.labels(Map of String) labels는 레이블 집합입니다.
spec에 대한 중첩 스키마#
필수:
assignable_scopes(List of String) AssignableScopes는 이 역할을 할당할 수 있는 스코프 목록입니다. 비어 있으면 기본적으로 리소스 스코프와 모든 하위 스코프에 할당할 수 있습니다. 루트 스코프 역할에는 기본값이 없으며 할당 가능한 스코프를 명시적으로 지정해야 합니다.
선택적:
app(Attributes) 스코프 역할의 애플리케이션 접근 전용 구성입니다. (아래 중첩 스키마 참조)defaults(Attributes) Defaults는 여러 프로토콜에 공통으로 적용되는 제어 항목의 기본값을 지정합니다. defaults에 지정한 제어 항목이 프로토콜 블록에도 지정된 경우 프로토콜 블록의 값이 우선합니다. (아래 중첩 스키마 참조)evaluation(Attributes) Evaluation은 역할이 평가되는 방식을 결정하는 역할 수준 설정을 묶습니다. (아래 중첩 스키마 참조)kube(Attributes) 스코프 역할의 쿠버네티스 전용 구성입니다. (아래 중첩 스키마 참조)rules(Attributes List) Rules는 기본적인 resource:verb 권한(예: scoped_role:read)을 설명합니다. (아래 중첩 스키마 참조)ssh(Attributes) Ssh는 SSH 접근을 제어하는 항목을 지정합니다. (아래 중첩 스키마 참조)workload_identity(Attributes) WorkloadIdentity는 WorkloadIdentity 리소스를 사용한 발급을 제어하는 항목을 지정합니다. (아래 중첩 스키마 참조)
spec.app에 대한 중첩 스키마#
선택적:
aws(Attributes) AWS는 스코프 역할의 AWS 구성을 포함합니다. (아래 중첩 스키마 참조)client_idle_timeout(String) 앱 세션에 한해 defaults 블록의 유휴 시간 제한을 재정의합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다.disconnect_expired_cert(Boolean) DisconnectExpiredCert는 사용자 인증서가 만료될 때 앱 세션의 연결을 끊을지 여부를 제어합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다.label_expression(String) LabelExpression은 애플리케이션의 레이블에 대해 평가되는 선택적 프레디킷 표현식입니다.labels(Attributes List) RBAC에 사용되는 애플리케이션 레이블 집합입니다. (아래 중첩 스키마 참조)lock(Attributes) Lock은 앱 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. (아래 중첩 스키마 참조)
spec.app.aws에 대한 중첩 스키마#
선택적:
role_arns(List of String) RoleArns는 이 스코프 앱에 허용할 AWS 역할 ARN을 지정합니다.
spec.app.labels에 대한 중첩 스키마#
선택적:
name(String) 레이블의 이름입니다.values(List of 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(Attributes) Lock은 자체 값을 지정하지 않은 모든 프로토콜의 접근 세션에 적용되는 기본 잠금 모드를 지정합니다. 이 항목과 프로토콜의 해당 제어 항목이 모두 설정되지 않은 경우에만 클러스터 전체 기본값이 사용됩니다. (아래 중첩 스키마 참조)session_recording(Attributes) 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(List of String) 이 역할이 허용하는 쿠버네티스 그룹 목록입니다.label_expression(String) LabelExpression은 쿠버네티스 서버의 레이블에 대해 평가되는 선택적 프레디킷 표현식입니다.labels(Attributes List) RBAC에 사용되는 쿠버네티스 클러스터 레이블 맵입니다. (아래 중첩 스키마 참조)lock(Attributes) Lock은 쿠버네티스 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. (아래 중첩 스키마 참조)resources(Attributes List) 이 역할이 접근을 허용하는 쿠버네티스 리소스입니다. (아래 중첩 스키마 참조)users(List of String) 이 역할이 허용하는, 임퍼소네이션할 수 있는 쿠버네티스 사용자의 선택적 목록입니다.
spec.kube.labels에 대한 중첩 스키마#
선택적:
name(String) 레이블의 이름입니다.values(List of String) 레이블과 연결된 값입니다.
spec.kube.lock에 대한 중첩 스키마#
선택적:
mode(String) 허용되는 값은 strict 또는 best_effort입니다. 설정하지 않으면 클러스터 전체 인증 기본 설정의 값이 기본값입니다.
spec.kube.resources에 대한 중첩 스키마#
선택적:
api_group(String) 쿠버네티스 리소스의 API 그룹입니다. 와일드카드를 지원합니다.kind(String) 쿠버네티스 리소스 유형입니다.name(String) 쿠버네티스 리소스 이름입니다. 와일드카드를 지원합니다.namespace(String) 쿠버네티스 리소스 네임스페이스입니다. 와일드카드를 지원합니다.verbs(List of String) 쿠버네티스 리소스와 상호 작용할 때 허용되는 쿠버네티스 verb입니다.
spec.rules에 대한 중첩 스키마#
선택적:
resources(List of String) Resources는 아래 verbs가 적용되는 리소스 종류(예: 'scoped_token')의 목록입니다.verbs(List of String) Verbs는 위 리소스에 적용되는 동작 verb(예: 'read')의 목록입니다.
spec.ssh에 대한 중첩 스키마#
선택적:
client_idle_timeout(String) ClientIdleTimeout은 SSH 세션에 한해 defaults 블록의 유휴 시간 제한을 재정의합니다. 유효한 Go duration 문자열(예: "30m", "1h")이어야 합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다.disconnect_expired_cert(Boolean) DisconnectExpiredCert는 사용자 인증서가 만료될 때 SSH 세션의 연결을 끊을지 여부를 제어합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다.enhanced_recording(Attributes) EnhancedRecording은 향상된 세션 녹화를 위해 기록할 BPF 이벤트 집합입니다. (아래 중첩 스키마 참조)file_copy(Boolean) FileCopy는 SSH 세션에서 SCP 또는 SFTP를 통한 원격 파일 작업을 허용할지 여부를 나타냅니다. 설정하지 않으면 원격 파일 작업이 허용되지 않습니다.forward_agent(Boolean) ForwardAgent는 SSH 에이전트 포워딩을 활성화합니다.host_sudoers(List of String) Sudoers는 사용자의 sudoer 파일에 포함할 항목의 목록입니다.host_user_creation(Attributes) HostUserCreation은 호스트 사용자 생성을 구성합니다. (아래 중첩 스키마 참조)label_expression(String) LabelExpression은 SSH 노드의 레이블에 대해 평가되는 선택적 프레디킷 표현식입니다.labels(Attributes List) Labels는 이 역할이 적용되는 노드를 동적으로 선택하는 데 사용되는 노드 레이블 집합입니다. (아래 중첩 스키마 참조)lock(Attributes) Lock은 SSH 세션에 대한 역할의 잠금 동작을 구성합니다. 비어 있으면 defaults 블록의 값(또는 전역 기본값)이 적용됩니다. (아래 중첩 스키마 참조)logins(List of String) Logins는 이 역할이 일치하는 노드에서 허용하는 OS 로그인의 목록입니다.max_sessions(Number) MaxSessions는 연결당 최대 동시 세션 수를 정의합니다.permit_x11_forwarding(Boolean) PermitX11Forwarding이 true이면 SSH 세션에서 X11 포워딩 사용을 허용합니다. 설정하지 않으면 X11 포워딩이 허용되지 않습니다.port_forwarding(Attributes) SSHPortForwarding은 역할이 허용하는 SSH 포트 포워딩 유형을 구성합니다. (아래 중첩 스키마 참조)session_recording(Attributes) 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(List of String) Groups는 사용자를 추가할 호스트 그룹의 목록입니다.mode(String) Mode는 호스트 사용자를 생성하는 방식을 지정합니다.shell(String) Shell은 사용자에게 설정할 셸입니다.
spec.ssh.labels에 대한 중첩 스키마#
선택적:
name(String) 레이블의 이름입니다.values(List of String) 레이블과 연결된 값입니다.
spec.ssh.lock에 대한 중첩 스키마#
선택적:
mode(String) 허용되는 값은 strict 또는 best_effort입니다. 설정하지 않으면 클러스터 전체 인증 기본 설정의 값이 기본값입니다.
spec.ssh.port_forwarding에 대한 중첩 스키마#
선택적:
local(Attributes) 로컬 포트 포워딩을 허용합니다. (아래 중첩 스키마 참조)remote(Attributes) 원격 포트 포워딩을 허용합니다. (아래 중첩 스키마 참조)
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(Attributes List) Labels는 이 역할이 발급을 허용하는 WorkloadIdentity 리소스를 동적으로 선택하는 데 사용되는 WorkloadIdentity 레이블 집합입니다. 발급을 하려면 호출자가 해당 스코프에서 workload_identity 종류에 대한 read_no_secrets 규칙(다중 발급 RPC의 경우 list 규칙도)을 보유해야 합니다. (아래 중첩 스키마 참조)
spec.workload_identity.labels에 대한 중첩 스키마#
선택적:
name(String) 레이블의 이름입니다.values(List of String) 레이블과 연결된 값입니다.