이 페이지는 Teleport Terraform 프로바이더의 teleport_role 리소스에서 지원되는 값을 설명합니다.

사용 예시#

# Teleport Role resource

resource "teleport_role" "example" {
  version = "v8"
  metadata = {
    name        = "example"
    description = "Example Teleport Role"
    expires     = "2022-10-12T07:20:51Z"
    labels = {
      example = "yes"
    }
  }

  spec = {
    options = {
      forward_agent   = false
      max_session_ttl = "7m"
      ssh_port_forwarding = {
        remote = {
          enabled = false
        }

        local = {
          enabled = false
        }
      }
      client_idle_timeout     = "1h"
      disconnect_expired_cert = true
      permit_x11_forwarding   = false
      request_access          = "optional"
    }

    allow = {
      logins = ["example"]

      rules = [{
        resources = ["user", "role"]
        verbs     = ["list"]
      }]

      request = {
        roles = ["example"]
        claims_to_roles = [{
          claim = "example"
          value = "example"
          roles = ["example"]
        }]
      }

      node_labels = {
        example = ["yes"]
      }
    }

    deny = {
      logins = ["anonymous"]
    }
  }
}

스키마#

필수#

• version (문자열) Version은 리소스 버전입니다. 반드시 지정해야 합니다. 지원되는 값: v3, v4, v5, v6, v7, v8.

선택#

• metadata (속성) Metadata는 리소스 메타데이터입니다. (아래 중첩 스키마 참조)
• spec (속성) Spec은 역할 명세입니다. (아래 중첩 스키마 참조)
• sub_kind (문자열) SubKind는 일부 리소스에서 사용되는 선택적 리소스 하위 종류입니다.

metadata에 대한 중첩 스키마#

필수:

• name (문자열) Name은 객체 이름입니다.

선택:

• description (문자열) Description은 객체 설명입니다.
• expires (문자열) Expires는 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.
• labels (문자열 맵) Labels는 레이블 세트입니다.

spec에 대한 중첩 스키마#

선택:

• allow (속성) Allow는 액세스를 부여하기 위해 평가되는 조건 세트입니다. (아래 중첩 스키마 참조)
• deny (속성) Deny는 액세스를 거부하기 위해 평가되는 조건 세트입니다. Deny는 allow보다 우선합니다. (아래 중첩 스키마 참조)
• options (속성) Options는 에이전트 포워딩과 같은 OpenSSH 옵션을 위한 것입니다. (아래 중첩 스키마 참조)

spec.allow에 대한 중첩 스키마#

선택:

