Infograb logo
TeleportRoleV6

이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportRoleV6 리소스의 필드에 대한 포괄적인 참고 자료입니다.

resources.teleport.dev/v1

apiVersion: resources.teleport.dev/v1

필드유형설명
apiVersionstringAPIVersion은 객체의 이 표현의 버전화된 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환하고, 인식되지 않은 값을 거부할 수 있습니다. 더 많은 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kindstringKind는 이 객체가 나타내는 REST 리소스를 나타내는 문자열 값입니다. 서버는 클라이언트가 요청을 제출하는 엔드포인트에서 이를 추론할 수 있습니다. 업데이트할 수 없습니다. CamelCase로 작성합니다. 더 많은 정보: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadataobject
specobjectTeleport의 Role 리소스 정의 v6

spec

필드유형설명
allowobjectAllow는 액세스를 부여하기 위해 평가되는 조건의 집합입니다.
denyobjectDeny는 액세스를 거부하기 위해 평가되는 조건의 집합입니다. Deny는 Allow보다 우선합니다.
optionsobjectOptions는 에이전트 전달과 같은 OpenSSH 옵션에 사용됩니다.

spec.allow

필드유형설명
account_assignments[]objectAccountAssignments는 이 조건의 영향을 받는 계정 할당 목록을 포함합니다.
app_labelsobjectAppLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다.
app_labels_expressionstringAppLabelsExpression은 앱에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
aws_role_arns[]stringAWSRoleARNs는 이 역할이 맡을 수 있는 AWS 역할 ARN 목록입니다.
azure_identities[]stringAzureIdentities는 이 역할이 맡을 수 있는 Azure 아이덴티티 목록입니다.
cluster_labelsobjectClusterLabels는 클러스터에 대한 동적 액세스를 허용하는 데 사용되는 노드 레이블의 맵입니다.
cluster_labels_expressionstringClusterLabelsExpression은 원격 Teleport 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
db_labelsobjectDatabaseLabels는 데이터베이스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
db_labels_expressionstringDatabaseLabelsExpression은 데이터베이스에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
db_names[]stringDatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다.
db_permissions[]objectDatabasePermissions는 자동 데이터베이스 사용자 프로비저닝 시 데이터베이스 사용자에게 부여될 일련의 권한을 지정합니다.
db_roles[]stringDatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다.
db_service_labelsobjectDatabaseServiceLabels는 데이터베이스 서비스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
db_service_labels_expressionstringDatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
db_users[]stringDatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다.
desktop_groups[]stringDesktopGroups는 생성된 데스크탑 사용자가 추가될 그룹 목록입니다.
gcp_service_accounts[]stringGCPServiceAccounts는 이 역할이 맡을 수 있는 GCP 서비스 계정 목록입니다.
group_labelsobjectGroupLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다.
group_labels_expressionstringGroupLabelsExpression은 사용자 그룹에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
host_groups[]stringHostGroups는 생성된 사용자가 추가될 그룹 목록입니다.
host_sudoers[]stringHostSudoers는 사용자 sudoer 파일에 포함될 항목 목록입니다.
impersonateobjectImpersonate는 이 역할이 인증서 발급이나 기타 가능한 수단을 사용하여 가장할 수 있는 사용자와 역할을 지정합니다.
join_sessions[]objectJoinSessions는 사용자가 다른 세션에 참여할 수 있도록 허용하는 정책을 지정합니다.
kubernetes_groups[]stringKubeGroups는 Kubernetes 그룹 목록입니다.
kubernetes_labelsobjectKubernetesLabels는 RBAC에 사용되는 Kubernetes 클러스터 레이블의 맵입니다.
kubernetes_labels_expressionstringKubernetesLabelsExpression은 Kubernetes 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
kubernetes_resources[]objectKubernetesResources는 이 역할이 액세스를 부여하는 Kubernetes 리소스입니다.
kubernetes_users[]stringKubeUsers는 가장할 수 있는 선택적 Kubernetes 사용자입니다.
logins[]stringLogins는 *nix 시스템 로그인 목록입니다.
node_labelsobjectNodeLabels는 노드에 대한 동적 액세스를 허용하는 데 사용되는 노드 레이블의 맵입니다.
node_labels_expressionstringNodeLabelsExpression은 SSH 노드에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
requestobject
require_session_join[]objectRequireSessionJoin은 세션을 시작하기 위해 필요한 사용자에 대한 정책을 지정합니다.
review_requestsobjectReviewRequests는 액세스 리뷰를 제출하기 위한 조건을 정의합니다.
rules[]objectRules는 규칙과 그 액세스 수준의 목록입니다. Rules는 액세스 제어를 위한 고수준 구성 요소입니다.
spiffe[]objectSPIFFE는 역할 보유자가 SPIFFE SVID 생성을 허용하거나 거부하는 데 사용됩니다.
windows_desktop_labelsobjectWindowsDesktopLabels는 Windows 데스크탑에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
windows_desktop_labels_expressionstringWindowsDesktopLabelsExpression은 Windows 데스크탑에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다.
windows_desktop_logins[]stringWindowsDesktopLogins는 Windows 데스크탑에 허용/거부되는 데스크탑 로그인 이름 목록입니다.

