인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!
TeleportRoleV6
이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportRoleV6
리소스의 필드에 대한 포괄적인 참고 자료입니다.
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 | |
spec | object | Teleport의 Role 리소스 정의 v6 |
spec
필드 | 유형 | 설명 |
---|---|---|
allow | object | Allow는 액세스를 부여하기 위해 평가되는 조건의 집합입니다. |
deny | object | Deny는 액세스를 거부하기 위해 평가되는 조건의 집합입니다. Deny는 Allow보다 우선합니다. |
options | object | Options는 에이전트 전달과 같은 OpenSSH 옵션에 사용됩니다. |
spec.allow
필드 | 유형 | 설명 |
---|---|---|
account_assignments | []object | AccountAssignments는 이 조건의 영향을 받는 계정 할당 목록을 포함합니다. |
app_labels | object | AppLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다. |
app_labels_expression | string | AppLabelsExpression은 앱에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
aws_role_arns | []string | AWSRoleARNs는 이 역할이 맡을 수 있는 AWS 역할 ARN 목록입니다. |
azure_identities | []string | AzureIdentities는 이 역할이 맡을 수 있는 Azure 아이덴티티 목록입니다. |
cluster_labels | object | ClusterLabels는 클러스터에 대한 동적 액세스를 허용하는 데 사용되는 노드 레이블의 맵입니다. |
cluster_labels_expression | string | ClusterLabelsExpression은 원격 Teleport 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
db_labels | object | DatabaseLabels는 데이터베이스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다. |
db_labels_expression | string | DatabaseLabelsExpression은 데이터베이스에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
db_names | []string | DatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다. |
db_permissions | []object | DatabasePermissions는 자동 데이터베이스 사용자 프로비저닝 시 데이터베이스 사용자에게 부여될 일련의 권한을 지정합니다. |
db_roles | []string | DatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다. |
db_service_labels | object | DatabaseServiceLabels는 데이터베이스 서비스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다. |
db_service_labels_expression | string | DatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
db_users | []string | DatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다. |
desktop_groups | []string | DesktopGroups는 생성된 데스크탑 사용자가 추가될 그룹 목록입니다. |
gcp_service_accounts | []string | GCPServiceAccounts는 이 역할이 맡을 수 있는 GCP 서비스 계정 목록입니다. |
group_labels | object | GroupLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다. |
group_labels_expression | string | GroupLabelsExpression은 사용자 그룹에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
host_groups | []string | HostGroups는 생성된 사용자가 추가될 그룹 목록입니다. |
host_sudoers | []string | HostSudoers는 사용자 sudoer 파일에 포함될 항목 목록입니다. |
impersonate | object | Impersonate는 이 역할이 인증서 발급이나 기타 가능한 수단을 사용하여 가장할 수 있는 사용자와 역할을 지정합니다. |
join_sessions | []object | JoinSessions는 사용자가 다른 세션에 참여할 수 있도록 허용하는 정책을 지정합니다. |
kubernetes_groups | []string | KubeGroups는 Kubernetes 그룹 목록입니다. |
kubernetes_labels | object | KubernetesLabels는 RBAC에 사용되는 Kubernetes 클러스터 레이블의 맵입니다. |
kubernetes_labels_expression | string | KubernetesLabelsExpression은 Kubernetes 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
kubernetes_resources | []object | KubernetesResources는 이 역할이 액세스를 부여하는 Kubernetes 리소스입니다. |
kubernetes_users | []string | KubeUsers는 가장할 수 있는 선택적 Kubernetes 사용자입니다. |
logins | []string | Logins는 *nix 시스템 로그인 목록입니다. |
node_labels | object | NodeLabels는 노드에 대한 동적 액세스를 허용하는 데 사용되는 노드 레이블의 맵입니다. |
node_labels_expression | string | NodeLabelsExpression은 SSH 노드에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
request | object | |
require_session_join | []object | RequireSessionJoin은 세션을 시작하기 위해 필요한 사용자에 대한 정책을 지정합니다. |
review_requests | object | ReviewRequests는 액세스 리뷰를 제출하기 위한 조건을 정의합니다. |
rules | []object | Rules는 규칙과 그 액세스 수준의 목록입니다. Rules는 액세스 제어를 위한 고수준 구성 요소입니다. |
spiffe | []object | SPIFFE는 역할 보유자가 SPIFFE SVID 생성을 허용하거나 거부하는 데 사용됩니다. |
windows_desktop_labels | object | WindowsDesktopLabels는 Windows 데스크탑에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다. |
windows_desktop_labels_expression | string | WindowsDesktopLabelsExpression은 Windows 데스크탑에 대한 액세스를 허용/거부하는 데 사용되는 술어 표현입니다. |
windows_desktop_logins | []string | WindowsDesktopLogins는 Windows 데스크탑에 허용/거부되는 데스크탑 로그인 이름 목록입니다. |
spec.allow.account_assignments 항목
필드 | 유형 | 설명 |
---|---|---|
account | string | |
permission_set | string |
spec.allow.db_permissions 항목
필드 | 유형 | 설명 |
---|---|---|
match | object | Match는 허가가 부여되기 위해 일치해야 하는 객체 레이블 목록입니다. |
permissions | []string | Permission은 부여될 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ... |
spec.allow.impersonate
필드 | 유형 | 설명 |
---|---|---|
roles | []string | Roles는 이 역할이 허용하는 리소스 목록입니다. |
users | []string | Users는 이 역할이 허용하는 리소스 목록으로, 빈 목록이거나 와일드카드 패턴일 수 있습니다. |
where | string | Where는 선택적 고급 매처를 지정합니다. |
spec.allow.join_sessions 항목
필드 | 유형 | 설명 |
---|---|---|
kinds | []string | Kinds는 이 정책이 적용되는 세션 종류입니다. |
modes | []string | Modes는 이 정책을 위한 허용된 참가자 모드 목록입니다. |
name | string | Name은 정책의 이름입니다. |
roles | []string | Roles는 사용자가 세션에 조인할 수 있는 역할 목록입니다. |
spec.allow.kubernetes_resources 항목
필드 | 유형 | 설명 |
---|---|---|
kind | string | Kind는 Kubernetes 리소스 유형을 지정합니다. |
name | string | Name은 리소스 이름입니다. 와일드카드를 지원합니다. |
namespace | string | Namespace는 리소스 네임스페이스를 나타냅니다. 와일드카드를 지원합니다. |
verbs | []string | Verbs는 다음 리소스에 허용된 Kubernetes 동사입니다. |
spec.allow.request
필드 | 유형 | 설명 |
---|---|---|
annotations | object | Annotations는 pending Access Requests 생성 시 프로그래밍 방식으로 추가될 주석의 모음입니다. 이 주석은 플러그인에 추가 정보를 전파하는 메커니즘 역할을 합니다. 이러한 주석은 변수 치환 구문을 지원하므로 외부 ID 공급자로부터 플러그인으로 {{external.trait_name}} 스타일 치환을 통해 클레임을 전달하는 메커니즘도 제공합니다. |
claims_to_roles | []object | ClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다. |
kubernetes_resources | []object | kubernetes_resources는 선택적으로 요청자가 특정 종류의 kube 리소스만 요청하도록 강제할 수 있습니다. 예: 사용자는 "kube_cluster" 리소스 종류나 "namespaces"와 같은 하위 리소스에 대해서만 요청할 수 있습니다. 이 필드는 사용자가 "kube_cluster"를 요청하지 않도록 방지하고 해당 하위 리소스 요청을 강제하는 방식으로 정의될 수 있습니다. |
max_duration | string | MaxDuration은 접근이 허용될 시간의 양입니다. 이 값이 0이면 기본 지속 시간이 사용됩니다. |
roles | []string | Roles는 요청 규칙에 일치할 역할의 이름입니다. |
search_as_roles | []string | SearchAsRoles는 사용자가 리소스 접근 요청의 일환으로 리소스를 검색할 때 적용해야 하는 추가 역할 목록을 정의하며, 모든 리소스 접근 요청의 일환으로 요청될 기본 역할을 정의합니다. |
suggested_reviewers | []string | SuggestedReviewers는 검토자 제안 목록입니다. 이들은 텔레포트 사용자 이름일 수 있지만 필수는 아닙니다. |
thresholds | []object | Thresholds는 검토가 상태 전환을 촉발하기 위해 충족해야 하는 임계값 목록입니다. 임계값이 제공되지 않으면 기본적으로 승인 및 거부를 위한 1의 임계값이 사용됩니다. |
spec.allow.request.claims_to_roles 항목
Field | Type | Description |
---|---|---|
claim | string | Claim은 클레임 이름입니다. |
roles | []string | Roles는 일치하는 정적 텔레포트 역할의 목록입니다. |
value | string | Value는 일치하는 클레임 값입니다. |
spec.allow.request.kubernetes_resources 항목
Field | Type | Description |
---|---|---|
kind | string | kind는 Kubernetes 리소스 유형을 지정합니다. |
spec.allow.request.thresholds 항목
Field | Type | Description |
---|---|---|
approve | integer | Approve는 상태 전환을 위해 필요한 일치 승인 수입니다. |
deny | integer | Deny는 상태 전환을 위해 필요한 거부 수입니다. |
filter | string | Filter는 이 임계값에 계산되는 리뷰를 결정하는 데 사용되는 선택적 조건입니다. |
name | string | Name은 임계값의 선택적 사용자 친화적 이름입니다. |
spec.allow.require_session_join 항목
Field | Type | Description |
---|---|---|
count | integer | Count는 이 정책을 충족하기 위해 필요한 일치하는 사람의 수입니다. |
filter | string | Filter는 이 정책에 카운트되는 사용자를 결정하는 조건입니다. |
kinds | []string | Kinds는 이 정책이 적용되는 세션 종류입니다. |
modes | []string | Modes는 이 정책을 충족하는 데 사용될 수 있는 모드 목록입니다. |
name | string | Name은 정책의 이름입니다. |
on_leave | string | OnLeave는 라이브 세션에 대해 정책이 더 이상 충족되지 않을 때 사용하는 동작입니다. |
spec.allow.review_requests
Field | Type | Description |
---|---|---|
claims_to_roles | []object | ClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다. |
preview_as_roles | []string | PreviewAsRoles는 리소스 접근 요청을 검토하는 동안 검토자에게 적용되어야 하는 추가 역할 목록입니다. 이 목록은 요청된 리소스의 호스트 이름 및 레이블과 같은 세부정보를 보기 위한 것입니다. |
roles | []string | Roles는 검토할 수 있는 역할의 이름입니다. |
where | string | Where는 어떤 요청이 검토 가능한지를 한정하는 선택적 조건입니다. |
spec.allow.review_requests.claims_to_roles 항목
Field | Type | Description |
---|---|---|
claim | string | Claim은 클레임 이름입니다. |
roles | []string | Roles는 일치하는 정적 텔레포트 역할의 목록입니다. |
value | string | Value는 일치하는 클레임 값입니다. |
spec.allow.rules 항목
Field | Type | Description |
---|---|---|
actions | []string | Actions는 이 규칙이 일치할 때 수행되는 선택적 작업을 지정합니다. |
resources | []string | Resources는 리소스 목록입니다. |
verbs | []string | Verbs는 동사의 목록입니다. |
where | string | Where는 선택적 고급 일치기를 지정합니다. |
spec.allow.spiffe 항목
Field | Type | Description |
---|---|---|
dns_sans | []string | DNSSANs는 SPIFFE ID DNS SANs에 대한 매처를 지정합니다. 각 요청된 DNS SAN은 구성된 모든 매처와 비교되고, 매칭되는 것이 있으면 조건이 충족된 것으로 간주됩니다. 기본적으로 매처는 '_'를 사용하여 0개 이상의 모든 문자를 나타내는 것을 허용합니다. '^'를 앞에 추가하고 '$'를 뒤에 추가하여 Go 정규 표현식 구문을 사용하여 일치하도록 변경할 수 있습니다. 예: _.example.com은 foo.example.com과 일치합니다. |
ip_sans | []string | IPSANs는 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와만 일치합니다. |
path | string | Path는 SPIFFE ID 경로에 대한 매처를 지정합니다. 이는 신뢰 도메인이 포함되지 않아야 하며 선행 슬래시로 시작해야 합니다. 기본적으로 매처는 ''를 사용하여 0개 이상의 모든 문자를 나타내는 것을 허용합니다. '^'를 앞에 추가하고 '$'를 뒤에 추가하여 Go 정규 표현식 구문을 사용하여 일치하도록 변경할 수 있습니다. 예: - /svc/foo//bar는 /svc/foo/baz/bar와 일치합니다. - ^/svc/foo/.*/bar$는 /svc/foo/baz/bar와 일치합니다. |
spec.deny
Field | Type | Description |
---|---|---|
account_assignments | []object | AccountAssignments는 이 조건에 따라 영향을 받는 계정 할당 목록을 보유합니다. |
app_labels | object | AppLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다. |
app_labels_expression | string | AppLabelsExpression은 앱에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
aws_role_arns | []string | AWSRoleARNs는 이 역할이 가정할 수 있는 AWS 역할 ARN 목록입니다. |
azure_identities | []string | AzureIdentities는 이 역할이 가정할 수 있는 Azure 아이덴티티 목록입니다. |
cluster_labels | object | ClusterLabels는 클러스터에 대한 접근을 동적으로 부여하는 데 사용되는 노드 레이블의 맵입니다. |
cluster_labels_expression | string | ClusterLabelsExpression은 원격 Teleport 클러스터에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
db_labels | object | DatabaseLabels는 RBAC 시스템에서 데이터베이스 접근을 허용/거부하는 데 사용됩니다. |
db_labels_expression | string | DatabaseLabelsExpression은 데이터베이스에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
db_names | []string | DatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다. |
db_permissions | []object | DatabasePermissions는 자동 데이터베이스 사용자 프로비저닝을 사용할 때 데이터베이스 사용자에게 부여될 권한 집합을 지정합니다. |
db_roles | []string | DatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다. |
db_service_labels | object | DatabaseServiceLabels는 RBAC 시스템에서 데이터베이스 서비스에 대한 접근을 허용/거부하는 데 사용됩니다. |
db_service_labels_expression | string | DatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
db_users | []string | DatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다. |
desktop_groups | []string | DesktopGroups는 생성된 데스크톱 사용자를 추가할 그룹 목록입니다. |
gcp_service_accounts | []string | GCPServiceAccounts는 이 역할이 가정할 수 있는 GCP 서비스 계정 목록입니다. |
group_labels | object | GroupLabels는 RBAC 시스템의 일부로 사용되는 레이블의 맵입니다. |
group_labels_expression | string | GroupLabelsExpression은 사용자 그룹에 대한 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
host_groups | []string | HostGroups는 생성된 사용자에게 추가될 그룹 목록입니다. |
host_sudoers | []string | HostSudoers는 사용자 sudoer 파일에 포함될 항목 목록입니다. |
impersonate | object | Impersonate는 이 역할이 인증서를 발급하거나 다른 수단을 통해 대신할 수 있는 사용자 및 역할을 지정합니다. |
join_sessions | []object | JoinSessions는 사용자가 다른 세션에 참여할 수 있도록 허용하는 정책을 지정합니다. |
kubernetes_groups | []string | KubeGroups는 쿠버네티스 그룹 목록입니다. |
kubernetes_labels | object | KubernetesLabels는 RBAC에 사용되는 쿠버네티스 클러스터 레이블의 맵입니다. |
kubernetes_labels_expression | string | KubernetesLabelsExpression은 쿠버네티스 클러스터 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
kubernetes_resources | []object | KubernetesResources는 이 역할이 접근을 부여하는 쿠버네티스 리소스입니다. |
kubernetes_users | []string | KubeUsers는 대신할 수 있는 선택적 쿠버네티스 사용자입니다. |
logins | []string | Logins는 *nix 시스템 로그인의 목록입니다. |
node_labels | object | NodeLabels는 노드 접근을 동적으로 부여하는 데 사용되는 노드 레이블의 맵입니다. |
node_labels_expression | string | NodeLabelsExpression은 SSH 노드 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
request | object | |
require_session_join | []object | RequireSessionJoin은 세션 시작을 위해 요구되는 사용자에 대한 정책을 지정합니다. |
review_requests | object | ReviewRequests는 접근 검토 제출 조건을 정의합니다. |
rules | []object | Rules는 규칙 및 그 접근 수준의 목록입니다. Rules는 접근 제어를 위한 고수준 구성 요소입니다. |
spiffe | []object | SPIFFE는 역할 보유자가 SPIFFE SVID를 생성하는 접근을 허용 또는 거부하는 데 사용됩니다. |
windows_desktop_labels | object | WindowsDesktopLabels는 RBAC 시스템에서 Windows 데스크톱 접근을 허용/거부하는 데 사용됩니다. |
windows_desktop_labels_expression | string | WindowsDesktopLabelsExpression은 Windows 데스크톱 접근을 허용/거부하는 데 사용되는 술어 표현입니다. |
windows_desktop_logins | []string | WindowsDesktopLogins는 Windows 데스크톱에 허용/거부되는 데스크톱 로그인 이름 목록입니다. |
spec.deny.account_assignments 항목
필드 | 유형 | 설명 |
---|---|---|
account | string | |
permission_set | string |
spec.deny.db_permissions 항목
필드 | 유형 | 설명 |
---|---|---|
match | object | Match는 권한이 부여되기 위해 일치해야 하는 객체 레이블 목록입니다. |
permissions | []string | Permission은 주어질 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ... |
spec.deny.impersonate
필드 | 유형 | 설명 |
---|---|---|
roles | []string | Roles는 이 역할이 가장기적을 허용하는 리소스 목록입니다. |
users | []string | Users는 이 역할이 가장기적을 허용하는 리소스 목록으로, 빈 목록이나 와일드카드 패턴일 수 있습니다. |
where | string | Where는 선택적 고급 일치기를 지정합니다. |
spec.deny.join_sessions 항목
필드 | 유형 | 설명 |
---|---|---|
kinds | []string | Kinds는 이 정책이 적용되는 세션 종류입니다. |
modes | []string | Modes는 이 정책에 대해 허용되는 참가자 모드의 목록입니다. |
name | string | Name은 정책의 이름입니다. |
roles | []string | Roles는 세션에 조인할 수 있는 역할 목록입니다. |
spec.deny.kubernetes_resources 항목
필드 | 유형 | 설명 |
---|---|---|
kind | string | Kind는 Kubernetes 리소스 유형을 지정합니다. |
name | string | Name은 리소스의 이름입니다. 와일드카드를 지원합니다. |
namespace | string | Namespace는 리소스 네임스페이스입니다. 와일드카드를 지원합니다. |
verbs | []string | Verbs는 다음 리소스에 대한 허용된 Kubernetes 동사입니다. |
spec.deny.request
필드 | 유형 | 설명 |
---|---|---|
annotations | object | Annotations는 생성 시 보류 중인 접근 요청에 프로그래밍 방식으로 추가될 주석 모음입니다. 이러한 주석은 플러그인에 추가 정보를 전파하는 메커니즘 역할을 합니다. 이러한 주석은 변수 대체 구문을 지원하므로 외부 ID 제공자로부터 플러그인으로 클레임을 전달하는 메커니즘을 제공합니다. {{external.trait_name}} 스타일 대체를 통해 가능합니다. |
claims_to_roles | [] object | ClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다. |
kubernetes_resources | [] object | kubernetes_resources는 요청자가 특정 종류의 kube 리소스만 요청하도록 선택적으로 시행할 수 있습니다. 예: 사용자는 "kube_cluster" 리소스 종류 또는 하위 리소스("namespaces" 등) 중 하나에 요청할 수 있습니다. 이 필드는 사용자가 "kube_cluster"를 요청하는 것을 방지하고 하위 리소스 요청을 시행하도록 정의할 수 있습니다. |
max_duration | string | MaxDuration은 접근이 허용되는 시간입니다. 이 값이 0이면 기본 기간이 사용됩니다. |
roles | []string | Roles는 요청 규칙과 일치하는 역할의 이름입니다. |
search_as_roles | []string | SearchAsRoles는 리소스 접근 요청의 일환으로 사용자가 리소스를 검색할 때 적용되어야 하는 추가 역할 목록입니다. 이 역할은 리소스 접근 요청의 일환으로 요청되는 기본 역할을 정의합니다. |
suggested_reviewers | []string | SuggestedReviewers는 리뷰어 제안 목록입니다. 이들은 텔레포트 사용자 이름이 될 수 있지만 필수는 아닙니다. |
thresholds | [] object | Thresholds는 리뷰가 상태 전이를 트리거하기 위해 충족해야 하는 임계값 목록입니다. 임계값이 제공되지 않으면 승인과 거부에 대해 기본 임계값 1이 사용됩니다. |
spec.deny.request.claims_to_roles 항목
필드 | 타입 | 설명 |
---|---|---|
claim | string | Claim은 클레임 이름입니다. |
roles | []string | Roles는 일치하는 정적 텔레포트 역할의 리스트입니다. |
value | string | Value는 일치하는 클레임 값입니다. |
spec.deny.request.kubernetes_resources 항목
필드 | 타입 | 설명 |
---|---|---|
kind | string | kind는 Kubernetes 리소스 유형을 지정합니다. |
spec.deny.request.thresholds 항목
필드 | 타입 | 설명 |
---|---|---|
approve | integer | Approve는 상태 전환에 필요한 일치하는 승인 수입니다. |
deny | integer | Deny는 상태 전환에 필요한 거부 수입니다. |
filter | string | Filter는 이 임계값에 포함되는 리뷰를 결정하는 선택적 술어입니다. |
name | string | Name은 임계값의 선택적 읽기 쉬운 이름입니다. |
spec.deny.require_session_join 항목
필드 | 타입 | 설명 |
---|---|---|
count | integer | Count는 이 정책이 이행되기 위해 필요한 일치하는 사람의 수입니다. |
filter | string | Filter는 이 정책에 포함될 사용자를 결정하는 술어입니다. |
kinds | []string | Kinds는 이 정책이 적용되는 세션 종류입니다. |
modes | []string | Modes는 이 정책을 이행하는 데 사용될 수 있는 모드의 리스트입니다. |
name | string | Name은 정책의 이름입니다. |
on_leave | string | OnLeave는 라이브 세션에 대해 정책이 더 이상 이행되지 않을 때 사용되는 동작입니다. |
spec.deny.review_requests
필드 | 타입 | 설명 |
---|---|---|
claims_to_roles | []object | ClaimsToRoles는 클레임(특성)과 텔레포트 역할 간의 매핑을 지정합니다. |
preview_as_roles | []string | PreviewAsRoles는 검토자가 요청된 리소스에 대한 세부 정보를 보기 위한 동안 적용되어야 하는 추가 역할의 리스트입니다. |
roles | []string | Roles는 검토할 수 있는 역할의 이름입니다. |
where | string | Where는 리뷰할 수 있는 요청을 추가로 제한하는 선택적 술어입니다. |
spec.deny.review_requests.claims_to_roles 항목
필드 | 타입 | 설명 |
---|---|---|
claim | string | Claim은 클레임 이름입니다. |
roles | []string | Roles는 일치하는 정적 텔레포트 역할의 리스트입니다. |
value | string | Value는 일치하는 클레임 값입니다. |
spec.deny.rules 항목
필드 | 타입 | 설명 |
---|---|---|
actions | []string | Actions는 이 규칙이 일치할 때 수행되는 선택적 동작을 지정합니다. |
resources | []string | Resources는 리소스의 리스트입니다. |
verbs | []string | Verbs는 동사의 리스트입니다. |
where | string | Where는 선택적 고급 매처를 지정합니다. |
spec.deny.spiffe 항목
필드 | 타입 | 설명 |
---|---|---|
dns_sans | []string | DNSSANs는 SPIFFE ID DNS SAN에 대한 매처를 지정합니다. 요청된 각 DNS SAN은 설정된 모든 매처와 비교되며, 일치하는 것이 있으면 조건이 충족된 것으로 간주됩니다. 매처는 기본적으로 '_'를 사용하여 0개 이상의 모든 문자를 나타낼 수 있습니다. '^'로 시작하고 '$'로 끝나면 Go 정규 표현식 문법을 사용하여 일치를 전환합니다. 예: _.example.com은 foo.example.com과 일치합니다. |
ip_sans | []string | IPSANs는 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와만 일치합니다. |
path | string | Path는 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 항목
필드 | 유형 | 설명 |
---|---|---|
mode | string 또는 integer | Mode는 사용될 확장의 유형으로, 현재 critical-option은 지원되지 않습니다. 0은 "extension"입니다. 각 옵션의 문자열 또는 정수 표현일 수 있습니다. |
name | string | Name은 cert 확장에서 사용될 키를 지정합니다. |
type | string 또는 integer | Type은 확장되는 인증서 유형을 나타내며 현재 ssh만 지원됩니다. 0은 "ssh"입니다. 각 옵션의 문자열 또는 정수 표현일 수 있습니다. |
value | string | Value는 cert 확장에서 사용될 값을 지정합니다. |
spec.options.idp
필드 | 유형 | 설명 |
---|---|---|
saml | object | SAML은 Teleport SAML IdP와 관련된 옵션입니다. |
spec.options.idp.saml
필드 | 유형 | 설명 |
---|---|---|
enabled | boolean | Enabled는 이 옵션이 Teleport SAML IdP에 대한 액세스를 허용하면 true로 설정됩니다. |
spec.options.record_session
필드 | 유형 | 설명 |
---|---|---|
default | string | Default는 서비스에 대한 기본 값을 나타냅니다. |
desktop | boolean | Desktop은 데스크톱 세션이 기록되어야 하는지 여부를 나타냅니다. 명시적으로 false로 설정되지 않는 한 기본값은 true입니다. |
ssh | string | SSH는 SSH 세션에서 사용되는 세션 모드를 나타냅니다. |