• account_assignments (속성 목록) AccountAssignments는 이 조건의 영향을 받는 계정 할당 목록을 보유합니다. (아래 중첩 스키마 참조)
• app_labels (문자열 목록 맵) AppLabels는 RBAC 시스템의 일부로 사용되는 레이블 맵입니다.
• app_labels_expression (문자열) AppLabelsExpression은 앱에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• aws_role_arns (문자열 목록) AWSRoleARNs는 이 역할이 가정할 수 있는 AWS 역할 ARN 목록입니다.
• azure_identities (문자열 목록) AzureIdentities는 이 역할이 가정할 수 있는 Azure ID 목록입니다.
• cluster_labels (문자열 목록 맵) ClusterLabels는 노드 레이블 맵입니다(클러스터에 대한 액세스를 동적으로 부여하는 데 사용).
• cluster_labels_expression (문자열) ClusterLabelsExpression은 원격 Teleport 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_labels (문자열 목록 맵) DatabaseLabels는 데이터베이스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• db_labels_expression (문자열) DatabaseLabelsExpression은 데이터베이스에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_names (문자열 목록) DatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다.
• db_permissions (속성 목록) DatabasePermissions는 자동 데이터베이스 사용자 프로비저닝을 사용할 때 데이터베이스 사용자에게 부여될 권한 세트를 지정합니다. (아래 중첩 스키마 참조)
• db_roles (문자열 목록) DatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다.
• db_service_labels (문자열 목록 맵) DatabaseServiceLabels는 데이터베이스 서비스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• db_service_labels_expression (문자열) DatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_users (문자열 목록) DatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다.
• desktop_groups (문자열 목록) DesktopGroups는 생성된 데스크톱 사용자가 추가될 그룹 목록입니다.
• gcp_service_accounts (문자열 목록) GCPServiceAccounts는 이 역할이 가정할 수 있는 GCP 서비스 계정 목록입니다.
• github_permissions (속성 목록) GitHubPermissions는 GitHub 통합 관련 권한을 정의합니다. (아래 중첩 스키마 참조)
• group_labels (문자열 목록 맵) GroupLabels는 RBAC 시스템의 일부로 사용되는 레이블 맵입니다.
• group_labels_expression (문자열) GroupLabelsExpression은 사용자 그룹에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• host_groups (문자열 목록) HostGroups는 생성된 사용자가 추가될 그룹 목록입니다.
• host_sudoers (문자열 목록) HostSudoers는 사용자의 sudoer 파일에 포함될 항목 목록입니다.
• impersonate (속성) Impersonate는 이 역할이 인증서 발행이나 다른 방법으로 사칭할 수 있는 사용자와 역할을 지정합니다. (아래 중첩 스키마 참조)
• join_sessions (속성 목록) JoinSessions는 사용자가 다른 세션에 참여할 수 있는 정책을 지정합니다. (아래 중첩 스키마 참조)
• kubernetes_groups (문자열 목록) KubeGroups는 Kubernetes 그룹 목록입니다.
• kubernetes_labels (문자열 목록 맵) KubernetesLabels는 RBAC에 사용되는 Kubernetes 클러스터 레이블 맵입니다.
• kubernetes_labels_expression (문자열) KubernetesLabelsExpression은 Kubernetes 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• kubernetes_resources (속성 목록) KubernetesResources는 이 역할이 액세스를 부여하는 Kubernetes 리소스입니다. (아래 중첩 스키마 참조)
• kubernetes_users (문자열 목록) KubeUsers는 사칭할 선택적 Kubernetes 사용자입니다.
• logins (문자열 목록) Logins는 *nix 시스템 로그인 목록입니다.
• mcp (속성) MCPPermissions는 MCP 서버 관련 권한을 정의합니다. (아래 중첩 스키마 참조)
• node_labels (문자열 목록 맵) NodeLabels는 노드 레이블 맵입니다(노드에 대한 액세스를 동적으로 부여하는 데 사용).
• node_labels_expression (문자열) NodeLabelsExpression은 SSH 노드에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• request (속성) (아래 중첩 스키마 참조)
• require_session_join (속성 목록) RequireSessionJoin은 세션을 시작하는 데 필요한 사용자에 대한 정책을 지정합니다. (아래 중첩 스키마 참조)
• review_requests (속성) ReviewRequests는 액세스 리뷰를 제출하기 위한 조건을 정의합니다. (아래 중첩 스키마 참조)
• rules (속성 목록) Rules는 규칙과 액세스 수준 목록입니다. 규칙은 액세스 제어에 사용되는 고수준 구조입니다. (아래 중첩 스키마 참조)
• spiffe (속성 목록) SPIFFE는 역할 보유자가 SPIFFE SVID를 생성하도록 액세스를 허용하거나 거부하는 데 사용됩니다. (아래 중첩 스키마 참조)
• windows_desktop_labels (문자열 목록 맵) WindowsDesktopLabels는 Windows 데스크톱에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• windows_desktop_labels_expression (문자열) WindowsDesktopLabelsExpression은 Windows 데스크톱에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• windows_desktop_logins (문자열 목록) WindowsDesktopLogins는 Windows 데스크톱에 대해 허용/거부된 데스크톱 로그인 이름 목록입니다.
• workload_identity_labels (문자열 목록 맵) WorkloadIdentityLabels는 특정 WorkloadIdentity 리소스를 호출할 수 있는지 여부를 제어합니다. 추가 권한 부여 제어는 WorkloadIdentity 리소스 자체에 존재합니다.
• workload_identity_labels_expression (문자열) WorkloadIdentityLabelsExpression은 WorkloadIdentity 발행에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.

spec.allow.account_assignments에 대한 중첩 스키마#

선택:

• account (문자열)
• permission_set (문자열)

spec.allow.db_permissions에 대한 중첩 스키마#

선택:

• match (문자열 목록 맵) Match는 권한이 부여되기 위해 일치해야 하는 객체 레이블 목록입니다.
• permissions (문자열 목록) Permission은 부여할 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ...

spec.allow.github_permissions에 대한 중첩 스키마#

선택:

• orgs (문자열 목록)

spec.allow.impersonate에 대한 중첩 스키마#

선택:

• roles (문자열 목록) Roles는 이 역할이 사칭할 수 있는 리소스 목록입니다.
• users (문자열 목록) Users는 이 역할이 사칭할 수 있는 리소스 목록으로, 빈 목록이거나 와일드카드 패턴일 수 있습니다.
• where (문자열) Where는 선택적 고급 매처를 지정합니다.

spec.allow.join_sessions에 대한 중첩 스키마#

선택:

• kinds (문자열 목록) Kinds는 이 정책이 적용되는 세션 종류입니다.
• modes (문자열 목록) Modes는 이 정책에 허용된 참여자 모드 목록입니다.
• name (문자열) Name은 정책의 이름입니다.
• roles (문자열 목록) Roles는 세션에 참여할 수 있는 역할 목록입니다.