spec.allow.account_assignments 항목

필드유형설명
accountstring
permission_setstring

spec.allow.db_permissions 항목

필드유형설명
matchobjectMatch는 허가가 부여되기 위해 일치해야 하는 객체 레이블 목록입니다.
permissions[]stringPermission은 부여될 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ...

spec.allow.impersonate

필드유형설명
roles[]stringRoles는 이 역할이 허용하는 리소스 목록입니다.
users[]stringUsers는 이 역할이 허용하는 리소스 목록으로, 빈 목록이거나 와일드카드 패턴일 수 있습니다.
wherestringWhere는 선택적 고급 매처를 지정합니다.

spec.allow.join_sessions 항목

필드유형설명
kinds[]stringKinds는 이 정책이 적용되는 세션 종류입니다.
modes[]stringModes는 이 정책을 위한 허용된 참가자 모드 목록입니다.
namestringName은 정책의 이름입니다.
roles[]stringRoles는 사용자가 세션에 조인할 수 있는 역할 목록입니다.

spec.allow.kubernetes_resources 항목

필드유형설명
kindstringKind는 Kubernetes 리소스 유형을 지정합니다.
namestringName은 리소스 이름입니다. 와일드카드를 지원합니다.
namespacestringNamespace는 리소스 네임스페이스를 나타냅니다. 와일드카드를 지원합니다.
verbs[]stringVerbs는 다음 리소스에 허용된 Kubernetes 동사입니다.

spec.allow.request

필드유형설명
annotationsobjectAnnotations는 pending Access Requests 생성 시 프로그래밍 방식으로 추가될 주석의 모음입니다. 이 주석은 플러그인에 추가 정보를 전파하는 메커니즘 역할을 합니다. 이러한 주석은 변수 치환 구문을 지원하므로 외부 ID 공급자로부터 플러그인으로 {{external.trait_name}} 스타일 치환을 통해 클레임을 전달하는 메커니즘도 제공합니다.
claims_to_roles[]objectClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다.
kubernetes_resources[]objectkubernetes_resources는 선택적으로 요청자가 특정 종류의 kube 리소스만 요청하도록 강제할 수 있습니다. 예: 사용자는 "kube_cluster" 리소스 종류나 "namespaces"와 같은 하위 리소스에 대해서만 요청할 수 있습니다. 이 필드는 사용자가 "kube_cluster"를 요청하지 않도록 방지하고 해당 하위 리소스 요청을 강제하는 방식으로 정의될 수 있습니다.
max_durationstringMaxDuration은 접근이 허용될 시간의 양입니다. 이 값이 0이면 기본 지속 시간이 사용됩니다.
roles[]stringRoles는 요청 규칙에 일치할 역할의 이름입니다.
search_as_roles[]stringSearchAsRoles는 사용자가 리소스 접근 요청의 일환으로 리소스를 검색할 때 적용해야 하는 추가 역할 목록을 정의하며, 모든 리소스 접근 요청의 일환으로 요청될 기본 역할을 정의합니다.
suggested_reviewers[]stringSuggestedReviewers는 검토자 제안 목록입니다. 이들은 텔레포트 사용자 이름일 수 있지만 필수는 아닙니다.
thresholds[]objectThresholds는 검토가 상태 전환을 촉발하기 위해 충족해야 하는 임계값 목록입니다. 임계값이 제공되지 않으면 기본적으로 승인 및 거부를 위한 1의 임계값이 사용됩니다.

