TeleportScopedTokenV1
Teleport v18.11요약
이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportScopedTokenV1 리소스의 필드를 나열합니다. apiVersion: resources.teleport.dev/v1
이 가이드는 Teleport Kubernetes 오퍼레이터를 설치한 후 적용할 수 있는 TeleportScopedTokenV1
리소스의 필드를 나열합니다.
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의 ScopedToken 리소스 정의 v1 |
spec#
| 필드 | 타입 | 설명 |
|---|---|---|
| assigned_scope | string | 이 토큰이 할당되는 스코프입니다. 토큰 자체의 스코프와 같거나 그 하위 스코프여야 합니다. |
| aws | object | "ec2" 및 "iam" 조인 방법에 사용되는 AWS 전용 구성입니다. |
| azure | object | "azure" 조인 방법에 사용되는 Azure 전용 구성입니다. |
| azure_devops | object | "azure_devops" 조인 방법에 사용되는 Azure Devops 전용 구성입니다. |
| bitbucket | object | "bitbucket" 조인 방법에 특화된 구성입니다. |
| bot | string | 이 조인 토큰과 연결된 봇이 있는 경우, <scope>::<bot-name> 형식의 스코프 정규화된 이름으로 지정합니다(예: "/staging/west::mybot"). 스코프 구성 요소는 토큰 리소스 스코프와 같거나 그 하위여야 합니다. assigned_scope와 함께 사용할 수 없습니다. |
| bound_keypair | object | "bound_keypair" 조인 방법에 특화된 구성입니다. |
| circleci | object | "circleci" 조인 방법에 특화된 구성입니다 |
| env0 | object | "env0" 조인 방법에 특화된 구성입니다. |
| gcp | object | "gcp" 조인 방법에 사용되는 GCP 전용 구성입니다. |
| generic_oidc | object | "generic_oidc" 조인 방법에 특화된 구성입니다. |
| github | object | "github" 조인 방법에 특화된 구성입니다. |
| gitlab | object | "gitlab" 조인 방법에 특화된 구성입니다. |
| immutable_labels | object | 이 토큰을 사용해 프로비저닝되는 모든 결과 리소스에 적용할 변경 불가능한 라벨입니다. |
| join_method | string | 이 토큰을 사용하는 데 필요한 조인 방법입니다. 모든 조인 방법이 스코프 토큰을 사용한 조인을 지원하는 것은 아닙니다. |
| kubernetes | object | "kubernetes" 조인 방법에 사용되는 쿠버네티스 전용 구성입니다. |
| oracle | object | "oracle" 조인 방법에 사용되는 Oracle 전용 구성입니다. |
| roles | []string | 토큰과 연결된 역할 목록입니다. 이 값은 토큰 사용자에게 발급되는 SSH 및 X509 인증서의 메타데이터로 변환됩니다. |
| spacelift | object | "spacelift" 조인 방법에 특화된 구성입니다. |
| terraform_cloud | object | "terraform_cloud" 조인 방법에 특화된 구성입니다. |
| tpm | object | "tpm" 조인 방법에 특화된 구성입니다. |
| usage_mode | string | 토큰의 사용 모드입니다. "single_use" 또는 "unlimited"를 지정할 수 있습니다. 단일 사용 토큰은 하나의 리소스를 프로비저닝하는 데만 사용할 수 있습니다. 무제한 토큰은 만료될 때까지 원하는 수만큼 리소스를 프로비저닝하는 데 사용할 수 있습니다. |
spec.aws#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
| iid_ttl | string | 이 토큰으로 클러스터에 조인하는 데 사용되는 AWS EC2 인스턴스 ID 문서의 TTL입니다. "8h" 또는 "6mo"와 같은 기간 문자열이어야 합니다. |
| integration | string | 조인 시도를 검증하기 위한 자격 증명을 제공하는 통합 이름입니다. 현재는 IAM 조인 방법에서 AWS 조직 ID를 검증하는 데만 사용됩니다. |
spec.aws.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| aws_account | string | AWS 계정 ID입니다. |
| aws_arn | string | IAM 조인 방법에서 사용하는 조인 아이덴티티의 ARN입니다. 와일드카드 "*" 및 "?"를 지원합니다. |
| aws_organization_id | string | IAM 조인 방법을 사용할 때 조인하는 AWS 아이덴티티가 속해야 하는 조직 ID입니다. |
| aws_regions | []string | EC2 조인 방법을 사용할 때 노드가 조인할 수 있는 AWS 리전 목록입니다. |
| aws_role | string | EC2 조인 방법을 사용할 때 Auth 서비스가 EC2 API를 호출하기 위해 맡는 역할의 ARN입니다. |
spec.azure#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
spec.azure.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| resource_groups | []string | 노드가 조인할 수 있는 Azure 리소스 그룹 목록입니다. |
| subscription | string | Azure 구독입니다. |
| tenant | string | Tenant는 Azure 테넌트 ID입니다. |
spec.azure_devops#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
| organization_id | string | 이 조인 토큰이 접근을 허용할 Azure DevOps 조직의 UUID입니다. ID 토큰의 올바른 발급자 검증을 식별하는 데 사용됩니다. 필수 필드입니다. |
spec.azure_devops.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| definition_id | string | AZDO 파이프라인 정의의 ID입니다. 예: 1 def_id 클레임에서 매핑됩니다. |
| pipeline_name | string | AZDO 파이프라인의 이름입니다. 예: my-pipeline. sub 클레임에서 매핑됩니다. |
| project_id | string | AZDO 파이프라인의 ID입니다. 예: 271ef6f7-0000-0000-0000-4b54d9129990 prj_id 클레임에서 매핑됩니다. |
| project_name | string | AZDO 프로젝트의 이름입니다. 예: my-project. sub 클레임에서 매핑됩니다. |
| repository_ref | string | 파이프라인이 사용하는 리포지터리의 참조입니다. 예: refs/heads/main. rpo_ref 클레임에서 매핑됩니다. |
| repository_uri | string | 파이프라인이 사용하는 리포지터리의 URI입니다. 예: https://github.com/gravitational/teleport.git. rpo_uri 클레임에서 매핑됩니다. |
| repository_version | string | 파이프라인이 사용하는 리포지터리의 개별 커밋입니다. 예: e6b9eb29a288b27a3a82cc19c48b9d94b80aff36. rpo_ver 클레임에서 매핑됩니다. |
| sub | string | 워크로드를 대략적으로 고유하게 식별하는 subject 문자열입니다. 예: p://my-organization/my-project/my-pipeline sub 클레임에서 매핑됩니다. |
spec.bitbucket#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 규칙 목록입니다. 조인을 시도하는 워크로드는 조인이 허용되려면 허용 규칙을 하나 이상 충족해야 합니다. |
| audience | string | 이 토큰에 대해 Bitbucket이 지정한 audience 값입니다. Bitbucket 리포지터리마다 고유하며, 리포지터리 설정의 "Pipelines -> OpenID Connect" 섹션에 적힌 값 그대로 설정해야 합니다. |
| identity_provider_url | string | 들어오는 OIDC 토큰에 대해 Bitbucket이 지정한 발급자 URL입니다. Bitbucket 리포지터리마다 고유하며, 리포지터리 설정의 "Pipelines -> OpenID Connect" 섹션에 적힌 값 그대로 설정해야 합니다. |
spec.bitbucket.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| branch_name | string | 이 파이프라인이 실행된 브랜치의 이름입니다. |
| deployment_environment_uuid | string | 이 파이프라인 실행이 대상으로 하는 배포 환경의 UUID입니다(있는 경우). 이 값은 리포지터리 설정의 "Pipelines -> OpenID Connect -> Deployment environments" 섹션에서 확인할 수 있습니다. |
| repository_uuid | string | 이 토큰이 발급된 리포지터리의 UUID입니다. Bitbucket UUID는 중괄호로 시작하고 끝나야 합니다(예: {...}). 이 값은 리포지터리 설정의 "Pipelines -> OpenID Connect" 섹션에서 확인할 수 있습니다. |
| workspace_uuid | string | 이 토큰이 발급된 워크스페이스의 UUID입니다. 이 값은 리포지터리 설정의 "Pipelines -> OpenID Connect" 섹션에서 확인할 수 있습니다. |
spec.bound_keypair#
| 필드 | 타입 | 설명 |
|---|---|---|
| onboarding | object | 초기 온보딩 및 키 쌍 등록과 관련된 매개변수입니다. |
| recovery | object | 초기 조인을 포함해, 아이덴티티 만료 이후의 복구와 관련된 매개변수입니다. |
| rotate_after | string | 지정한 날짜 이후 클라이언트가 다음 조인 또는 복구를 시도할 때 키 쌍 교체를 수행하도록 강제하는 선택적 타임스탬프입니다. LastRotatedAt이 설정되지 않았거나 이 타임스탬프보다 이전이면 교체가 요청됩니다. 다음 조인 시도에서 교체를 유발하려면 이 값을 현재 타임스탬프로 설정하는 것을 권장합니다. |
spec.bound_keypair.onboarding#
| 필드 | 타입 | 설명 |
|---|---|---|
| initial_public_key | string | 초기 공개 키는 tbot keypair create로 생성한 공개 키를 사전 등록하는 데 사용됩니다. 설정하면 초기 조인 시크릿이 생성되거나 제공되지 않으며, 클라이언트는 조인하려면 연결된 개인 키를 가지고 있어야 합니다. 설정하면 initial_join_secret 및 must_register_before는 무시됩니다. 이 값은 SSH authorized_keys 형식으로 작성합니다. |
| must_register_before | string | 등록 조인 시크릿을 통한 등록이 완료되어야 하는 기한을 지정하는 선택적 시간입니다. 이 타임스탬프 이후에는 등록 시크릿을 사용한 등록이 허용되지 않습니다. 초기 등록이 이루어질 수 있도록 필요하면 생성 후에 이 값을 수정할 수 있습니다. initial_public_key가 설정되면 이 값은 무시됩니다. |
| registration_secret | string | 조인하는 클라이언트가 최초 조인 시 공개 키를 등록하는 데 사용할 수 있는 시크릿이며, initial_public_key로 공개 키를 사전 등록하는 대신 사용할 수 있습니다. initial_public_key가 설정되면 이 값은 무시됩니다. 그렇지 않고 값이 설정되면 .status.bound_keypair.registration_secret을 채우는 데 사용됩니다. 설정하지 않았고 initial_public_key도 제공되지 않으면, 서버 측에서 임의의 안전한 값을 생성해 상태 필드를 채웁니다. |
spec.bound_keypair.recovery#
| 필드 | 타입 | 설명 |
|---|---|---|
| limit | integer | 허용되는 최대 복구 시도 횟수입니다. 초기 한도를 모두 소진한 경우 추가 복구 시도를 허용하려면 생성 후에 이 값을 올리거나 내릴 수 있습니다. mode가 standard로 설정되면 .status.bound_keypair.recovery_count가 이 한도보다 작을 때만 복구 시도가 허용됩니다. mode가 relaxed 또는 insecure로 설정되면 이 한도는 적용되지 않습니다. 온보딩 중 초기 조인도 복구로 계산되므로 이 값은 1 이상이어야 합니다. |
| mode | string | Mode는 복구 규칙 적용 모드를 설정합니다. 다음 값 중 하나를 사용할 수 있습니다. - standard(또는 미설정): 구성된 모든 규칙을 적용합니다. 복구 한도와 클라이언트 조인 상태가 필수이며 검증됩니다. 가장 안전한 복구 모드입니다. - relaxed: 복구 한도는 적용하지 않지만 클라이언트 조인 상태는 여전히 필요합니다. 사실상 복구 시도를 무제한으로 허용하지만, 클라이언트 조인 상태가 탈취된 자격 증명의 위험을 완화하는 데 도움이 됩니다. - insecure: 복구 한도와 클라이언트 조인 상태를 모두 적용하지 않습니다. 개인 키를 가진 모든 클라이언트가 자유롭게 조인할 수 있습니다. 보안 수준은 낮지만, 지원되지 않는 CI/CD 제공업체와 같은 특정 상황에서 유용할 수 있습니다. 이 모드는 신중하게 사용해야 하며, 이 아이덴티티가 접근할 수 있는 리소스를 강하게 제한하도록 RBAC 규칙을 구성해야 합니다. |
spec.circleci#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | Allow는 TokenRules 목록이며, 이 토큰을 사용하는 노드는 허용 규칙 중 하나와 일치해야 이 토큰을 사용할 수 있습니다. 규칙이 하나 이상 필요합니다. |
| organization_id | string | 조직의 고유 식별자입니다. 필수입니다. |
spec.circleci.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| context_id | string | 고유한 컨텍스트 식별자입니다. context_id 또는 project_id 중 하나 이상이 필요합니다. |
| project_id | string | 고유한 프로젝트 식별자입니다. project_id 또는 context_id 중 하나 이상이 필요합니다. |
spec.env0#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰이 허용하는 규칙 목록입니다. 조인을 시도하는 클라이언트는 이 규칙 중 하나 이상과 일치하는 JWT를 제시해야 합니다. |
spec.env0.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| deployer_email | string | 배포를 트리거한 사람의 이메일이며, Env0 OIDC 토큰의 deployerEmail에 해당합니다. |
| deployment_type | string | "deploy", "destroy" 등 env0 배포 유형이며, Env0 OIDC 토큰의 deploymentType에 해당합니다. |
| env0_tag | string | ENV0_OIDC_TAG가 설정된 경우 JWT의 env0Tag에 해당하는 사용자 지정 태그 값입니다. |
| environment_id | string | Env0 환경의 고유 식별자이며, Env0 OIDC 토큰의 environmentId에 해당합니다. |
| environment_name | string | Env0 환경의 이름이며, Env0 OIDC 토큰의 environmentName에 해당합니다. |
| organization_id | string | 고유한 조직 식별자이며, Env0 OIDC 토큰의 organizationId에 해당합니다. |
| project_id | string | 고유한 프로젝트 식별자이며, Env0 OIDC 토큰의 projectId에 해당합니다. |
| project_name | string | 작업이 실행된 프로젝트의 이름이며, Env0 OIDC 토큰의 projectName에 해당합니다. |
| template_id | string | Env0 템플릿의 고유 식별자이며, Env0 OIDC 토큰의 templateId에 해당합니다. |
| template_name | string | Env0 템플릿의 이름이며, Env0 OIDC 토큰의 templateName에 해당합니다. |
| workspace_name | string | Env0 워크스페이스의 이름이며, Env0 OIDC 토큰의 workspaceName에 해당합니다. |
spec.gcp#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
spec.gcp.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| locations | []string | 리전(예: "us-west1") 및/또는 영역(예: "us-west1-b") 목록입니다. |
| project_ids | []string | 프로젝트 ID 목록입니다(예: <example-id-123456>). |
| service_accounts | []string | 서비스 계정 이메일 목록입니다(예: <project-number>-compute@developer.gserviceaccount.com). |
spec.generic_oidc#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow_any | []object | "OR" 의미 체계로 평가되는 복합 규칙입니다. 규칙이 하나라도 지정되면, 조인 시도가 허용되려면 규칙 중 하나 이상이 true로 평가되어야 합니다. 이 규칙은 must_match_fields에 필드 매처가 지정된 경우 그 블록 다음에 평가됩니다. 조인 시도가 성공하려면 must_match_fields 또는 allow_any 중 한 곳에 규칙이 하나 이상 지정되어야 합니다. |
| audience | string | 필수인 예상 JWT audience 값입니다. 클라이언트가 조인할 때 제공하는 JWT의 aud 값 목록과 일치하거나 그 목록에 포함되어야 합니다. 이 값을 직접 구성할 수 없는 제공업체의 경우(기술적으로는 OIDC 명세 위반이지만 흔한 일입니다) 제공업체가 제공하는 값을 사용합니다. 그렇지 않다면 Teleport 클러스터와 조인 토큰을 고유하게 식별하는 값을 사용할 것을 권장합니다. 예를 들어 다음 체계를 사용할 수 있습니다. $clusterName/$tokenName 클러스터 이름이 example.teleport.sh이고 토큰 이름이 example이면 audience는 example.teleport.sh/example이 됩니다. 원하는 경우 토큰 이름 대신 UUID를 사용할 수도 있습니다. 일치하는 값은 발급자 쪽에서, 보통 요청 시점에 구성해야 합니다. |
| insecure_allow_http_issuer | boolean | 설정하면 발급자가 HTTPS를 사용해야 한다는 요구 사항을 비활성화합니다. |
| issuer | string | 신뢰하려는 JWT에 기록된 예상 iss 값입니다. static_jwks를 구성하지 않은 경우, 이 발급자는 Teleport 클러스터에서 HTTPS로 접근할 수 있어야 하며 검색 구성과 JWKS 키를 포함한 유효한 OIDC 메타데이터를 제공해야 합니다. |
| must_match_fields | object | "Must match" 필드는 "AND" 의미 체계로 단순 비교 일치를 수행합니다. 규칙은 JWT의 구조를 그대로 본떠, 들어오는 토큰의 값과 같을 것으로 예상되는 값을 사용해 지정합니다. 이러한 필드 일치 규칙은 문자열, 숫자, 불리언, 중첩 필드와 같은 단순 값을 비교하는 데만 사용할 수 있습니다. 목록을 포함한 복합 값은 allow_any 표현식 규칙을 대신 사용해야 합니다. 필드 일치 규칙이 하나라도 지정되면 조인 시도가 성공하려면 모두 해당 JWT 필드와 같아야 합니다. allow_any에 복합 규칙이 지정된 경우 그 규칙은 must_match_fields 다음에 평가됩니다. must_match_fields가 지정되지 않았거나 비어 있으면 allow_any의 규칙만 평가됩니다. 이 규칙은 모든 조인 시도에 적용되는 "전역" 규칙으로 사용할 수 있습니다. 예를 들어 모든 시도가 조직에서 시작되었는지 확인하는 데 사용한 다음, allow_any 규칙으로 개별 리포지터리, 파이프라인 또는 워크스페이스를 허용할 수 있습니다. 조인 시도가 성공하려면 must_match_fields 또는 allow_any 중 한 곳에 규칙이 하나 이상 지정되어야 합니다. |
| static_jwks | string | 제공업체가 OIDC 검색을 지원하지 않거나 검색 구성에 Teleport가 접근할 수 없을 때 JWKS 키를 지정하는 데 사용할 수 있는 선택적 정적 JWKS 값입니다. 설정하면 issuer에 포함된 URL에서 구성과 JWKS 키를 가져오지 않으며, 여기에 지정한 키 집합으로 JWT를 검증합니다. |
| tls_ca | string | 발급자의 OIDC 메타데이터 요청을 검증할 때 Teleport의 CA 저장소 대신 사용할 TLS CA 인증서입니다. 발급자가 공개되어 있지 않거나 자체 서명 인증서를 사용하는 경우에 유용합니다. 설정하지 않으면 OIDC 메타데이터를 가져올 때 발급자와의 연결을 표준 웹 PKI 루트 인증서로 검증합니다. 이 값은 이 토큰을 사용하는 요청에만 적용되며, 시스템 CA 저장소에 추가되는 것이 아니라 그 대신 사용되고, 원격 CA가 갱신되면 수동으로 업데이트해야 합니다. |
spec.generic_oidc.allow_any items#
| 필드 | 타입 | 설명 |
|---|---|---|
| conditions | []object | Conditions는 개별 필드를 확인하는 단순한 eq/not_eq/in/not_in 조건입니다. 조인 시도가 허용되려면 모든 조건을 충족해야 합니다. expression과 함께 사용할 수 없습니다. |
| expression | string | 조인 시도가 허용되려면 true로 평가되어야 하는 프레디킷 표현식입니다. conditions와 함께 사용할 수 없습니다. TODO: Include name of variable available to the expr in docs |
spec.generic_oidc.allow_any items.conditions items#
| 필드 | 타입 | 설명 |
|---|---|---|
| attribute | string | 이 조건이 확인할 필드의 이름이며, 중첩 필드는 "."로 구분합니다. |
| eq | object | "equals" 연산자입니다. 조건 하나에는 연산자를 하나만 설정할 수 있습니다. |
| in | object | "in" 연산자입니다. 조건 하나에는 연산자를 하나만 설정할 수 있습니다. |
| not_eq | object | "not equals" 연산자입니다. 조건 하나에는 연산자를 하나만 설정할 수 있습니다. |
| not_in | object | "not in" 연산자입니다. 조건 하나에는 연산자를 하나만 설정할 수 있습니다. |
spec.generic_oidc.allow_any items.conditions items.eq#
| 필드 | 타입 | 설명 |
|---|---|---|
| value | string | 속성과 비교할 값입니다. |
spec.generic_oidc.allow_any items.conditions items.in#
| 필드 | 타입 | 설명 |
|---|---|---|
| values | []string | 속성과 비교할 값 목록입니다. |
spec.generic_oidc.allow_any items.conditions items.not_eq#
| 필드 | 타입 | 설명 |
|---|---|---|
| value | string | 속성과 비교할 값입니다. |
spec.generic_oidc.allow_any items.conditions items.not_in#
| 필드 | 타입 | 설명 |
|---|---|---|
| values | []string | 속성과 비교할 값 목록입니다. |
spec.github#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | GitHub Actions OIDC 토큰에 대해 평가되는 클레임 일치 필드 집합입니다. |
| enterprise_server_host | string | enterprise_server_host는 GitHub Enterprise Server 인스턴스와 연결된 러너에서의 조인을 허용합니다. 구성하지 않으면 토큰은 github.com에 대해 검증되고, GHES 인스턴스의 호스트로 구성하면 해당 호스트에 대해 검증됩니다. 이 값은 GHES 인스턴스의 호스트 이름이어야 하며 스킴이나 경로를 포함하지 않아야 합니다. 인스턴스는 이 호스트 이름으로 HTTPS 접근이 가능해야 하며, 인증서를 Auth 서비스가 신뢰해야 합니다. |
| enterprise_slug | string | enterprise_slug는 GitHub Enterprise 조직의 슬러그를 OIDC 토큰의 예상 발급자에 포함할 수 있게 합니다. GHE의 include_enterprise_slug 옵션과의 호환을 위한 것입니다. 이 옵션을 활성화했다면 이 필드를 엔터프라이즈의 슬러그로 설정해야 합니다. 활성화하지 않았다면 이 필드를 비워 두어야 합니다. enterprise_server_host가 지정된 경우에는 이 필드를 지정할 수 없습니다. 사용자 지정 발급자 값에 대한 자세한 내용은 https://docs.github.com/en/enterprise-cloud@latest/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#customizing-the-issuer-value-for-an-enterprise 에서 확인할 수 있습니다. |
| static_jwks | string | static_jwks는 JWKS/OIDC 엔드포인트를 통한 GHES 서명 키 가져오기를 비활성화하고, 키를 직접 지정할 수 있게 합니다. 이를 통해 Teleport Auth 서비스가 접근할 수 없는 GHES 인스턴스의 GitHub Actions에서도 조인할 수 있습니다. |
spec.github.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| actor | string | actor는 워크플로 실행을 시작한 개인 계정입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| enterprise | string | 리포지터리가 저장된 엔터프라이즈 이름입니다. |
| enterprise_id | string | 리포지터리가 저장된 enterprise_id입니다. |
| environment | string | 작업이 사용하는 환경 이름입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| ref | string | 워크플로 실행을 트리거한 ref(git)입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| ref_type | string | ref_type입니다. 예: "branch". |
| repository | string | 워크플로가 실행되는 리포지터리입니다. 소유자 이름을 포함합니다(예: gravitational/teleport). 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| repository_owner | string | repository_owner는 리포지터리가 저장된 조직의 이름입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| sub | string | Subject라고도 하는 sub는 워크로드를 대략적으로 고유하게 식별하는 문자열입니다. 형식은 GitHub Actions 실행 유형에 따라 다릅니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| workflow | string | 워크플로 이름입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
spec.gitlab#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | GitLab CI 토큰에 대해 평가되는 클레임 일치 필드 집합입니다. |
| domain | string | GitLab 인스턴스의 도메인입니다. 기본값은 gitlab.com이며, 셀프 호스팅 GitLab의 도메인으로 설정할 수 있습니다(예: gitlab.example.com). |
| static_jwks | string | JWKS/OIDC 엔드포인트를 통한 GitLab 서명 키 가져오기를 비활성화하고, 키를 직접 지정할 수 있게 합니다. 이를 통해 Teleport Auth 서비스가 접근할 수 없는 GitLab CI 인스턴스에서도 조인할 수 있습니다. |
spec.gitlab.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| ci_config_ref_uri | string | 최상위 파이프라인 정의의 ref 경로입니다. 예: gitlab.example.com/my-group/my-project//.gitlab-ci.yml@refs/heads/main. |
| ci_config_sha | string | ci_config_ref_uri의 git 커밋 SHA입니다. |
| deployment_tier | string | 작업이 지정한 환경의 배포 티어입니다. |
| environment | string | 작업이 배포하는 환경(연결된 환경이 있는 경우)을 기준으로 접근을 제한합니다. |
| environment_protected | boolean | Git ref가 보호되어 있으면 true, 그렇지 않으면 false입니다. |
| namespace_path | string | 그룹 또는 사용자의 프로젝트에 속한 작업으로 접근을 제한하는 데 사용합니다. 예: mygroup 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| pipeline_source | string | 작업 파이프라인 소스 유형으로 접근을 제한합니다. https://docs.gitlab.com/ee/ci/jobs/job_control.html#common-if-clauses-for-rules 예: web |
| project_path | string | 개별 프로젝트에 속한 작업으로 접근을 제한하는 데 사용합니다. 예: mygroup/myproject 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| project_visibility | string | 파이프라인이 실행되는 프로젝트의 공개 범위입니다. internal, private 또는 public일 수 있습니다. |
| ref | string | 특정 git ref에서 트리거된 작업으로 접근을 제한할 수 있습니다. ref_type과 함께 사용해야 합니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| ref_protected | boolean | Git ref가 보호되어 있으면 true, 그렇지 않으면 false입니다. |
| ref_type | string | 특정 git ref 유형에서 트리거된 작업으로 접근을 제한할 수 있습니다. 예: branch 또는 tag |
| sub | string | 워크로드를 대략적으로 고유하게 식별합니다. 예: project_path:mygroup/my-project:ref_type:branch:ref:main project_path:GROUP/PROJECT:ref_type:TYPE:ref:BRANCH_NAME 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| user_email | string | 작업을 실행하는 사용자의 이메일입니다. |
| user_id | string | 작업을 실행하는 사용자의 ID입니다. |
| user_login | string | 작업을 실행하는 사용자의 사용자 이름입니다. |
spec.immutable_labels#
| 필드 | 타입 | 설명 |
|---|---|---|
| ssh | object | SSH 노드에 적용할 라벨입니다. |
spec.immutable_labels.ssh#
| 필드 | 타입 | 설명 |
|---|---|---|
| key | string | |
| value | string |
spec.kubernetes#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
| oidc | object | oidc 유형에 특화된 구성입니다. |
| static_jwks | object | static_jwks 유형에 특화된 구성입니다. |
| type | string | 쿠버네티스 서비스 계정 토큰을 검증할 때 사용할 동작을 제어합니다. 지원되는 값: - in_cluster - static_jwks - oidc |
spec.kubernetes.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| service_account | string | 쿠버네티스 서비스 계정의 네임스페이스 포함 이름입니다. 형식은 "namespace:service-account"입니다. |
| service_account_name | string | 쿠버네티스 서비스 계정의 이름입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| service_account_namespace | string | 쿠버네티스 서비스 계정의 네임스페이스입니다. 이 필드는 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
spec.kubernetes.oidc#
| 필드 | 타입 | 설명 |
|---|---|---|
| insecure_allow_http_issuer | boolean | 설정하면 발급자가 HTTPS를 사용해야 한다는 요구 사항을 비활성화합니다. |
| issuer | string | OIDC 발급자의 URI입니다. 접근 가능하고 OIDC를 준수하는 /.well-known/openid-configuration 엔드포인트가 있어야 합니다. 유효한 URL이어야 하며 서비스 계정 JWT의 issuer 필드와 정확히 일치해야 합니다. 예: https://oidc.eks.us-west-2.amazonaws.com/id/12345... |
spec.kubernetes.static_jwks#
| 필드 | 타입 | 설명 |
|---|---|---|
| jwks | string | 쿠버네티스 클러스터가 서비스 계정 토큰에 서명하는 데 사용하는, JSON Web Key Set 형식의 공개 키입니다. 쿠버네티스 API 서버의 /openid/v1/jwks에서 가져올 수 있습니다. |
spec.oracle#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰의 사용을 허용하는 규칙 목록입니다. 노드는 이 토큰을 사용하려면 허용 규칙을 하나 이상 충족해야 합니다. |
spec.oracle.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| instances | []string | 조인이 허용되는 특정 인스턴스의 OCID 목록입니다. 비어 있으면 규칙의 다른 필드와 일치하는 모든 인스턴스가 허용됩니다. 규칙당 인스턴스 OCID는 최대 100개로 제한됩니다. |
| parent_compartments | []string | 인스턴스가 조인할 수 있는 컴파트먼트의 OCID 목록입니다. 직접 상위 컴파트먼트만 허용되며, 중첩 컴파트먼트는 허용되지 않습니다. 비어 있으면 모든 컴파트먼트가 허용됩니다. |
| regions | []string | 인스턴스가 조인할 수 있는 리전 목록입니다. 전체 리전 이름("us-phoenix-1")과 약어("phx")를 모두 사용할 수 있습니다. 비어 있으면 모든 리전이 허용됩니다. |
| tenancy | string | 인스턴스 테넌시의 OCID입니다. 필수입니다. |
spec.spacelift#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰이 허용하는 규칙 목록입니다. 조인을 시도하는 클라이언트는 이 규칙 중 하나 이상과 일치하는 JWT를 제시해야 합니다. |
| enable_glob_matching | boolean | 규칙의 space_id 및 caller_id 필드에 glob 스타일 일치를 활성화합니다. |
| hostname | string | 토큰이 발급될 Spacelift 테넌트의 호스트 이름입니다(예: example.app.spacelift.io). |
spec.spacelift.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| caller_id | string | 호출자의 ID이며, 실행을 생성한 스택 또는 모듈을 가리킵니다. 이 필드는 enable_glob_matching이 true일 때 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
| caller_type | string | 호출자의 유형이며, 실행을 소유한 엔티티로서 stack 또는 module입니다. |
| scope | string | 토큰의 스코프이며 read 또는 write입니다. 자세한 내용은 https://docs.spacelift.io/integrations/cloud-providers/oidc/#about-scopes 에서 확인할 수 있습니다. |
| space_id | string | 토큰을 소유한 실행이 수행된 스페이스의 ID입니다. 이 필드는 enable_glob_matching이 true일 때 "glob 스타일" 일치를 지원합니다. - '*'는 0개 이상의 문자와 일치합니다. - '?'는 임의의 문자 하나와 일치합니다. |
spec.terraform_cloud#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 이 토큰이 허용하는 규칙 목록입니다. 조인을 시도하는 클라이언트는 이 규칙 중 하나 이상과 일치하는 JWT를 제시해야 합니다. |
| audience | string | Terraform Cloud에서 TFC_WORKLOAD_IDENTITY_AUDIENCE_($TAG) 변수 집합으로 구성한 것과 같이 예상되는 JWT audience(aud)입니다. 설정하지 않으면 Teleport 클러스터 이름이 기본값입니다. 예를 들어 Terraform Cloud에서 TFC_WORKLOAD_IDENTITY_AUDIENCE_TELEPORT=foo를 설정했다면 이 값은 foo여야 합니다. 값이 Teleport 클러스터 이름이면 여기에서 구성할 필요가 없습니다. |
| hostname | string | 이 토큰이 수락하는 JWT를 발급할 것으로 예상되는 Terraform Enterprise 인스턴스의 호스트 이름입니다. 설정하지 않으면 기본 Terraform Cloud 발급자인 app.terraform.io가 기본값이며, 그렇지 않으면 Terraform Enterprise 제공업체가 발급한 JWT의 iss 필드와 일치해야 합니다. |
spec.terraform_cloud.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| organization_id | string | HCP Terraform 조직의 ID입니다. organization_id 또는 organization_name 중 하나 이상을 제공해야 합니다. |
| organization_name | string | HCP Terraform 조직의 사람이 읽을 수 있는 이름입니다. organization_id 또는 organization_name 중 하나 이상을 제공해야 합니다. |
| project_id | string | HCP Terraform 프로젝트의 ID입니다. project_id, project_name, workspace_id, workspace_name 중 하나 이상이 필요합니다. |
| project_name | string | HCP Terraform 프로젝트의 사람이 읽을 수 있는 이름입니다. project_id, project_name, workspace_id, workspace_name 중 하나 이상이 필요합니다. |
| run_phase | string | 토큰이 발급된 실행의 단계입니다. 예: plan 또는 apply |
| workspace_id | string | HCP Terraform 워크스페이스의 ID입니다. project_id, project_name, workspace_id, workspace_name 중 하나 이상이 필요합니다. |
| workspace_name | string | HCP Terraform 워크스페이스의 사람이 읽을 수 있는 이름입니다. project_id, project_name, workspace_id, workspace_name 중 하나 이상이 필요합니다. |
spec.tpm#
| 필드 | 타입 | 설명 |
|---|---|---|
| allow | []object | 규칙 목록입니다. 제시된 위임 아이덴티티가 허용 규칙 중 하나와 일치해야 조인이 허용됩니다. |
| ekcert_allowed_cas | []string | TPM EKCert를 검증하는 데 사용할 CA 인증서 목록입니다. 지정하면 조인하는 TPM은 지정된 CA 중 하나가 서명한 EKCert를 제시해야 합니다. EKCert를 제시하지 않는 TPM은 조인할 수 없습니다. 지정하지 않으면 TPM은 EKCert 또는 EKPubHash 중 하나로 조인할 수 있습니다. |
spec.tpm.allow items#
| 필드 | 타입 | 설명 |
|---|---|---|
| description | string | 규칙에 대한 사람이 읽을 수 있는 설명입니다. TPM의 조인 허용 여부에는 영향을 주지 않지만, 규칙을 특정 호스트(예: TPM이 탑재된 서버의 자산 태그)와 연결하는 데 사용할 수 있습니다. 예: "build-server-100" |
| ek_certificate_serial | string | 콜론으로 구분된 니블 형식의 16진수 EKCert 일련번호입니다. TPM에 EKCert가 구성되어 있지 않으면 이 값은 확인되지 않습니다. 예: 73:df:dc:bd:af:ef:8a:d8:15:2e:96:71:7a:3e:7f:a4 |
| ek_public_hash | string | PKIX 형식으로 마샬링하여 16진수로 인코딩한 EKPub의 SHA256 해시입니다. TPM이 EKCert를 제출한 경우에도 이 값을 확인하며, 이때 EKCert의 공개 키가 이 확인에 사용됩니다. 예: d4b45864d9d6fabfc568d74f26c35ababde2105337d7af9a6605e1c56c891aa6 |