spec.allow.kubernetes_resources에 대한 중첩 스키마#

선택:

• api_group (문자열) APIGroup은 Kubernetes 리소스의 Kubernetes API 그룹을 지정합니다. 와일드카드를 지원합니다.
• kind (문자열) Kind는 Kubernetes 리소스 유형을 지정합니다.
• name (문자열) Name은 리소스 이름입니다. 와일드카드를 지원합니다.
• namespace (문자열) Namespace는 리소스 네임스페이스입니다. 와일드카드를 지원합니다.
• verbs (문자열 목록) Verbs는 다음 리소스에 허용된 Kubernetes 동사입니다.

spec.allow.mcp에 대한 중첩 스키마#

선택:

• tools (문자열 목록) Tools는 이 역할에 허용되거나 거부된 도구 목록을 정의합니다. 각 항목은 리터럴 문자열, 글로브 패턴(예: "prefix_*") 또는 정규식('^'으로 시작하고 '$'로 끝나야 함)일 수 있습니다. 목록이 비어 있으면 도구가 허용되지 않습니다.

spec.allow.request에 대한 중첩 스키마#

선택:

• annotations (문자열 목록 맵) Annotations는 생성 시 대기 중인 액세스 요청에 프로그래밍 방식으로 추가될 주석 모음입니다. 이 주석은 플러그인에 추가 정보를 전파하는 메커니즘으로 사용됩니다. 이 주석은 변수 보간 구문을 지원하므로 외부 ID 공급자의 클레임을 {{external.trait_name}} 스타일 대체를 통해 플러그인에 전달하는 메커니즘도 제공합니다.
• claims_to_roles (속성 목록) ClaimsToRoles는 클레임(트레이트)에서 Teleport 역할로의 매핑을 지정합니다. (아래 중첩 스키마 참조)
• kubernetes_resources (속성 목록) kubernetes_resources는 요청자가 특정 종류의 Kubernetes 리소스만 요청하도록 선택적으로 강제할 수 있습니다. (아래 중첩 스키마 참조)
• max_duration (문자열) MaxDuration은 액세스가 부여되는 시간입니다. 0이면 기본 기간이 사용됩니다.
• reason (속성) Reason은 사용자가 제공하는 액세스 이유에 대한 설정을 정의합니다. (아래 중첩 스키마 참조)
• roles (문자열 목록) Roles는 요청 규칙과 일치할 역할의 이름입니다.
• search_as_roles (문자열 목록) SearchAsRoles는 사용자가 리소스 액세스 요청의 일부로 리소스를 검색하는 동안 적용되어야 하는 추가 역할 목록입니다.
• suggested_reviewers (문자열 목록) SuggestedReviewers는 검토자 제안 목록입니다.
• thresholds (속성 목록) Thresholds는 리뷰가 상태 전환을 트리거하기 위해 충족해야 하는 임계값 목록입니다. 임계값이 제공되지 않으면 승인 및 거부에 대해 기본값 1이 사용됩니다. (아래 중첩 스키마 참조)

spec.allow.request.claims_to_roles에 대한 중첩 스키마#

선택:

• claim (문자열) Claim은 클레임 이름입니다.
• roles (문자열 목록) Roles는 일치시킬 정적 Teleport 역할 목록입니다.
• value (문자열) Value는 일치시킬 클레임 값입니다.

spec.allow.request.kubernetes_resources에 대한 중첩 스키마#

선택:

• api_group (문자열) APIGroup은 Kubernetes 리소스 API 그룹을 지정합니다.
• kind (문자열) kind는 Kubernetes 리소스 유형을 지정합니다.

spec.allow.request.reason에 대한 중첩 스키마#

선택:

• mode (문자열) Mode는 "required" 또는 "optional"일 수 있습니다. 빈 문자열은 "optional"로 처리됩니다. 역할의 요청 이유 모드가 "required"로 설정된 경우 이 역할에서 허용하는 역할 또는 리소스를 요청하는 모든 액세스 요청에 이유가 필요합니다. 이 역할이 할당된 사용자에게만 적용됩니다.
• prompt (문자열) Prompt는 요청된 역할 또는 리소스에 대해 사용자에게 표시되는 사용자 지정 메시지입니다.

spec.allow.request.thresholds에 대한 중첩 스키마#

선택:

• approve (숫자) Approve는 상태 전환에 필요한 일치하는 승인 수입니다.
• deny (숫자) Deny는 상태 전환에 필요한 거부 수입니다.
• filter (문자열) Filter는 이 임계값에 계산되는 리뷰를 결정하는 선택적 조건자입니다.
• name (문자열) Name은 임계값의 선택적 사람이 읽을 수 있는 이름입니다.

spec.allow.require_session_join에 대한 중첩 스키마#

선택:

• count (숫자) Count는 이 정책을 충족하기 위해 일치해야 하는 사람 수입니다.
• filter (문자열) Filter는 이 정책에 포함되는 사용자를 결정하는 조건자입니다.
• kinds (문자열 목록) Kinds는 이 정책이 적용되는 세션 종류입니다.
• modes (문자열 목록) Modes는 이 정책을 충족하는 데 사용될 수 있는 모드 목록입니다.
• name (문자열) Name은 정책의 이름입니다.
• on_leave (문자열) OnLeave는 라이브 세션에 대해 정책이 더 이상 충족되지 않을 때 사용되는 동작입니다.

spec.allow.review_requests에 대한 중첩 스키마#

선택:

• claims_to_roles (속성 목록) ClaimsToRoles는 클레임(트레이트)에서 Teleport 역할로의 매핑을 지정합니다. (아래 중첩 스키마 참조)
• preview_as_roles (문자열 목록) PreviewAsRoles는 검토자가 리소스 액세스 요청을 볼 때 적용되어야 하는 추가 역할 목록입니다.
• roles (문자열 목록) Roles는 검토될 수 있는 역할의 이름입니다.
• where (문자열) Where는 검토 가능한 요청을 추가로 제한하는 선택적 조건자입니다.

spec.allow.review_requests.claims_to_roles에 대한 중첩 스키마#

선택:

• claim (문자열) Claim은 클레임 이름입니다.
• roles (문자열 목록) Roles는 일치시킬 정적 Teleport 역할 목록입니다.
• value (문자열) Value는 일치시킬 클레임 값입니다.

spec.allow.rules에 대한 중첩 스키마#

선택:

• actions (문자열 목록) Actions는 이 규칙이 일치할 때 수행되는 선택적 작업을 지정합니다.
• resources (문자열 목록) Resources는 리소스 목록입니다.
• verbs (문자열 목록) Verbs는 동사 목록입니다.
• where (문자열) Where는 선택적 고급 매처를 지정합니다.

spec.allow.spiffe에 대한 중첩 스키마#

선택:

• dns_sans (문자열 목록) DNSSANs는 SPIFFE ID DNS SAN에 대한 매처를 지정합니다.
• ip_sans (문자열 목록) IPSANs는 SPIFFE ID IP SAN에 대한 매처를 지정합니다. 매처는 CIDR 표기법으로 지정해야 하며 IPv4와 IPv6를 지원합니다.
• path (문자열) Path는 SPIFFE ID 경로에 대한 매처를 지정합니다. 신뢰 도메인을 포함하지 않아야 하며 선행 슬래시로 시작해야 합니다.

spec.deny에 대한 중첩 스키마#

선택:

• account_assignments (속성 목록) AccountAssignments는 이 조건의 영향을 받는 계정 할당 목록을 보유합니다. (아래 중첩 스키마 참조)
• app_labels (문자열 목록 맵) AppLabels는 RBAC 시스템의 일부로 사용되는 레이블 맵입니다.
• app_labels_expression (문자열) AppLabelsExpression은 앱에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• aws_role_arns (문자열 목록) AWSRoleARNs는 이 역할이 가정할 수 있는 AWS 역할 ARN 목록입니다.
• azure_identities (문자열 목록) AzureIdentities는 이 역할이 가정할 수 있는 Azure ID 목록입니다.
• cluster_labels (문자열 목록 맵) ClusterLabels는 노드 레이블 맵입니다(클러스터에 대한 액세스를 동적으로 부여하는 데 사용).
• cluster_labels_expression (문자열) ClusterLabelsExpression은 원격 Teleport 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_labels (문자열 목록 맵) DatabaseLabels는 데이터베이스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• db_labels_expression (문자열) DatabaseLabelsExpression은 데이터베이스에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_names (문자열 목록) DatabaseNames는 이 역할이 연결할 수 있는 데이터베이스 이름 목록입니다.
• db_permissions (속성 목록) DatabasePermissions는 자동 데이터베이스 사용자 프로비저닝을 사용할 때 데이터베이스 사용자에게 부여될 권한 세트를 지정합니다. (아래 중첩 스키마 참조)
• db_roles (문자열 목록) DatabaseRoles는 자동 사용자 생성을 위한 데이터베이스 역할 목록입니다.
• db_service_labels (문자열 목록 맵) DatabaseServiceLabels는 데이터베이스 서비스에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• db_service_labels_expression (문자열) DatabaseServiceLabelsExpression은 데이터베이스 서비스에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• db_users (문자열 목록) DatabaseUsers는 이 역할이 연결할 수 있는 데이터베이스 사용자 목록입니다.
• desktop_groups (문자열 목록) DesktopGroups는 생성된 데스크톱 사용자가 추가될 그룹 목록입니다.
• gcp_service_accounts (문자열 목록) GCPServiceAccounts는 이 역할이 가정할 수 있는 GCP 서비스 계정 목록입니다.
• github_permissions (속성 목록) GitHubPermissions는 GitHub 통합 관련 권한을 정의합니다. (아래 중첩 스키마 참조)
• group_labels (문자열 목록 맵) GroupLabels는 RBAC 시스템의 일부로 사용되는 레이블 맵입니다.
• group_labels_expression (문자열) GroupLabelsExpression은 사용자 그룹에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• host_groups (문자열 목록) HostGroups는 생성된 사용자가 추가될 그룹 목록입니다.
• host_sudoers (문자열 목록) HostSudoers는 사용자의 sudoer 파일에 포함될 항목 목록입니다.
• impersonate (속성) Impersonate는 이 역할이 인증서 발행이나 다른 방법으로 사칭할 수 있는 사용자와 역할을 지정합니다. (아래 중첩 스키마 참조)
• join_sessions (속성 목록) JoinSessions는 사용자가 다른 세션에 참여할 수 있는 정책을 지정합니다. (아래 중첩 스키마 참조)
• kubernetes_groups (문자열 목록) KubeGroups는 Kubernetes 그룹 목록입니다.
• kubernetes_labels (문자열 목록 맵) KubernetesLabels는 RBAC에 사용되는 Kubernetes 클러스터 레이블 맵입니다.
• kubernetes_labels_expression (문자열) KubernetesLabelsExpression은 Kubernetes 클러스터에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• kubernetes_resources (속성 목록) KubernetesResources는 이 역할이 액세스를 부여하는 Kubernetes 리소스입니다. (아래 중첩 스키마 참조)
• kubernetes_users (문자열 목록) KubeUsers는 사칭할 선택적 Kubernetes 사용자입니다.
• logins (문자열 목록) Logins는 *nix 시스템 로그인 목록입니다.
• mcp (속성) MCPPermissions는 MCP 서버 관련 권한을 정의합니다. (아래 중첩 스키마 참조)
• node_labels (문자열 목록 맵) NodeLabels는 노드 레이블 맵입니다(노드에 대한 액세스를 동적으로 부여하는 데 사용).
• node_labels_expression (문자열) NodeLabelsExpression은 SSH 노드에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• request (속성) (아래 중첩 스키마 참조)
• require_session_join (속성 목록) RequireSessionJoin은 세션을 시작하는 데 필요한 사용자에 대한 정책을 지정합니다. (아래 중첩 스키마 참조)
• review_requests (속성) ReviewRequests는 액세스 리뷰를 제출하기 위한 조건을 정의합니다. (아래 중첩 스키마 참조)
• rules (속성 목록) Rules는 규칙과 액세스 수준 목록입니다. (아래 중첩 스키마 참조)
• spiffe (속성 목록) SPIFFE는 역할 보유자가 SPIFFE SVID를 생성하도록 액세스를 허용하거나 거부하는 데 사용됩니다. (아래 중첩 스키마 참조)
• windows_desktop_labels (문자열 목록 맵) WindowsDesktopLabels는 Windows 데스크톱에 대한 액세스를 허용/거부하는 RBAC 시스템에서 사용됩니다.
• windows_desktop_labels_expression (문자열) WindowsDesktopLabelsExpression은 Windows 데스크톱에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.
• windows_desktop_logins (문자열 목록) WindowsDesktopLogins는 Windows 데스크톱에 대해 허용/거부된 데스크톱 로그인 이름 목록입니다.
• workload_identity_labels (문자열 목록 맵) WorkloadIdentityLabels는 특정 WorkloadIdentity 리소스를 호출할 수 있는지 여부를 제어합니다.
• workload_identity_labels_expression (문자열) WorkloadIdentityLabelsExpression은 WorkloadIdentity 발행에 대한 액세스를 허용/거부하는 데 사용되는 조건자 표현식입니다.

spec.deny.account_assignments에 대한 중첩 스키마#

선택:

• account (문자열)
• permission_set (문자열)

spec.deny.db_permissions에 대한 중첩 스키마#

선택:

• match (문자열 목록 맵) Match는 권한이 부여되기 위해 일치해야 하는 객체 레이블 목록입니다.
• permissions (문자열 목록) Permission은 부여할 권한의 문자열 표현 목록입니다. 예: SELECT, INSERT, UPDATE, ...

spec.deny.github_permissions에 대한 중첩 스키마#

선택:

• orgs (문자열 목록)

spec.deny.impersonate에 대한 중첩 스키마#

선택:

• roles (문자열 목록) Roles는 이 역할이 사칭할 수 있는 리소스 목록입니다.
• users (문자열 목록) Users는 이 역할이 사칭할 수 있는 리소스 목록으로, 빈 목록이거나 와일드카드 패턴일 수 있습니다.
• where (문자열) Where는 선택적 고급 매처를 지정합니다.