spec.allow.request.claims_to_roles 항목

FieldTypeDescription
claimstringClaim은 클레임 이름입니다.
roles[]stringRoles는 일치하는 정적 텔레포트 역할의 목록입니다.
valuestringValue는 일치하는 클레임 값입니다.

spec.allow.request.kubernetes_resources 항목

FieldTypeDescription
kindstringkind는 Kubernetes 리소스 유형을 지정합니다.

spec.allow.request.thresholds 항목

FieldTypeDescription
approveintegerApprove는 상태 전환을 위해 필요한 일치 승인 수입니다.
denyintegerDeny는 상태 전환을 위해 필요한 거부 수입니다.
filterstringFilter는 이 임계값에 계산되는 리뷰를 결정하는 데 사용되는 선택적 조건입니다.
namestringName은 임계값의 선택적 사용자 친화적 이름입니다.

spec.allow.require_session_join 항목

FieldTypeDescription
countintegerCount는 이 정책을 충족하기 위해 필요한 일치하는 사람의 수입니다.
filterstringFilter는 이 정책에 카운트되는 사용자를 결정하는 조건입니다.
kinds[]stringKinds는 이 정책이 적용되는 세션 종류입니다.
modes[]stringModes는 이 정책을 충족하는 데 사용될 수 있는 모드 목록입니다.
namestringName은 정책의 이름입니다.
on_leavestringOnLeave는 라이브 세션에 대해 정책이 더 이상 충족되지 않을 때 사용하는 동작입니다.

spec.allow.review_requests

FieldTypeDescription
claims_to_roles[]objectClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다.
preview_as_roles[]stringPreviewAsRoles는 리소스 접근 요청을 검토하는 동안 검토자에게 적용되어야 하는 추가 역할 목록입니다. 이 목록은 요청된 리소스의 호스트 이름 및 레이블과 같은 세부정보를 보기 위한 것입니다.
roles[]stringRoles는 검토할 수 있는 역할의 이름입니다.
wherestringWhere는 어떤 요청이 검토 가능한지를 한정하는 선택적 조건입니다.

spec.allow.review_requests.claims_to_roles 항목

FieldTypeDescription
claimstringClaim은 클레임 이름입니다.
roles[]stringRoles는 일치하는 정적 텔레포트 역할의 목록입니다.
valuestringValue는 일치하는 클레임 값입니다.

spec.allow.rules 항목

FieldTypeDescription
actions[]stringActions는 이 규칙이 일치할 때 수행되는 선택적 작업을 지정합니다.
resources[]stringResources는 리소스 목록입니다.
verbs[]stringVerbs는 동사의 목록입니다.
wherestringWhere는 선택적 고급 일치기를 지정합니다.

spec.allow.spiffe 항목

FieldTypeDescription
dns_sans[]stringDNSSANs는 SPIFFE ID DNS SANs에 대한 매처를 지정합니다. 각 요청된 DNS SAN은 구성된 모든 매처와 비교되고, 매칭되는 것이 있으면 조건이 충족된 것으로 간주됩니다. 기본적으로 매처는 '_'를 사용하여 0개 이상의 모든 문자를 나타내는 것을 허용합니다. '^'를 앞에 추가하고 '$'를 뒤에 추가하여 Go 정규 표현식 구문을 사용하여 일치하도록 변경할 수 있습니다. 예: _.example.com은 foo.example.com과 일치합니다.
ip_sans[]stringIPSANs는 SPIFFE ID IP SANs에 대한 매처를 지정합니다. 각 요청된 IP SAN은 구성된 모든 매처와 비교되고, 매칭되는 것이 있으면 조건이 충족된 것으로 간주됩니다. 매처는 CIDR 표기를 사용하여 지정해야 하며, IPv4 및 IPv6를 지원합니다. 예: - 10.0.0.0/24는 10.0.0.0에서 10.255.255.255까지의 범위와 일치합니다. - 10.0.0.42/32는 10.0.0.42와만 일치합니다.
pathstringPath는 SPIFFE ID 경로에 대한 매처를 지정합니다. 이는 신뢰 도메인이 포함되지 않아야 하며 선행 슬래시로 시작해야 합니다. 기본적으로 매처는 ''를 사용하여 0개 이상의 모든 문자를 나타내는 것을 허용합니다. '^'를 앞에 추가하고 '$'를 뒤에 추가하여 Go 정규 표현식 구문을 사용하여 일치하도록 변경할 수 있습니다. 예: - /svc/foo//bar는 /svc/foo/baz/bar와 일치합니다. - ^/svc/foo/.*/bar$는 /svc/foo/baz/bar와 일치합니다.

