InfoGrab DocsInfoGrab Docs

TeleportScopedTokenV1

요약

이 가이드는 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

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