spec.deny.join_sessions에 대한 중첩 스키마#

선택:

• kinds (문자열 목록) Kinds는 이 정책이 적용되는 세션 종류입니다.
• modes (문자열 목록) Modes는 이 정책에 허용된 참여자 모드 목록입니다.
• name (문자열) Name은 정책의 이름입니다.
• roles (문자열 목록) Roles는 세션에 참여할 수 있는 역할 목록입니다.

spec.deny.kubernetes_resources에 대한 중첩 스키마#

선택:

• api_group (문자열) APIGroup은 Kubernetes 리소스의 Kubernetes API 그룹을 지정합니다. 와일드카드를 지원합니다.
• kind (문자열) Kind는 Kubernetes 리소스 유형을 지정합니다.
• name (문자열) Name은 리소스 이름입니다. 와일드카드를 지원합니다.
• namespace (문자열) Namespace는 리소스 네임스페이스입니다. 와일드카드를 지원합니다.
• verbs (문자열 목록) Verbs는 다음 리소스에 허용된 Kubernetes 동사입니다.

spec.deny.mcp에 대한 중첩 스키마#

선택:

• tools (문자열 목록) Tools는 이 역할에 허용되거나 거부된 도구 목록을 정의합니다.

spec.deny.request에 대한 중첩 스키마#

선택:

• annotations (문자열 목록 맵) Annotations는 생성 시 대기 중인 액세스 요청에 프로그래밍 방식으로 추가될 주석 모음입니다.
• claims_to_roles (속성 목록) ClaimsToRoles는 클레임(트레이트)에서 Teleport 역할로의 매핑을 지정합니다. (아래 중첩 스키마 참조)
• kubernetes_resources (속성 목록) kubernetes_resources는 요청자가 특정 종류의 Kubernetes 리소스만 요청하도록 선택적으로 강제할 수 있습니다. (아래 중첩 스키마 참조)
• max_duration (문자열) MaxDuration은 액세스가 부여되는 시간입니다.
• reason (속성) Reason은 사용자가 제공하는 액세스 이유에 대한 설정을 정의합니다. (아래 중첩 스키마 참조)
• roles (문자열 목록) Roles는 요청 규칙과 일치할 역할의 이름입니다.
• search_as_roles (문자열 목록) SearchAsRoles는 사용자가 리소스 액세스 요청의 일부로 리소스를 검색하는 동안 적용되어야 하는 추가 역할 목록입니다.
• suggested_reviewers (문자열 목록) SuggestedReviewers는 검토자 제안 목록입니다.
• thresholds (속성 목록) Thresholds는 리뷰가 상태 전환을 트리거하기 위해 충족해야 하는 임계값 목록입니다. (아래 중첩 스키마 참조)

spec.deny.request.claims_to_roles에 대한 중첩 스키마#

선택:

• claim (문자열) Claim은 클레임 이름입니다.
• roles (문자열 목록) Roles는 일치시킬 정적 Teleport 역할 목록입니다.
• value (문자열) Value는 일치시킬 클레임 값입니다.

spec.deny.request.kubernetes_resources에 대한 중첩 스키마#

선택:

• api_group (문자열) APIGroup은 Kubernetes 리소스 API 그룹을 지정합니다.
• kind (문자열) kind는 Kubernetes 리소스 유형을 지정합니다.

spec.deny.request.reason에 대한 중첩 스키마#

선택:

• mode (문자열) Mode는 "required" 또는 "optional"일 수 있습니다.
• prompt (문자열) Prompt는 요청된 역할 또는 리소스에 대해 사용자에게 표시되는 사용자 지정 메시지입니다.

spec.deny.request.thresholds에 대한 중첩 스키마#

선택:

• approve (숫자) Approve는 상태 전환에 필요한 일치하는 승인 수입니다.
• deny (숫자) Deny는 상태 전환에 필요한 거부 수입니다.
• filter (문자열) Filter는 이 임계값에 계산되는 리뷰를 결정하는 선택적 조건자입니다.
• name (문자열) Name은 임계값의 선택적 사람이 읽을 수 있는 이름입니다.

spec.deny.require_session_join에 대한 중첩 스키마#

선택:

• count (숫자) Count는 이 정책을 충족하기 위해 일치해야 하는 사람 수입니다.
• filter (문자열) Filter는 이 정책에 포함되는 사용자를 결정하는 조건자입니다.
• kinds (문자열 목록) Kinds는 이 정책이 적용되는 세션 종류입니다.
• modes (문자열 목록) Modes는 이 정책을 충족하는 데 사용될 수 있는 모드 목록입니다.
• name (문자열) Name은 정책의 이름입니다.
• on_leave (문자열) OnLeave는 라이브 세션에 대해 정책이 더 이상 충족되지 않을 때 사용되는 동작입니다.