spec.deny

FieldTypeDescription
account_assignments[]objectAccountAssignments는 이 조건에 따라 영향을 받는 계정 할당 목록을 보유합니다.
app_labelsobjectAppLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다.
app_labels_expressionstringAppLabelsExpression은 앱에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
aws_role_arns[]stringAWSRoleARNs는 이 역할이 가정할 수 있는 AWS 역할 ARN 목록입니다.
azure_identities[]stringAzureIdentities는 이 역할이 가정할 수 있는 Azure 아이덴티티 목록입니다.
cluster_labelsobjectClusterLabels는 클러스터에 대한 접근을 동적으로 부여하는 데 사용되는 노드 레이블의 맵입니다.
cluster_labels_expressionstringClusterLabelsExpression은 원격 Teleport 클러스터에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
db_labelsobjectDatabaseLabels는 RBAC 시스템에서 데이터베이스 접근을 허용/거부하는 데 사용됩니다.
db_labels_expressionstringDatabaseLabelsExpression은 데이터베이스에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
db_names[]stringDatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다.
db_permissions[]objectDatabasePermissions는 자동 데이터베이스 사용자 프로비저닝을 사용할 때 데이터베이스 사용자에게 부여될 권한 집합을 지정합니다.
db_roles[]stringDatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다.
db_service_labelsobjectDatabaseServiceLabels는 RBAC 시스템에서 데이터베이스 서비스에 대한 접근을 허용/거부하는 데 사용됩니다.
db_service_labels_expressionstringDatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
db_users[]stringDatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다.
desktop_groups[]stringDesktopGroups는 생성된 데스크톱 사용자를 추가할 그룹 목록입니다.
gcp_service_accounts[]stringGCPServiceAccounts는 이 역할이 가정할 수 있는 GCP 서비스 계정 목록입니다.
group_labelsobjectGroupLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다.
group_labels_expressionstringGroupLabelsExpression은 사용자 그룹에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
host_groups[]stringHostGroups는 생성된 사용자에게 추가될 그룹 목록입니다.
host_sudoers[]stringHostSudoers는 사용자 sudoer 파일에 포함될 항목 목록입니다.
impersonateobjectImpersonate는 이 역할이 인증서를 발급하거나 다른 수단을 통해 대신할 수 있는 사용자 및 역할을 지정합니다.
join_sessions[]objectJoinSessions는 사용자가 다른 세션에 참여할 수 있도록 허용하는 정책을 지정합니다.
kubernetes_groups[]stringKubeGroups는 쿠버네티스 그룹 목록입니다.
kubernetes_labelsobjectKubernetesLabels는 RBAC에 사용되는 쿠버네티스 클러스터 레이블의 맵입니다.
kubernetes_labels_expressionstringKubernetesLabelsExpression은 쿠버네티스 클러스터 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
kubernetes_resources[]objectKubernetesResources는 이 역할이 접근을 부여하는 쿠버네티스 리소스입니다.
kubernetes_users[]stringKubeUsers는 대신할 수 있는 선택적 쿠버네티스 사용자입니다.
logins[]stringLogins는 *nix 시스템 로그인의 목록입니다.
node_labelsobjectNodeLabels는 노드 접근을 동적으로 부여하는 데 사용되는 노드 레이블의 맵입니다.
node_labels_expressionstringNodeLabelsExpression은 SSH 노드 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
requestobject
require_session_join[]objectRequireSessionJoin은 세션 시작을 위해 요구되는 사용자에 대한 정책을 지정합니다.
review_requestsobjectReviewRequests는 접근 검토 제출 조건을 정의합니다.
rules[]objectRules는 규칙 및 그 접근 수준의 목록입니다. Rules는 접근 제어를 위한 고수준 구성 요소입니다.
spiffe[]objectSPIFFE는 역할 보유자가 SPIFFE SVID를 생성하는 접근을 허용 또는 거부하는 데 사용됩니다.
windows_desktop_labelsobjectWindowsDesktopLabels는 RBAC 시스템에서 Windows 데스크톱 접근을 허용/거부하는 데 사용됩니다.
windows_desktop_labels_expressionstringWindowsDesktopLabelsExpression은 Windows 데스크톱 접근을 허용/거부하는 데 사용되는 술어 표현입니다.
windows_desktop_logins[]stringWindowsDesktopLogins는 Windows 데스크톱에 허용/거부되는 데스크톱 로그인 이름 목록입니다.

spec.deny.account_assignments 항목

필드유형설명
accountstring
permission_setstring

spec.deny.db_permissions 항목

필드유형설명
matchobjectMatch는 권한이 부여되기 위해 일치해야 하는 객체 레이블 목록입니다.
permissions[]stringPermission은 주어질 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ...

spec.deny.impersonate

필드유형설명
roles[]stringRoles는 이 역할이 가장기적을 허용하는 리소스 목록입니다.
users[]stringUsers는 이 역할이 가장기적을 허용하는 리소스 목록으로, 빈 목록이나 와일드카드 패턴일 수 있습니다.
wherestringWhere는 선택적 고급 일치기를 지정합니다.

spec.deny.join_sessions 항목

필드유형설명
kinds[]stringKinds는 이 정책이 적용되는 세션 종류입니다.
modes[]stringModes는 이 정책에 대해 허용되는 참가자 모드의 목록입니다.
namestringName은 정책의 이름입니다.
roles[]stringRoles는 세션에 조인할 수 있는 역할 목록입니다.

spec.deny.kubernetes_resources 항목

필드유형설명
kindstringKind는 Kubernetes 리소스 유형을 지정합니다.
namestringName은 리소스의 이름입니다. 와일드카드를 지원합니다.
namespacestringNamespace는 리소스 네임스페이스입니다. 와일드카드를 지원합니다.
verbs[]stringVerbs는 다음 리소스에 대한 허용된 Kubernetes 동사입니다.

spec.deny.request

필드유형설명
annotationsobjectAnnotations는 생성 시 보류 중인 접근 요청에 프로그래밍 방식으로 추가될 주석 모음입니다. 이러한 주석은 플러그인에 추가 정보를 전파하는 메커니즘 역할을 합니다. 이러한 주석은 변수 대체 구문을 지원하므로 외부 ID 제공자로부터 플러그인으로 클레임을 전달하는 메커니즘을 제공합니다. {{external.trait_name}} 스타일 대체를 통해 가능합니다.
claims_to_roles[] objectClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다.
kubernetes_resources[] objectkubernetes_resources는 요청자가 특정 종류의 kube 리소스만 요청하도록 선택적으로 시행할 수 있습니다. 예: 사용자는 "kube_cluster" 리소스 종류 또는 하위 리소스("namespaces" 등) 중 하나에 요청할 수 있습니다. 이 필드는 사용자가 "kube_cluster"를 요청하는 것을 방지하고 하위 리소스 요청을 시행하도록 정의할 수 있습니다.
max_durationstringMaxDuration은 접근이 허용되는 시간입니다. 이 값이 0이면 기본 기간이 사용됩니다.
roles[]stringRoles는 요청 규칙과 일치하는 역할의 이름입니다.
search_as_roles[]stringSearchAsRoles는 리소스 접근 요청의 일환으로 사용자가 리소스를 검색할 때 적용되어야 하는 추가 역할 목록입니다. 이 역할은 리소스 접근 요청의 일환으로 요청되는 기본 역할을 정의합니다.
suggested_reviewers[]stringSuggestedReviewers는 리뷰어 제안 목록입니다. 이들은 텔레포트 사용자 이름이 될 수 있지만 필수는 아닙니다.
thresholds[] objectThresholds는 리뷰가 상태 전이를 트리거하기 위해 충족해야 하는 임계값 목록입니다. 임계값이 제공되지 않으면 승인과 거부에 대해 기본 임계값 1이 사용됩니다.