spec.deny.review_requests에 대한 중첩 스키마#

선택:

• claims_to_roles (속성 목록) ClaimsToRoles는 클레임(트레이트)에서 Teleport 역할로의 매핑을 지정합니다. (아래 중첩 스키마 참조)
• preview_as_roles (문자열 목록) PreviewAsRoles는 검토자가 리소스 액세스 요청을 볼 때 적용되어야 하는 추가 역할 목록입니다.
• roles (문자열 목록) Roles는 검토될 수 있는 역할의 이름입니다.
• where (문자열) Where는 검토 가능한 요청을 추가로 제한하는 선택적 조건자입니다.

spec.deny.review_requests.claims_to_roles에 대한 중첩 스키마#

선택:

• claim (문자열) Claim은 클레임 이름입니다.
• roles (문자열 목록) Roles는 일치시킬 정적 Teleport 역할 목록입니다.
• value (문자열) Value는 일치시킬 클레임 값입니다.

spec.deny.rules에 대한 중첩 스키마#

선택:

• actions (문자열 목록) Actions는 이 규칙이 일치할 때 수행되는 선택적 작업을 지정합니다.
• resources (문자열 목록) Resources는 리소스 목록입니다.
• verbs (문자열 목록) Verbs는 동사 목록입니다.
• where (문자열) Where는 선택적 고급 매처를 지정합니다.

spec.deny.spiffe에 대한 중첩 스키마#

선택:

• dns_sans (문자열 목록) DNSSANs는 SPIFFE ID DNS SAN에 대한 매처를 지정합니다.
• ip_sans (문자열 목록) IPSANs는 SPIFFE ID IP SAN에 대한 매처를 지정합니다.
• path (문자열) Path는 SPIFFE ID 경로에 대한 매처를 지정합니다.

spec.options에 대한 중첩 스키마#

선택:

• cert_extensions (속성 목록) CertExtensions는 키/값을 지정합니다. (아래 중첩 스키마 참조)
• cert_format (문자열) CertificateFormat은 이전 버전의 OpenSSH와의 호환성을 허용하기 위한 사용자 인증서 형식을 정의합니다.
• client_idle_timeout (문자열) ClientIdleTimeout은 유휴 시간 초과 동작 시 클라이언트 연결 해제를 설정합니다. 0으로 설정하면 연결 해제되지 않으며, 그렇지 않으면 유휴 기간으로 설정됩니다.
• create_db_user (불리언) CreateDatabaseUser는 자동 데이터베이스 사용자 생성을 활성화합니다.
• create_db_user_mode (숫자) CreateDatabaseUserMode는 off가 아닐 때 데이터베이스에서 사용자가 자동으로 생성될 수 있도록 합니다. 0은 "미지정", 1은 "off", 2는 "keep", 3은 "best_effort_drop"입니다.
• create_desktop_user (불리언) CreateDesktopUser는 Windows 데스크톱에서 사용자가 자동으로 생성될 수 있도록 합니다.
• create_host_user (불리언) 더 이상 사용되지 않음: 대신 CreateHostUserMode를 사용하세요.
• create_host_user_default_shell (문자열) CreateHostUserDefaultShell은 새로 프로비저닝된 호스트 사용자의 기본 셸을 구성하는 데 사용됩니다.
• create_host_user_mode (숫자) CreateHostUserMode는 off가 아닐 때 호스트에서 사용자가 자동으로 생성될 수 있도록 합니다. 0은 "미지정", 1은 "off", 2는 "drop"(v15 이상에서 제거됨), 3은 "keep", 4는 "insecure-drop"입니다.
• desktop_clipboard (불리언) DesktopClipboard는 사용자의 워크스테이션과 원격 데스크톱 간에 클립보드 공유가 허용되는지 여부를 나타냅니다. 명시적으로 false로 설정하지 않는 한 기본값은 true입니다.
• desktop_directory_sharing (불리언) DesktopDirectorySharing은 사용자의 워크스테이션과 원격 데스크톱 간에 디렉터리 공유가 허용되는지 여부를 나타냅니다. 명시적으로 true로 설정하지 않는 한 기본값은 false입니다.
• device_trust_mode (문자열) DeviceTrustMode는 역할과 연결된 리소스에 사용되는 장치 인증 모드입니다.
• disconnect_expired_cert (불리언) DisconnectExpiredCert는 만료된 인증서에 대한 클라이언트 연결 해제를 설정합니다.
• enhanced_recording (문자열 목록) BPF는 BPF 기반 세션 레코더에 기록할 이벤트를 정의합니다.
• forward_agent (불리언) ForwardAgent는 SSH 에이전트 포워딩입니다.
• idp (속성) IDP는 Teleport 내의 IdP 액세스와 관련된 옵션 세트입니다. Teleport Enterprise가 필요합니다. (아래 중첩 스키마 참조)
• lock (문자열) Lock은 역할에 적용될 잠금 모드(strict|best_effort)를 지정합니다.
• max_connections (숫자) MaxConnections는 사용자가 보유할 수 있는 최대 동시 연결 수를 정의합니다.
• max_kubernetes_connections (숫자) MaxKubernetesConnections는 사용자가 보유할 수 있는 최대 동시 Kubernetes 세션 수를 정의합니다.
• max_session_ttl (문자열) MaxSessionTTL은 SSH 세션이 지속될 수 있는 시간을 정의합니다.
• max_sessions (숫자) MaxSessions는 연결당 최대 동시 세션 수를 정의합니다.
• mfa_verification_interval (문자열) MFAVerificationInterval은 연속적인 MFA 검증 사이에 경과할 수 있는 최대 기간을 선택적으로 정의합니다.
• permit_x11_forwarding (불리언) PermitX11Forwarding은 X11 포워딩 사용을 허용합니다.
• pin_source_ip (불리언) PinSourceIP는 인증서 생성 및 사용에 동일한 클라이언트 IP를 강제합니다.
• port_forwarding (불리언) 더 이상 사용되지 않음: 대신 SSHPortForwarding을 사용하세요.
• record_session (속성) RecordDesktopSession은 데스크톱 액세스 세션을 기록할지 여부를 나타냅니다. 명시적으로 false로 설정하지 않는 한 기본값은 true입니다. (아래 중첩 스키마 참조)
• request_access (문자열) RequestAccess는 요청 전략(optional|reason|always)을 정의합니다. 기본값은 optional입니다.
• request_prompt (문자열) RequestPrompt는 사용자에게 요청해야 할 것을 알려주는 선택적 메시지입니다.
• require_session_mfa (숫자) RequireMFAType은 이 사용자에게 적용되는 MFA 요구 유형입니다. 0은 "OFF", 1은 "SESSION", 2는 "SESSION_AND_HARDWARE_KEY", 3은 "HARDWARE_KEY_TOUCH", 4는 "HARDWARE_KEY_PIN", 5는 "HARDWARE_KEY_TOUCH_AND_PIN"입니다.
• ssh_file_copy (불리언) SSHFileCopy는 SSH 세션을 통한 SCP 또는 SFTP를 통한 원격 파일 작업이 허용되는지 여부를 나타냅니다. 명시적으로 false로 설정하지 않는 한 기본값은 true입니다.
• ssh_port_forwarding (속성) SSHPortForwarding은 역할이 허용하는 SSH 포트 포워딩 유형을 구성합니다. (아래 중첩 스키마 참조)

spec.options.cert_extensions에 대한 중첩 스키마#

선택:

• mode (숫자) Mode는 사용할 확장 유형입니다. 현재 critical-option은 지원되지 않습니다. 0은 "extension"입니다.
• name (문자열) Name은 인증서 확장에 사용될 키를 지정합니다.
• type (숫자) Type은 확장되는 인증서 유형을 나타내며, 현재 ssh만 지원됩니다. 0은 "ssh"입니다.
• value (문자열) Value는 인증서 확장에 사용될 값을 지정합니다.

spec.options.idp에 대한 중첩 스키마#

선택:

• saml (속성) SAML은 Teleport SAML IdP와 관련된 옵션입니다. (아래 중첩 스키마 참조)

spec.options.idp.saml에 대한 중첩 스키마#

선택:

• enabled (불리언) Enabled는 이 옵션이 Teleport SAML IdP에 대한 액세스를 허용하는 경우 true로 설정됩니다.

spec.options.record_session에 대한 중첩 스키마#

선택:

• default (문자열) Default는 서비스의 기본값을 나타냅니다.
• desktop (불리언) Desktop은 데스크톱 세션을 기록할지 여부를 나타냅니다. 명시적으로 false로 설정하지 않는 한 기본값은 true입니다.
• ssh (문자열) SSH는 SSH 세션에서 사용되는 세션 모드를 나타냅니다.

spec.options.ssh_port_forwarding에 대한 중첩 스키마#

선택:

• local (속성) 로컬 포트 포워딩을 허용합니다. (아래 중첩 스키마 참조)
• remote (속성) 원격 포트 포워딩을 허용합니다. (아래 중첩 스키마 참조)

spec.options.ssh_port_forwarding.local에 대한 중첩 스키마#

선택:

• enabled (불리언)

spec.options.ssh_port_forwarding.remote에 대한 중첩 스키마#

선택:

• enabled (불리언)