spec.deny.request.claims_to_roles 항목

필드타입설명
claimstringClaim은 클레임 이름입니다.
roles[]stringRoles는 일치하는 정적 텔레포트 역할의 리스트입니다.
valuestringValue는 일치하는 클레임 값입니다.

spec.deny.request.kubernetes_resources 항목

필드타입설명
kindstringkind는 Kubernetes 리소스 유형을 지정합니다.

spec.deny.request.thresholds 항목

필드타입설명
approveintegerApprove는 상태 전환에 필요한 일치하는 승인 수입니다.
denyintegerDeny는 상태 전환에 필요한 거부 수입니다.
filterstringFilter는 이 임계값에 포함되는 리뷰를 결정하는 선택적 술어입니다.
namestringName은 임계값의 선택적 읽기 쉬운 이름입니다.

spec.deny.require_session_join 항목

필드타입설명
countintegerCount는 이 정책이 이행되기 위해 필요한 일치하는 사람의 수입니다.
filterstringFilter는 이 정책에 포함될 사용자를 결정하는 술어입니다.
kinds[]stringKinds는 이 정책이 적용되는 세션 종류입니다.
modes[]stringModes는 이 정책을 이행하는 데 사용될 수 있는 모드의 리스트입니다.
namestringName은 정책의 이름입니다.
on_leavestringOnLeave는 라이브 세션에 대해 정책이 더 이상 이행되지 않을 때 사용되는 동작입니다.

spec.deny.review_requests

필드타입설명
claims_to_roles[]objectClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다.
preview_as_roles[]stringPreviewAsRoles는 검토자가 요청된 리소스에 대한 세부 정보를 보기 위한 동안 적용되어야 하는 추가 역할의 리스트입니다.
roles[]stringRoles는 검토할 수 있는 역할의 이름입니다.
wherestringWhere는 리뷰할 수 있는 요청을 추가로 제한하는 선택적 술어입니다.

spec.deny.review_requests.claims_to_roles 항목

필드타입설명
claimstringClaim은 클레임 이름입니다.
roles[]stringRoles는 일치하는 정적 텔레포트 역할의 리스트입니다.
valuestringValue는 일치하는 클레임 값입니다.

spec.deny.rules 항목

필드타입설명
actions[]stringActions는 이 규칙이 일치할 때 수행되는 선택적 동작을 지정합니다.
resources[]stringResources는 리소스의 리스트입니다.
verbs[]stringVerbs는 동사의 리스트입니다.
wherestringWhere는 선택적 고급 매처를 지정합니다.

spec.deny.spiffe 항목

필드타입설명
dns_sans[]stringDNSSANs는 SPIFFE ID DNS SAN에 대한 매처를 지정합니다. 요청된 각 DNS SAN은 설정된 모든 매처와 비교되며, 일치하는 것이 있으면 조건이 충족된 것으로 간주됩니다. 매처는 기본적으로 '_'를 사용하여 0개 이상의 모든 문자를 나타낼 수 있습니다. '^'로 시작하고 '$'로 끝나면 Go 정규 표현식 문법을 사용하여 일치를 전환합니다. 예: _.example.com은 foo.example.com과 일치합니다.
ip_sans[]stringIPSANs는 SPIFFE ID IP SAN에 대한 매처를 지정합니다. 요청된 각 IP SAN은 설정된 모든 매처와 비교되며, 일치하는 것이 있으면 조건이 충족된 것으로 간주됩니다. 매처는 CIDR 표기법을 사용하여 지정해야 하며, IPv4 및 IPv6을 지원합니다. 예: - 10.0.0.0/24는 10.0.0.0부터 10.255.255.255까지 일치합니다. - 10.0.0.42/32는 10.0.0.42와만 일치합니다.
pathstringPath는 SPIFFE ID 경로에 대한 매처를 지정합니다. 신뢰 도메인을 포함하지 않아야 하며 선행 슬래시로 시작해야 합니다. 매처는 기본적으로 ''를 사용하여 0개 이상의 모든 문자를 나타낼 수 있습니다. '^'로 시작하고 '$'로 끝나면 Go 정규 표현식 문법을 사용하여 일치를 전환합니다. 예: - /svc/foo//bar는 /svc/foo/baz/bar와 일치합니다. - ^/svc/foo/.*/bar$는 /svc/foo/baz/bar와 일치합니다.

spec.options

| 필드 | 유형 | 설명 | | ------------------------------ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | -------------------------------------- | | cert_extensions | []object | CertExtensions 는 키/값을 지정합니다. | | cert_format | string | CertificateFormat 은 이전 버전의 OpenSSH와의 호환성을 허용하기 위해 사용자 인증서의 형식을 정의합니다. | | client_idle_timeout | string | ClientIdleTimeout 은 유휴 타임아웃 동작에 따라 클라이언트를 연결 해제하도록 설정합니다. 0으로 설정하면 해제하지 않으며, 그렇지 않으면 유휴 지속 시간으로 설정됩니다. | | create_db_user | boolean | CreateDatabaseUser 는 자동 데이터베이스 사용자 생성을 활성화합니다. | | create_db_user_mode | string or integer | CreateDatabaseUserMode는 꺼지지 않은 데이터베이스에서 사용자가 자동으로 생성될 수 있도록 허용합니다. 0은 "지정되지 않음", 1은 "꺼짐", 2는 "유지", 3은 "최선의 노력으로 삭제"입니다. 각각의 옵션은 문자열 또는 정수 표현으로 가능합니다. | | create_desktop_user | boolean | CreateDesktopUser 는 Windows 데스크탑에서 사용자가 자동으로 생성될 수 있도록 허용합니다. | | create_host_user | boolean | 사용 중단: 대신 CreateHostUserMode 를 사용하십시오. | | create_host_user_default_shell | string | CreateHostUserDefaultShell 은 새로 프로비저닝된 호스트 사용자에 대한 기본 셸을 구성하는 데 사용됩니다. | | create_host_user_mode | string or integer | CreateHostUserMode 는 꺼지지 않은 호스트에서 사용자가 자동으로 생성될 수 있도록 허용합니다. 0은 "지정되지 않음"; 1은 "꺼짐"; 2는 "삭제" (v15 이상에서 제거됨), 3은 "유지"; 4는 "불안전하게 삭제"입니다. 각각의 옵션은 문자열 또는 정수 표현으로 가능합니다. | | desktop_clipboard | boolean | DesktopClipboard 는 사용자 작업 공간과 원격 데스크탑 간의 클립보드 공유가 허용되는지를 나타냅니다. 명시적으로 false로 설정되지 않는 한 기본값은 true입니다. | | desktop_directory_sharing | boolean | DesktopDirectorySharing 은 사용자 작업 공간과 원격 데스크탑 간의 디렉터리 공유가 허용되는지를 나타냅니다. 명시적으로 true로 설정되지 않는 한 기본값은 false입니다. | | device_trust_mode | string | DeviceTrustMode 는 역할과 관련된 리소스에 사용되는 장치 승인 모드입니다. DeviceTrust.Mode 를 참조하십시오. | | disconnect_expired_cert | boolean | DisconnectExpiredCert 는 만료된 인증서에 대한 클라이언트 연결 해제를 설정합니다. | | enhanced_recording | []string | BPF 는 BPF 기반 세션 레코더에 대해 기록할 이벤트를 정의합니다. | | forward_agent | boolean | ForwardAgent 는 SSH 에이전트 포워딩입니다. | | idp | object | IDP 는 Teleport 내에서 IdP에 접근하는 것과 관련된 옵션을 집합입니다. Teleport Enterprise 가 필요합니다. | | lock | string | Lock은 역할에 적용될 잠금 모드(secure | best_effort)를 지정합니다. | | max_connections | integer | MaxConnections 는 사용자가 가질 수 있는 최대 동시 연결 수를 정의합니다. | | max_kubernetes_connections | integer | MaxKubernetesConnections 는 사용자가 가질 수 있는 최대 동시 Kubernetes 세션 수를 정의합니다. | | max_session_ttl | string | MaxSessionTTL 은 SSH 세션이 지속될 수 있는 시간의 한계를 정의합니다. | | max_sessions | integer | MaxSessions 는 연결당 최대 동시 세션 수를 정의합니다. | | mfa_verification_interval | string | MFAVerificationInterval 은 선택적으로 연속적인 MFA 검증 간 경과할 수 있는 최대 기간을 정의합니다. 이 변수는 사용자가 주기적으로 자신의 신원을 확인하도록 요구하여, tsh proxy * 파생물 사용 시 재인증 없이 장기간 세션이 지속되는 것을 방지합니다. MFA가 필요한 세션에서만 효과적입니다. 설정되지 않으면 기본값은 max_session_ttl 입니다. | | permit_x11_forwarding | boolean | PermitX11Forwarding 은 X11 포워딩 사용을 허용합니다. | | pin_source_ip | boolean | PinSourceIP 는 인증서 생성 및 사용을 위한 동일한 클라이언트 IP를 강제합니다. | | port_forwarding | boolean | PortForwarding 은 인증서에 "permit-port-forwarding"이 포함되어 있는지를 정의합니다. 설정되지 않으면 PortForwarding은 "yes"입니다. 그래서 이는 포인터입니다. | | record_session | object | RecordDesktopSession 은 데스크탑 접근 세션을 기록할지를 나타냅니다. 명시적으로 false로 설정되지 않는 한 기본값은 true입니다. | | request_access | string | RequestAccess 는 요청 전략(옵션 | 알림 | 항상)을 정의하며, 기본값은 옵션입니다. | | request_prompt | string | RequestPrompt 는 사용자가 요청해야 할 내용을 알려주는 선택적 메시지입니다. | | require_session_mfa | string or integer | RequireMFAType 는 이 사용자에게 부여된 MFA 요구 사항의 유형입니다. 0은 "꺼짐", 1은 "세션", 2는 "세션 및 하드웨어 키", 3은 "하드웨어 키 터치", 4는 "하드웨어 키 핀", 5는 "하드웨어 키 터치 및 핀"입니다. 각각의 옵션은 문자열 또는 정수 표현으로 가능합니다. | | ssh_file_copy | boolean | SSHFileCopy 는 SSH 세션을 통해 SCP 또는 SFTP를 통한 원격 파일 작업이 허용되는지를 나타냅니다. 명시적으로 false로 설정되지 않는 한 기본값은 true입니다. |

spec.options.cert_extensions 항목

필드유형설명
modestring 또는 integerMode는 사용될 확장의 유형으로, 현재 critical-option은 지원되지 않습니다. 0은 "extension"입니다. 각 옵션의 문자열 또는 정수 표현일 수 있습니다.
namestringName은 cert 확장에서 사용될 키를 지정합니다.
typestring 또는 integerType은 확장되는 인증서 유형을 나타내며 현재 ssh만 지원됩니다. 0은 "ssh"입니다. 각 옵션의 문자열 또는 정수 표현일 수 있습니다.
valuestringValue는 cert 확장에서 사용될 값을 지정합니다.

spec.options.idp

필드유형설명
samlobjectSAML은 Teleport SAML IdP와 관련된 옵션입니다.

spec.options.idp.saml

필드유형설명
enabledbooleanEnabled는 이 옵션이 Teleport SAML IdP에 대한 액세스를 허용하면 true로 설정됩니다.

spec.options.record_session

필드유형설명
defaultstringDefault는 서비스에 대한 기본 값을 나타냅니다.
desktopbooleanDesktop은 데스크톱 세션이 기록되어야 하는지 여부를 나타냅니다. 명시적으로 false로 설정되지 않는 한 기본값은 true입니다.
sshstringSSH는 SSH 세션에서 사용되는 세션 모드를 나타냅니다.
Teleport 원문 보기