InfoGrab DocsInfoGrab Docs

Bot Instance 참조

요약

Kind: bot_instance Version: v1 bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다. tbot 서비스의 상태 정상 여부를 설명합니다.

Kind: bot_instance
Version: v1

bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다. tctl로 bot_instance 리소스를 조회하고 목록으로 확인할 수는 있지만, 생성·수정·삭제할 수는 없습니다.

최상위 필드#

예시:

kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
status: # [...]
scope: "string"
필드 이름 설명 타입
kind 표현되는 리소스의 종류입니다. string
metadata 모든 리소스가 공통으로 가지는 메타데이터입니다. Metadata
scope BotInstance의 범위입니다. 이 인스턴스와 연결된 Bot의 범위를 기준으로 결정되며, BotInstance 리소스에 대한 범위 지정 RBAC에 사용될 수 있습니다. string
spec BotInstance에 구성된 속성입니다. Bot Instance Spec
status 작업 결과로 서버가 설정하는 필드입니다. 사용자가 수정해서는 안 됩니다. Bot Instance Status
sub_kind 같은 종류 내의 변형을 구분합니다. 값이 채워지지 않더라도 모든 리소스는 이 필드를 가져야 합니다. string
version 표현되는 리소스의 버전입니다. string

Bot Instance Health Status#

tbot 서비스의 상태 정상 여부를 설명합니다.

Bot Instance Service Health#

tbot 서비스 상태의 스냅샷입니다.

예시:

service: # [...]
status: # [...]
reason: "string"
updated_at: # See description
필드 이름 설명 타입
reason 서비스 상태에 대한 사람이 읽을 수 있는 설명입니다. 오류 메시지가 포함될 수 있습니다. string
service 서비스를 식별합니다. Bot Instance Service Identifier
status 서비스의 상태 정상 여부를 설명합니다. Bot Instance Health Status
updated_at 서비스 상태가 마지막으로 변경된 시각입니다.

Bot Instance Service Identifier#

tbot 서비스를 고유하게 식별합니다.

예시:

type: "string"
name: "string"
필드 이름 설명 타입
name 서비스의 이름으로, 사용자가 지정하거나 자동으로 생성됩니다. string
type 서비스의 유형입니다(예: database-tunnel, ssh-multiplexer). string

Bot Instance Spec#

다음 필드를 포함합니다.

예시:

bot_name: "string"
instance_id: "string"
previous_instance_id: "string"
필드 이름 설명 타입
bot_name 이 인스턴스와 연결된 봇의 이름입니다. string
instance_id 이 인스턴스의 고유 식별자입니다. string
previous_instance_id 이전 인스턴스 ID이며, 있는 경우에만 설정됩니다. 이전 아이덴티티가 만료된 후 봇이 다시 인증할 때 설정됩니다. 현재는 bound-keypair 재조인 중에만 설정됩니다. string

Bot Instance Status#

BotInstance의 상태를 담고 있습니다.

예시:

initial_authentication: # [...]
latest_authentications: 
  - # [...]
  - # [...]
  - # [...]
initial_heartbeat: # [...]
latest_heartbeats: 
  - # [...]
  - # [...]
  - # [...]
service_health: 
  - # [...]
  - # [...]
  - # [...]
필드 이름 설명 타입
initial_authentication 이 봇 인스턴스의 최초 인증 상태입니다. Bot Instance Status Authentication
initial_heartbeat 이 봇 인스턴스의 최초 하트비트 상태입니다. Bot Instance Status Heartbeat
latest_authentications 이 봇 인스턴스의 최근 N개 인증 상태 레코드입니다. []Bot Instance Status Authentication
latest_heartbeats 이 봇 인스턴스의 최근 N개 하트비트입니다. []Bot Instance Status Heartbeat
service_health tbot이 실행 중인 서비스와 출력의 상태입니다. []Bot Instance Service Health

Bot Instance Status Authentication#

조인 또는 갱신에 대한 정보를 담고 있습니다. 이 정보는 전적으로 Teleport Auth Service에서 가져오므로 신뢰할 수 있습니다.

예시:

authenticated_at: # See description
join_method: "string"
join_token: "string"
metadata: # See description
generation: 1
public_key: BASE64_STRING
join_attrs: # [...]
필드 이름 설명 타입
authenticated_at Teleport Auth Service가 조인 또는 갱신을 인증한 타임스탬프입니다.
generation 갱신할 때마다 이 generation 값이 증가합니다. 위임형 조인 방식에서는 갱신 중에 이 카운터를 확인하지 않습니다. token 조인 방식에서는 갱신 중에 이 카운터를 확인하며, 인증서의 카운터가 마지막 인증의 카운터와 일치하지 않으면 Bot이 잠깁니다. number
join_attrs 조인 과정에서 생성된 속성입니다. 일반적으로 조인 증명 과정 자체에서 얻은 정보입니다. 이 필드는 구조가 없는 metadata 필드를 대체할 예정입니다. Join Attrs
join_method 이번 조인 또는 갱신에 사용된 조인 방식입니다. 더 이상 사용되지 않음: join_attrs.meta.join_method 사용을 권장합니다 string
join_token 이번 조인 또는 갱신에 사용된 조인 토큰입니다. token 조인 방식의 값은 민감 정보이므로, 위임형 조인 방식에서만 채워집니다. 더 이상 사용되지 않음: join_attrs.meta.join_token_name 사용을 권장합니다 string
metadata 조인 방식에서 가져온 메타데이터입니다. 더 이상 사용되지 않음: join_attrs 사용을 권장합니다.
public_key Bot 인스턴스의 공개 키입니다. PEM으로 감싼 PKIX DER 인코딩 공개 키여야 합니다. 이를 통해 일관성을 확보하고 여러 종류의 공개 키 알고리즘을 지원합니다. base64-encoded string

Bot Instance Status Heartbeat#

Bot 인스턴스가 자체 보고한 정보를 담고 있습니다. 이 정보는 서버가 검증하지 않으므로 신뢰해서는 안 됩니다.

예시:

recorded_at: # See description
is_startup: true
version: "string"
hostname: "string"
uptime: # See description
join_method: "string"
one_shot: true
architecture: "string"
os: "string"
external_updater: "string"
external_updater_version: "string"
updater_info: # [...]
kind: # [...]
필드 이름 설명 타입
architecture tbot이 실행 중인 호스트의 아키텍처이며, runtime.GOARCH로 결정됩니다. string
external_updater 외부 업데이터 프로세스를 식별합니다. string
external_updater_version 외부 업데이터의 버전을 식별합니다. 업데이터가 구성되지 않은 경우 비어 있습니다. string
hostname tbot이 실행 중인 호스트의 호스트 이름입니다. string
is_startup tbot이 시작할 때 제출한 하트비트인지 여부를 나타냅니다. Boolean
join_method 현재 구성된 join_method입니다. string
kind 봇이 tbot 바이너리에서 실행 중인지, 다른 구성 요소에 내장되어 실행 중인지를 식별합니다. Bot Kind
one_shot tbot이 원샷 모드로 실행 중인지 여부를 나타냅니다. Boolean
os tbot이 실행 중인 호스트의 OS이며, runtime.GOOS로 결정됩니다. string
recorded_at Teleport Auth Service가 하트비트를 기록한 타임스탬프입니다. tbot이 이 필드에 제출한 값은 무시됩니다.
updater_info 업데이트 그룹과 업데이터 상태를 포함해 외부 업데이터가 제공한 정보입니다. Updater V2Info
uptime tbot이 이 하트비트를 제출한 시점까지 실행된 기간입니다.
version 이 하트비트를 제출한 tbot의 버전입니다. string

Bot Kind#

봇이 tbot 바이너리인지, 다른 구성 요소에 내장되어 있는지를 식별합니다.

Join Attrs#

조인 과정에서 생성되는 속성의 모음입니다.

예시:

meta: # [...]
gitlab: # [...]
github: # [...]
iam: # [...]
tpm: # [...]
azure: # [...]
circleci: # [...]
bitbucket: # [...]
terraform_cloud: # [...]
spacelift: # [...]
gcp: # [...]
kubernetes: # [...]
oracle: # [...]
azure_devops: # [...]
env0: # [...]
generic_oidc: # [...]
필드 이름 설명 타입
azure Azure(azure) 조인 방식에만 해당하는 속성입니다. Join Attrs Azure
azure_devops Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다. Join Attrs Azure Devops
bitbucket Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. Join Attrs Bitbucket
circleci CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. Join Attrs CircleCI
env0 Env0(env0) 조인 방식에만 해당하는 속성입니다. Join Attrs Env0
gcp GCP(gcp) 조인 방식에만 해당하는 속성입니다. Join Attrs GCP
generic_oidc 일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다. Join Attrs Generic OIDC
github GitHub(github) 조인 방식에만 해당하는 속성입니다. Join Attrs GitHub
gitlab GitLab(gitlab) 조인 방식에만 해당하는 속성입니다. Join Attrs GitLab
iam AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. Join Attrs AWS IAM
kubernetes 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다. Join Attrs Kubernetes
meta 조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다. Join Attrs Meta
oracle Oracle(oracle) 조인 방식에만 해당하는 속성입니다. Join Attrs Oracle
spacelift Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. Join Attrs Spacelift
terraform_cloud Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. Join Attrs Terraform Cloud
tpm TPM(tpm) 조인 방식에만 해당하는 속성입니다. Join Attrs TPM

Join Attrs AWS IAM#

AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인 과정에서 호출하는 STS GetCallerIdentity 호출 결과에서 그대로 가져옵니다.

예시:

account: "string"
arn: "string"
필드 이름 설명 타입
account 조인하는 엔티티가 속한 계정의 식별자입니다. 예: 123456789012 string
arn 조인하는 엔티티의 AWS ARN입니다. 예: arn:aws:sts::123456789012:assumed-role/my-role-name/my-role-session-name string

Join Attrs Azure#

Azure(azure) 조인 방식에만 해당하는 속성입니다.

예시:

subscription: "string"
resource_group: "string"
tenant: "string"
필드 이름 설명 타입
resource_group 조인하는 엔티티가 속한 Azure 계정의 리소스 그룹입니다. string
subscription 조인하는 엔티티가 속한 Azure 계정의 구독 ID입니다. string
tenant 조인하는 엔티티가 속한 Azure 계정의 테넌트 ID입니다. string

Join Attrs Azure Devops#

Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다.

예시:

pipeline: # [...]
필드 이름 설명 타입
pipeline 파이프라인 ID 토큰으로 발생하는 조인에만 해당하는 속성입니다. Join Attrs Azure Devops Pipeline

Join Attrs Azure Devops Pipeline#

인증에 파이프라인 ID 토큰을 사용하는 경우 Azure DevOps 조인 방식에만 해당하는 속성입니다.

예시:

sub: "string"
organization_name: "string"
project_name: "string"
pipeline_name: "string"
organization_id: "string"
project_id: "string"
definition_id: "string"
repository_id: "string"
repository_version: "string"
repository_ref: "string"
run_id: "string"
필드 이름 설명 타입
definition_id 실행 중인 파이프라인의 ID입니다. string
organization_id 파이프라인이 실행되는 조직의 ID입니다. string
organization_name 파이프라인이 실행되는 조직의 이름입니다. string
pipeline_name 실행 중인 파이프라인의 이름입니다. string
project_id 파이프라인이 실행되는 프로젝트의 ID입니다. string
project_name 파이프라인이 실행되는 프로젝트의 이름입니다. string
repository_id 파이프라인이 실행되는 리포지터리의 ID입니다. string
repository_ref 파이프라인이 실행 대상으로 삼는 리포지터리의 ref입니다. string
repository_version 파이프라인이 실행 대상으로 삼는 리포지터리의 버전입니다. Git의 경우 커밋 SHA입니다. string
run_id 실행 중인 런의 ID입니다. string
sub 조인에 사용된 Azure DevOps 파이프라인 ID 토큰의 sub 클레임입니다. string

Join Attrs Bitbucket#

Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. BitBucket이 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://support.atlassian.com/bitbucket-cloud/docs/integrate-pipelines-with-resource-servers-using-oidc/ 에 문서화되어 있습니다.

예시:

sub: "string"
step_uuid: "string"
repository_uuid: "string"
pipeline_uuid: "string"
workspace_uuid: "string"
deployment_environment_uuid: "string"
branch_name: "string"
필드 이름 설명 타입
branch_name 파이프라인이 실행 대상으로 삼는 브랜치의 이름입니다. string
deployment_environment_uuid 파이프라인이 실행 대상으로 삼는 배포 환경의 UUID입니다. string
pipeline_uuid 스텝이 실행되는 파이프라인의 UUID입니다. string
repository_uuid 파이프라인 스텝이 실행되는 리포지터리의 UUID입니다. string
step_uuid 파이프라인 스텝의 UUID입니다. string
sub 조인에 사용된 Bitbucket JWT의 sub 클레임입니다. string
workspace_uuid 파이프라인이 속한 워크스페이스의 UUID입니다. string

Join Attrs CircleCI#

CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. CircleCI가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://circleci.com/docs/openid-connect-tokens/ 에 문서화되어 있습니다.

예시:

sub: "string"
context_ids: 
  - "string"
  - "string"
  - "string"
project_id: "string"
필드 이름 설명 타입
context_ids 작업에서 사용된 컨텍스트의 UUID입니다. []string
project_id 작업이 실행되는 프로젝트의 UUID입니다. string
sub 조인에 사용된 CircleCI JWT의 sub 클레임입니다. 예: org/ORGANIZATION_ID/project/PROJECT_ID/user/USER_ID string

Join Attrs Env0#

Env0(env0) 조인 방식에만 해당하는 속성입니다.

예시:

sub: "string"
organization_id: "string"
project_id: "string"
project_name: "string"
template_id: "string"
template_name: "string"
environment_id: "string"
environment_name: "string"
workspace_name: "string"
deployment_log_id: "string"
deployment_type: "string"
deployer_email: "string"
env0_tag: "string"
필드 이름 설명 타입
deployer_email 배포를 트리거한 사람의 이메일이며, Env0 OIDC 토큰의 deployerEmail에 해당합니다. string
deployment_log_id 이 배포의 고유 ID이며, Env0 OIDC 토큰의 deploymentLogId에 해당합니다. string
deployment_type "deploy", "destroy" 등 env0 배포 유형입니다. Env0 OIDC 토큰의 deploymentType에 해당합니다. string
env0_tag ENV0_OIDC_TAG가 설정된 경우의 사용자 지정 태그 값이며, env0Tag에 해당합니다. string
environment_id Env0 환경의 고유 식별자이며, Env0 OIDC 토큰의 environmentId에 해당합니다. string
environment_name Env0 환경의 이름이며, Env0 OIDC 토큰의 environmentName에 해당합니다. string
organization_id 조직의 고유 식별자이며, Env0 OIDC 토큰의 organizationId에 해당합니다. string
project_id 프로젝트의 고유 식별자이며, Env0 OIDC 토큰의 projectId에 해당합니다. string
project_name 작업이 실행된 프로젝트의 이름이며, Env0 OIDC 토큰의 projectName에 해당합니다. string
sub Env0 OIDC 토큰의 sub 클레임입니다. string
template_id Env0 템플릿의 고유 식별자이며, Env0 OIDC 토큰의 templateId에 해당합니다. string
template_name Env0 템플릿의 이름이며, Env0 OIDC 토큰의 templateName에 해당합니다. string
workspace_name Env0 워크스페이스의 이름이며, Env0 OIDC 토큰의 workspaceName에 해당합니다. string

Join Attrs GCP#

GCP(gcp) 조인 방식에만 해당하는 속성입니다. JWT 인스턴스 아이덴티티 토큰의 클레임에서 가져오며, 해당 클레임은 https://cloud.google.com/compute/docs/instances/verifying-instance-identity#payload 에 문서화되어 있습니다.

예시:

service_account: "string"
gce: # [...]
필드 이름 설명 타입
gce 조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 GCE에 있지 않으면 존재하지 않을 수 있습니다. Join Attrs GCP GCE
service_account 인스턴스가 실행되는 서비스 계정의 이메일입니다. string

Join Attrs GCP GCE#

조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
zone: "string"
id: "string"
project: "string"
필드 이름 설명 타입
id 조인하는 엔티티가 실행 중인 GCE 인스턴스의 ID입니다. string
name 조인하는 엔티티가 실행 중인 GCE 인스턴스의 이름입니다. string
project 인스턴스가 실행되는 GCP 프로젝트의 프로젝트 ID입니다. string
zone 조인하는 엔티티가 실행 중인 GCE 인스턴스의 영역입니다. string

Join Attrs Generic OIDC#

일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다.

예시:

claims: # See description
필드 이름 설명 타입
claims 토큰 클레임의 전체 집합입니다.

Join Attrs GitHub#

GitHub(github) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitHub JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.github.com/en/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#understanding-the-oidc-token 에서 확인할 수 있습니다.

예시:

sub: "string"
actor: "string"
environment: "string"
ref: "string"
ref_type: "string"
repository: "string"
repository_owner: "string"
workflow: "string"
event_name: "string"
sha: "string"
run_id: "string"
enterprise: "string"
enterprise_id: "string"
필드 이름 설명 타입
actor 워크플로 실행을 시작한 액터의 사용자 이름입니다. string
enterprise 리포지터리가 속한 엔터프라이즈의 이름이며, 있는 경우에만 설정됩니다. string
enterprise_id 리포지터리가 속한 엔터프라이즈의 ID이며, 있는 경우에만 설정됩니다. string
environment 워크플로가 실행 대상으로 삼는 환경의 이름이며, 있는 경우에만 설정됩니다. string
event_name 워크플로 실행을 트리거한 이벤트의 이름입니다. string
ref 워크플로가 실행 대상으로 삼는 ref입니다. string
ref_type 워크플로가 실행 대상으로 삼는 ref의 유형입니다. 예: branch. string
repository 워크플로가 실행되는 리포지터리의 이름입니다. string
repository_owner 워크플로가 실행되는 리포지터리 소유자의 이름입니다. string
run_id 이 GitHub Actions 워크플로 실행의 ID입니다. string
sha 워크플로 실행을 트리거한 커밋의 SHA입니다. string
sub 조인에 사용된 GitHub JWT의 sub 클레임입니다. string
workflow 실행 중인 워크플로의 이름입니다. string

Join Attrs GitLab#

GitLab 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitLab JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.gitlab.com/ee/ci/secrets/id_token_authentication.html#token-payload 에서 확인할 수 있습니다.

예시:

sub: "string"
ref: "string"
ref_type: "string"
ref_protected: true
namespace_path: "string"
project_path: "string"
user_login: "string"
user_email: "string"
pipeline_id: "string"
pipeline_source: "string"
environment: "string"
environment_protected: true
runner_id: 1
runner_environment: "string"
sha: "string"
ci_config_ref_uri: "string"
ci_config_sha: "string"
필드 이름 설명 타입
ci_config_ref_uri 파이프라인을 구성하는 CI 구성의 ref URI입니다. string
ci_config_sha 파이프라인을 구성하는 CI 구성 ref의 Git SHA입니다. string
environment 파이프라인이 실행 대상으로 삼는 환경이며, 있는 경우에만 설정됩니다. string
environment_protected 파이프라인이 보호된 환경을 대상으로 실행되는지 여부입니다. 구성된 환경이 없으면 이 필드는 false입니다. Boolean
namespace_path 파이프라인이 실행되는 프로젝트의 네임스페이스 경로입니다. 예: mygroup string
pipeline_id 파이프라인의 ID입니다. string
pipeline_source 파이프라인의 소스입니다. 예: push 또는 web string
project_path 파이프라인이 실행되는 프로젝트의 정규화된 전체 경로입니다. 네임스페이스 경로를 포함합니다. 예: mygroup/my-project string
ref 파이프라인이 실행 대상으로 삼는 ref입니다. 예: main string
ref_protected 파이프라인이 실행 대상으로 삼는 ref가 보호되어 있는지 여부입니다. Boolean
ref_type 파이프라인이 실행 대상으로 삼는 ref의 유형입니다. 일반적으로 branch 또는 tag입니다. string
runner_environment 파이프라인을 처리하는 러너의 유형입니다. gitlab-hosted 또는 self-hosted 중 하나입니다. string
runner_id 이 파이프라인이 실행되는 러너의 ID입니다. number
sha 파이프라인 실행을 트리거한 커밋의 SHA입니다. string
sub 조인에 사용된 GitLab JWT의 sub 클레임입니다. 예: project_path:mygroup/my-project:ref_type:branch:ref:main string
user_email 파이프라인 실행을 트리거한 사용자의 이메일입니다. string
user_login 파이프라인 실행을 트리거한 사용자의 이름입니다. string

Join Attrs Kubernetes#

쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

subject: "string"
service_account: # [...]
pod: # [...]
필드 이름 설명 타입
pod 조인하는 엔티티가 Pod에 바인딩된 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 서비스 계정이고 토큰이 Pod에 바인딩된 경우에만 존재합니다. Join Attrs Kubernetes Pod
service_account 조인하는 엔티티가 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 (사람 사용자 등이 아닌) 서비스 계정인 경우에만 존재합니다. Join Attrs Kubernetes Service Account
subject 쿠버네티스 토큰을 기준으로 한 엔티티의 정규화된 식별자입니다. 서비스 계정의 경우 system:serviceaccount:\<namespace\>:\<service-account-name\> 형식입니다. string

Join Attrs Kubernetes Pod#

Pod에 바인딩된 서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
필드 이름 설명 타입
name 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. string

Join Attrs Kubernetes Service Account#

서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
namespace: "string"
필드 이름 설명 타입
name 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. string
namespace 조인하는 엔티티가 실행되는 서비스 계정의 네임스페이스입니다. string

Join Attrs Meta#

조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다.

예시:

join_token_name: "string"
join_method: "string"
필드 이름 설명 타입
join_method 조인에 사용된 조인 방식의 이름입니다. 예: gitlab string
join_token_name 조인에 사용된 조인 토큰의 이름입니다. 조인에 사용된 조인 토큰이 token 방식이면 조인 토큰의 이름이 민감 정보이므로 이 필드는 생략됩니다. 예: my-gitlab-join-token string

Join Attrs Oracle#

Oracle(oracle) 조인 방식에만 해당하는 속성입니다.

예시:

tenancy_id: "string"
compartment_id: "string"
instance_id: "string"
필드 이름 설명 타입
compartment_id 인스턴스가 속한 컴파트먼트의 ID입니다. string
instance_id 인스턴스의 ID입니다. string
tenancy_id 인스턴스가 속한 테넌트의 ID입니다. string

Join Attrs Spacelift#

Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. Spacelift가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://docs.spacelift.io/integrations/cloud-providers/oidc/#standard-claims 에 문서화되어 있습니다.

예시:

sub: "string"
space_id: "string"
caller_type: "string"
caller_id: "string"
run_type: "string"
run_id: "string"
scope: "string"
필드 이름 설명 타입
caller_id 런을 생성한 호출자의 ID입니다. string
caller_type 런을 소유한 호출자의 유형이며, stack 또는 module 중 하나입니다. string
run_id 런의 ID입니다. string
run_type 런의 유형이며, PROPOSED, TRACKED, TASK, TESTING, DESTROY 중 하나입니다. string
scope 토큰에 구성된 범위이며, read 또는 write 중 하나입니다. string
space_id 런이 실행되는 스페이스의 ID입니다. string
sub 조인에 사용된 Spacelift JWT의 sub 클레임입니다. string

Join Attrs TPM#

TPM(tpm) 조인 방식에만 해당하는 속성입니다.

예시:

ek_pub_hash: "string"
ek_cert_serial: "string"
ek_cert_verified: true
필드 이름 설명 타입
ek_cert_serial EK 인증서의 일련번호이며, 있는 경우에만 설정됩니다. string
ek_cert_verified EK 인증서가 인증 기관을 기준으로 검증되었는지 여부입니다. Boolean
ek_pub_hash PKIX 형식 EK 공개 키의 SHA256 해시를 16진수로 인코딩한 값입니다. 사실상 특정 TPM을 식별합니다. string

Join Attrs Terraform Cloud#

Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. Terraform Cloud가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://developer.hashicorp.com/terraform/enterprise/workspaces/dynamic-provider-credentials/workload-identity-tokens 에 문서화되어 있습니다.

예시:

sub: "string"
organization_name: "string"
project_name: "string"
workspace_name: "string"
full_workspace: "string"
run_id: "string"
run_phase: "string"
필드 이름 설명 타입
full_workspace 조직과 프로젝트 이름을 포함한 정규화된 워크스페이스 경로입니다. 예: organization:\<name\>:project:\<name\>:workspace:\<name\> string
organization_name 프로젝트와 워크스페이스가 속한 조직의 이름입니다. string
project_name 워크스페이스가 속한 프로젝트의 이름입니다. string
run_id 실행 중인 런의 ID입니다. string
run_phase 실행 중인 런의 단계이며, plan 또는 apply 중 하나입니다. string
sub 조인에 사용된 Terraform Cloud JWT의 sub 클레임입니다. string
workspace_name plan/apply가 실행되는 워크스페이스의 이름입니다. string

Metadata#

리소스 메타데이터입니다.

예시:

name: "string"
namespace: "string"
description: "string"
labels: 
  "string": "string"
  "string": "string"
  "string": "string"
expires: # See description
revision: "string"
필드 이름 설명 타입
description 객체에 대한 설명입니다. string
expires 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.
labels 라벨의 집합입니다. map[string]string
name 객체의 이름입니다. string
namespace 객체의 네임스페이스입니다. 이 필드는 Teleport 2.4에서 반환될 때 "namespace"라는 이름이어야 합니다. string
revision 시간에 따른 리소스 버전을 추적하는 불투명 식별자입니다. 클라이언트는 이 값을 무시하고 변경해서는 안 되며, 리소스를 업데이트할 때는 반드시 이 리비전을 그대로 반환해야 합니다. string

Updater Status#

에이전트가 판단한 자동 업데이트 상태를 나타냅니다. 1: 업데이터 상태가 정상입니다. 2: 자동 업데이트가 비활성화되었거나 일시 중지된 것으로 보입니다. 3: 특정 버전이 고정되어 있습니다. 4: 에이전트가 업데이트 상태를 읽지 못했습니다.

Updater V2Info#

Teleport 업데이터의 동작 상태에 대한 정보를 Teleport에 전달하는 데 사용됩니다.

예시:

UpdateGroup: "string"
UpdateUUID: BASE64_STRING
UpdaterStatus: # [...]
필드 이름 설명 타입
UpdateGroup 에이전트의 업데이터가 속한 업데이트 그룹입니다. autoupdate_agent_rollout 리소스가 그룹별 업데이트 시점을 제어합니다. Hello에 업데이트 그룹을 보고하면 그룹별 업데이트 진행 상황을 추적할 수 있습니다. 자세한 내용은 RFD 184를 참고하십시오. string
UpdateUUID 에이전트 업데이터의 UUID입니다. 각 업데이터는 UUID를 가지며, 다음 두 경우에 사용할 수 있습니다. - 카나리 업데이트 시 개별 에이전트를 업데이트하는 경우 - 점진적 롤아웃 시 교착 상태를 피하기 위해 업데이트되지 않은 가장 낮은 버전의 에이전트를 추적하는 경우 base64-encoded string
UpdaterStatus Teleport 클러스터가 알아야 하는 업데이터 관련 상태 정보를 나타냅니다. 예를 들어 업데이터가 비활성화되었거나, 버전이 고정되었거나, 업데이터가 실행 중이 아닌 것으로 보이는 경우입니다. Updater Status

Bot Instance 참조

Teleport v18.11
원문 보기

요약

Kind: bot_instance Version: v1 bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다. tbot 서비스의 상태 정상 여부를 설명합니다.

Kind: bot_instance
Version: v1

bot_instance 리소스는 Teleport 클러스터에 등록된 Machine ID 봇의 내부 상태를 추적합니다. tctl로 bot_instance 리소스를 조회하고 목록으로 확인할 수는 있지만, 생성·수정·삭제할 수는 없습니다.

최상위 필드#

예시:

kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
status: # [...]
scope: "string"
필드 이름 설명 타입
kind 표현되는 리소스의 종류입니다. string
metadata 모든 리소스가 공통으로 가지는 메타데이터입니다. Metadata
scope BotInstance의 범위입니다. 이 인스턴스와 연결된 Bot의 범위를 기준으로 결정되며, BotInstance 리소스에 대한 범위 지정 RBAC에 사용될 수 있습니다. string
spec BotInstance에 구성된 속성입니다. Bot Instance Spec
status 작업 결과로 서버가 설정하는 필드입니다. 사용자가 수정해서는 안 됩니다. Bot Instance Status
sub_kind 같은 종류 내의 변형을 구분합니다. 값이 채워지지 않더라도 모든 리소스는 이 필드를 가져야 합니다. string
version 표현되는 리소스의 버전입니다. string

Bot Instance Health Status#

tbot 서비스의 상태 정상 여부를 설명합니다.

Bot Instance Service Health#

tbot 서비스 상태의 스냅샷입니다.

예시:

service: # [...]
status: # [...]
reason: "string"
updated_at: # See description
필드 이름 설명 타입
reason 서비스 상태에 대한 사람이 읽을 수 있는 설명입니다. 오류 메시지가 포함될 수 있습니다. string
service 서비스를 식별합니다. Bot Instance Service Identifier
status 서비스의 상태 정상 여부를 설명합니다. Bot Instance Health Status
updated_at 서비스 상태가 마지막으로 변경된 시각입니다.

Bot Instance Service Identifier#

tbot 서비스를 고유하게 식별합니다.

예시:

type: "string"
name: "string"
필드 이름 설명 타입
name 서비스의 이름으로, 사용자가 지정하거나 자동으로 생성됩니다. string
type 서비스의 유형입니다(예: database-tunnel, ssh-multiplexer). string

Bot Instance Spec#

다음 필드를 포함합니다.

예시:

bot_name: "string"
instance_id: "string"
previous_instance_id: "string"
필드 이름 설명 타입
bot_name 이 인스턴스와 연결된 봇의 이름입니다. string
instance_id 이 인스턴스의 고유 식별자입니다. string
previous_instance_id 이전 인스턴스 ID이며, 있는 경우에만 설정됩니다. 이전 아이덴티티가 만료된 후 봇이 다시 인증할 때 설정됩니다. 현재는 bound-keypair 재조인 중에만 설정됩니다. string

Bot Instance Status#

BotInstance의 상태를 담고 있습니다.

예시:

initial_authentication: # [...]
latest_authentications: 
  - # [...]
  - # [...]
  - # [...]
initial_heartbeat: # [...]
latest_heartbeats: 
  - # [...]
  - # [...]
  - # [...]
service_health: 
  - # [...]
  - # [...]
  - # [...]
필드 이름 설명 타입
initial_authentication 이 봇 인스턴스의 최초 인증 상태입니다. Bot Instance Status Authentication
initial_heartbeat 이 봇 인스턴스의 최초 하트비트 상태입니다. Bot Instance Status Heartbeat
latest_authentications 이 봇 인스턴스의 최근 N개 인증 상태 레코드입니다. []Bot Instance Status Authentication
latest_heartbeats 이 봇 인스턴스의 최근 N개 하트비트입니다. []Bot Instance Status Heartbeat
service_health tbot이 실행 중인 서비스와 출력의 상태입니다. []Bot Instance Service Health

Bot Instance Status Authentication#

조인 또는 갱신에 대한 정보를 담고 있습니다. 이 정보는 전적으로 Teleport Auth Service에서 가져오므로 신뢰할 수 있습니다.

예시:

authenticated_at: # See description
join_method: "string"
join_token: "string"
metadata: # See description
generation: 1
public_key: BASE64_STRING
join_attrs: # [...]
필드 이름 설명 타입
authenticated_at Teleport Auth Service가 조인 또는 갱신을 인증한 타임스탬프입니다.
generation 갱신할 때마다 이 generation 값이 증가합니다. 위임형 조인 방식에서는 갱신 중에 이 카운터를 확인하지 않습니다. token 조인 방식에서는 갱신 중에 이 카운터를 확인하며, 인증서의 카운터가 마지막 인증의 카운터와 일치하지 않으면 Bot이 잠깁니다. number
join_attrs 조인 과정에서 생성된 속성입니다. 일반적으로 조인 증명 과정 자체에서 얻은 정보입니다. 이 필드는 구조가 없는 metadata 필드를 대체할 예정입니다. Join Attrs
join_method 이번 조인 또는 갱신에 사용된 조인 방식입니다. 더 이상 사용되지 않음: join_attrs.meta.join_method 사용을 권장합니다 string
join_token 이번 조인 또는 갱신에 사용된 조인 토큰입니다. token 조인 방식의 값은 민감 정보이므로, 위임형 조인 방식에서만 채워집니다. 더 이상 사용되지 않음: join_attrs.meta.join_token_name 사용을 권장합니다 string
metadata 조인 방식에서 가져온 메타데이터입니다. 더 이상 사용되지 않음: join_attrs 사용을 권장합니다.
public_key Bot 인스턴스의 공개 키입니다. PEM으로 감싼 PKIX DER 인코딩 공개 키여야 합니다. 이를 통해 일관성을 확보하고 여러 종류의 공개 키 알고리즘을 지원합니다. base64-encoded string

Bot Instance Status Heartbeat#

Bot 인스턴스가 자체 보고한 정보를 담고 있습니다. 이 정보는 서버가 검증하지 않으므로 신뢰해서는 안 됩니다.

예시:

recorded_at: # See description
is_startup: true
version: "string"
hostname: "string"
uptime: # See description
join_method: "string"
one_shot: true
architecture: "string"
os: "string"
external_updater: "string"
external_updater_version: "string"
updater_info: # [...]
kind: # [...]
필드 이름 설명 타입
architecture tbot이 실행 중인 호스트의 아키텍처이며, runtime.GOARCH로 결정됩니다. string
external_updater 외부 업데이터 프로세스를 식별합니다. string
external_updater_version 외부 업데이터의 버전을 식별합니다. 업데이터가 구성되지 않은 경우 비어 있습니다. string
hostname tbot이 실행 중인 호스트의 호스트 이름입니다. string
is_startup tbot이 시작할 때 제출한 하트비트인지 여부를 나타냅니다. Boolean
join_method 현재 구성된 join_method입니다. string
kind 봇이 tbot 바이너리에서 실행 중인지, 다른 구성 요소에 내장되어 실행 중인지를 식별합니다. Bot Kind
one_shot tbot이 원샷 모드로 실행 중인지 여부를 나타냅니다. Boolean
os tbot이 실행 중인 호스트의 OS이며, runtime.GOOS로 결정됩니다. string
recorded_at Teleport Auth Service가 하트비트를 기록한 타임스탬프입니다. tbot이 이 필드에 제출한 값은 무시됩니다.
updater_info 업데이트 그룹과 업데이터 상태를 포함해 외부 업데이터가 제공한 정보입니다. Updater V2Info
uptime tbot이 이 하트비트를 제출한 시점까지 실행된 기간입니다.
version 이 하트비트를 제출한 tbot의 버전입니다. string

Bot Kind#

봇이 tbot 바이너리인지, 다른 구성 요소에 내장되어 있는지를 식별합니다.

Join Attrs#

조인 과정에서 생성되는 속성의 모음입니다.

예시:

meta: # [...]
gitlab: # [...]
github: # [...]
iam: # [...]
tpm: # [...]
azure: # [...]
circleci: # [...]
bitbucket: # [...]
terraform_cloud: # [...]
spacelift: # [...]
gcp: # [...]
kubernetes: # [...]
oracle: # [...]
azure_devops: # [...]
env0: # [...]
generic_oidc: # [...]
필드 이름 설명 타입
azure Azure(azure) 조인 방식에만 해당하는 속성입니다. Join Attrs Azure
azure_devops Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다. Join Attrs Azure Devops
bitbucket Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. Join Attrs Bitbucket
circleci CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. Join Attrs CircleCI
env0 Env0(env0) 조인 방식에만 해당하는 속성입니다. Join Attrs Env0
gcp GCP(gcp) 조인 방식에만 해당하는 속성입니다. Join Attrs GCP
generic_oidc 일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다. Join Attrs Generic OIDC
github GitHub(github) 조인 방식에만 해당하는 속성입니다. Join Attrs GitHub
gitlab GitLab(gitlab) 조인 방식에만 해당하는 속성입니다. Join Attrs GitLab
iam AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. Join Attrs AWS IAM
kubernetes 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다. Join Attrs Kubernetes
meta 조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다. Join Attrs Meta
oracle Oracle(oracle) 조인 방식에만 해당하는 속성입니다. Join Attrs Oracle
spacelift Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. Join Attrs Spacelift
terraform_cloud Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. Join Attrs Terraform Cloud
tpm TPM(tpm) 조인 방식에만 해당하는 속성입니다. Join Attrs TPM

Join Attrs AWS IAM#

AWS IAM(iam) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인 과정에서 호출하는 STS GetCallerIdentity 호출 결과에서 그대로 가져옵니다.

예시:

account: "string"
arn: "string"
필드 이름 설명 타입
account 조인하는 엔티티가 속한 계정의 식별자입니다. 예: 123456789012 string
arn 조인하는 엔티티의 AWS ARN입니다. 예: arn:aws:sts::123456789012:assumed-role/my-role-name/my-role-session-name string

Join Attrs Azure#

Azure(azure) 조인 방식에만 해당하는 속성입니다.

예시:

subscription: "string"
resource_group: "string"
tenant: "string"
필드 이름 설명 타입
resource_group 조인하는 엔티티가 속한 Azure 계정의 리소스 그룹입니다. string
subscription 조인하는 엔티티가 속한 Azure 계정의 구독 ID입니다. string
tenant 조인하는 엔티티가 속한 Azure 계정의 테넌트 ID입니다. string

Join Attrs Azure Devops#

Azure Devops(azure_devops) 조인 방식에만 해당하는 속성입니다.

예시:

pipeline: # [...]
필드 이름 설명 타입
pipeline 파이프라인 ID 토큰으로 발생하는 조인에만 해당하는 속성입니다. Join Attrs Azure Devops Pipeline

Join Attrs Azure Devops Pipeline#

인증에 파이프라인 ID 토큰을 사용하는 경우 Azure DevOps 조인 방식에만 해당하는 속성입니다.

예시:

sub: "string"
organization_name: "string"
project_name: "string"
pipeline_name: "string"
organization_id: "string"
project_id: "string"
definition_id: "string"
repository_id: "string"
repository_version: "string"
repository_ref: "string"
run_id: "string"
필드 이름 설명 타입
definition_id 실행 중인 파이프라인의 ID입니다. string
organization_id 파이프라인이 실행되는 조직의 ID입니다. string
organization_name 파이프라인이 실행되는 조직의 이름입니다. string
pipeline_name 실행 중인 파이프라인의 이름입니다. string
project_id 파이프라인이 실행되는 프로젝트의 ID입니다. string
project_name 파이프라인이 실행되는 프로젝트의 이름입니다. string
repository_id 파이프라인이 실행되는 리포지터리의 ID입니다. string
repository_ref 파이프라인이 실행 대상으로 삼는 리포지터리의 ref입니다. string
repository_version 파이프라인이 실행 대상으로 삼는 리포지터리의 버전입니다. Git의 경우 커밋 SHA입니다. string
run_id 실행 중인 런의 ID입니다. string
sub 조인에 사용된 Azure DevOps 파이프라인 ID 토큰의 sub 클레임입니다. string

Join Attrs Bitbucket#

Bitbucket(bitbucket) 조인 방식에만 해당하는 속성입니다. BitBucket이 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://support.atlassian.com/bitbucket-cloud/docs/integrate-pipelines-with-resource-servers-using-oidc/ 에 문서화되어 있습니다.

예시:

sub: "string"
step_uuid: "string"
repository_uuid: "string"
pipeline_uuid: "string"
workspace_uuid: "string"
deployment_environment_uuid: "string"
branch_name: "string"
필드 이름 설명 타입
branch_name 파이프라인이 실행 대상으로 삼는 브랜치의 이름입니다. string
deployment_environment_uuid 파이프라인이 실행 대상으로 삼는 배포 환경의 UUID입니다. string
pipeline_uuid 스텝이 실행되는 파이프라인의 UUID입니다. string
repository_uuid 파이프라인 스텝이 실행되는 리포지터리의 UUID입니다. string
step_uuid 파이프라인 스텝의 UUID입니다. string
sub 조인에 사용된 Bitbucket JWT의 sub 클레임입니다. string
workspace_uuid 파이프라인이 속한 워크스페이스의 UUID입니다. string

Join Attrs CircleCI#

CircleCI(circleci) 조인 방식에만 해당하는 속성입니다. CircleCI가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://circleci.com/docs/openid-connect-tokens/ 에 문서화되어 있습니다.

예시:

sub: "string"
context_ids: 
  - "string"
  - "string"
  - "string"
project_id: "string"
필드 이름 설명 타입
context_ids 작업에서 사용된 컨텍스트의 UUID입니다. []string
project_id 작업이 실행되는 프로젝트의 UUID입니다. string
sub 조인에 사용된 CircleCI JWT의 sub 클레임입니다. 예: org/ORGANIZATION_ID/project/PROJECT_ID/user/USER_ID string

Join Attrs Env0#

Env0(env0) 조인 방식에만 해당하는 속성입니다.

예시:

sub: "string"
organization_id: "string"
project_id: "string"
project_name: "string"
template_id: "string"
template_name: "string"
environment_id: "string"
environment_name: "string"
workspace_name: "string"
deployment_log_id: "string"
deployment_type: "string"
deployer_email: "string"
env0_tag: "string"
필드 이름 설명 타입
deployer_email 배포를 트리거한 사람의 이메일이며, Env0 OIDC 토큰의 deployerEmail에 해당합니다. string
deployment_log_id 이 배포의 고유 ID이며, Env0 OIDC 토큰의 deploymentLogId에 해당합니다. string
deployment_type "deploy", "destroy" 등 env0 배포 유형입니다. Env0 OIDC 토큰의 deploymentType에 해당합니다. string
env0_tag ENV0_OIDC_TAG가 설정된 경우의 사용자 지정 태그 값이며, env0Tag에 해당합니다. string
environment_id Env0 환경의 고유 식별자이며, Env0 OIDC 토큰의 environmentId에 해당합니다. string
environment_name Env0 환경의 이름이며, Env0 OIDC 토큰의 environmentName에 해당합니다. string
organization_id 조직의 고유 식별자이며, Env0 OIDC 토큰의 organizationId에 해당합니다. string
project_id 프로젝트의 고유 식별자이며, Env0 OIDC 토큰의 projectId에 해당합니다. string
project_name 작업이 실행된 프로젝트의 이름이며, Env0 OIDC 토큰의 projectName에 해당합니다. string
sub Env0 OIDC 토큰의 sub 클레임입니다. string
template_id Env0 템플릿의 고유 식별자이며, Env0 OIDC 토큰의 templateId에 해당합니다. string
template_name Env0 템플릿의 이름이며, Env0 OIDC 토큰의 templateName에 해당합니다. string
workspace_name Env0 워크스페이스의 이름이며, Env0 OIDC 토큰의 workspaceName에 해당합니다. string

Join Attrs GCP#

GCP(gcp) 조인 방식에만 해당하는 속성입니다. JWT 인스턴스 아이덴티티 토큰의 클레임에서 가져오며, 해당 클레임은 https://cloud.google.com/compute/docs/instances/verifying-instance-identity#payload 에 문서화되어 있습니다.

예시:

service_account: "string"
gce: # [...]
필드 이름 설명 타입
gce 조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 GCE에 있지 않으면 존재하지 않을 수 있습니다. Join Attrs GCP GCE
service_account 인스턴스가 실행되는 서비스 계정의 이메일입니다. string

Join Attrs GCP GCE#

조인하는 엔티티가 GCE 인스턴스에 있는 경우 GCP 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
zone: "string"
id: "string"
project: "string"
필드 이름 설명 타입
id 조인하는 엔티티가 실행 중인 GCE 인스턴스의 ID입니다. string
name 조인하는 엔티티가 실행 중인 GCE 인스턴스의 이름입니다. string
project 인스턴스가 실행되는 GCP 프로젝트의 프로젝트 ID입니다. string
zone 조인하는 엔티티가 실행 중인 GCE 인스턴스의 영역입니다. string

Join Attrs Generic OIDC#

일반 OIDC(generic_oidc) 조인 방식에만 해당하는 속성입니다.

예시:

claims: # See description
필드 이름 설명 타입
claims 토큰 클레임의 전체 집합입니다.

Join Attrs GitHub#

GitHub(github) 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitHub JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.github.com/en/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#understanding-the-oidc-token 에서 확인할 수 있습니다.

예시:

sub: "string"
actor: "string"
environment: "string"
ref: "string"
ref_type: "string"
repository: "string"
repository_owner: "string"
workflow: "string"
event_name: "string"
sha: "string"
run_id: "string"
enterprise: "string"
enterprise_id: "string"
필드 이름 설명 타입
actor 워크플로 실행을 시작한 액터의 사용자 이름입니다. string
enterprise 리포지터리가 속한 엔터프라이즈의 이름이며, 있는 경우에만 설정됩니다. string
enterprise_id 리포지터리가 속한 엔터프라이즈의 ID이며, 있는 경우에만 설정됩니다. string
environment 워크플로가 실행 대상으로 삼는 환경의 이름이며, 있는 경우에만 설정됩니다. string
event_name 워크플로 실행을 트리거한 이벤트의 이름입니다. string
ref 워크플로가 실행 대상으로 삼는 ref입니다. string
ref_type 워크플로가 실행 대상으로 삼는 ref의 유형입니다. 예: branch. string
repository 워크플로가 실행되는 리포지터리의 이름입니다. string
repository_owner 워크플로가 실행되는 리포지터리 소유자의 이름입니다. string
run_id 이 GitHub Actions 워크플로 실행의 ID입니다. string
sha 워크플로 실행을 트리거한 커밋의 SHA입니다. string
sub 조인에 사용된 GitHub JWT의 sub 클레임입니다. string
workflow 실행 중인 워크플로의 이름입니다. string

Join Attrs GitLab#

GitLab 조인 방식에만 해당하는 속성입니다. 일반적으로 조인에 사용된 GitLab JWT의 클레임에서 그대로 가져옵니다. 해당 클레임에 대한 문서는 https://docs.gitlab.com/ee/ci/secrets/id_token_authentication.html#token-payload 에서 확인할 수 있습니다.

예시:

sub: "string"
ref: "string"
ref_type: "string"
ref_protected: true
namespace_path: "string"
project_path: "string"
user_login: "string"
user_email: "string"
pipeline_id: "string"
pipeline_source: "string"
environment: "string"
environment_protected: true
runner_id: 1
runner_environment: "string"
sha: "string"
ci_config_ref_uri: "string"
ci_config_sha: "string"
필드 이름 설명 타입
ci_config_ref_uri 파이프라인을 구성하는 CI 구성의 ref URI입니다. string
ci_config_sha 파이프라인을 구성하는 CI 구성 ref의 Git SHA입니다. string
environment 파이프라인이 실행 대상으로 삼는 환경이며, 있는 경우에만 설정됩니다. string
environment_protected 파이프라인이 보호된 환경을 대상으로 실행되는지 여부입니다. 구성된 환경이 없으면 이 필드는 false입니다. Boolean
namespace_path 파이프라인이 실행되는 프로젝트의 네임스페이스 경로입니다. 예: mygroup string
pipeline_id 파이프라인의 ID입니다. string
pipeline_source 파이프라인의 소스입니다. 예: push 또는 web string
project_path 파이프라인이 실행되는 프로젝트의 정규화된 전체 경로입니다. 네임스페이스 경로를 포함합니다. 예: mygroup/my-project string
ref 파이프라인이 실행 대상으로 삼는 ref입니다. 예: main string
ref_protected 파이프라인이 실행 대상으로 삼는 ref가 보호되어 있는지 여부입니다. Boolean
ref_type 파이프라인이 실행 대상으로 삼는 ref의 유형입니다. 일반적으로 branch 또는 tag입니다. string
runner_environment 파이프라인을 처리하는 러너의 유형입니다. gitlab-hosted 또는 self-hosted 중 하나입니다. string
runner_id 이 파이프라인이 실행되는 러너의 ID입니다. number
sha 파이프라인 실행을 트리거한 커밋의 SHA입니다. string
sub 조인에 사용된 GitLab JWT의 sub 클레임입니다. 예: project_path:mygroup/my-project:ref_type:branch:ref:main string
user_email 파이프라인 실행을 트리거한 사용자의 이메일입니다. string
user_login 파이프라인 실행을 트리거한 사용자의 이름입니다. string

Join Attrs Kubernetes#

쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

subject: "string"
service_account: # [...]
pod: # [...]
필드 이름 설명 타입
pod 조인하는 엔티티가 Pod에 바인딩된 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 서비스 계정이고 토큰이 Pod에 바인딩된 경우에만 존재합니다. Join Attrs Kubernetes Pod
service_account 조인하는 엔티티가 서비스 계정 토큰인 경우 쿠버네티스 조인 방식에만 해당하는 속성입니다. 조인하는 엔티티가 (사람 사용자 등이 아닌) 서비스 계정인 경우에만 존재합니다. Join Attrs Kubernetes Service Account
subject 쿠버네티스 토큰을 기준으로 한 엔티티의 정규화된 식별자입니다. 서비스 계정의 경우 system:serviceaccount:\<namespace\>:\<service-account-name\> 형식입니다. string

Join Attrs Kubernetes Pod#

Pod에 바인딩된 서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
필드 이름 설명 타입
name 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. string

Join Attrs Kubernetes Service Account#

서비스 계정 토큰을 사용하는 경우 쿠버네티스(kubernetes) 조인 방식에만 해당하는 속성입니다.

예시:

name: "string"
namespace: "string"
필드 이름 설명 타입
name 조인하는 엔티티가 실행되는 서비스 계정의 이름입니다. string
namespace 조인하는 엔티티가 실행되는 서비스 계정의 네임스페이스입니다. string

Join Attrs Meta#

조인 과정에서 생성되지만 특정 조인 방식에 한정되지 않는 속성의 모음입니다.

예시:

join_token_name: "string"
join_method: "string"
필드 이름 설명 타입
join_method 조인에 사용된 조인 방식의 이름입니다. 예: gitlab string
join_token_name 조인에 사용된 조인 토큰의 이름입니다. 조인에 사용된 조인 토큰이 token 방식이면 조인 토큰의 이름이 민감 정보이므로 이 필드는 생략됩니다. 예: my-gitlab-join-token string

Join Attrs Oracle#

Oracle(oracle) 조인 방식에만 해당하는 속성입니다.

예시:

tenancy_id: "string"
compartment_id: "string"
instance_id: "string"
필드 이름 설명 타입
compartment_id 인스턴스가 속한 컴파트먼트의 ID입니다. string
instance_id 인스턴스의 ID입니다. string
tenancy_id 인스턴스가 속한 테넌트의 ID입니다. string

Join Attrs Spacelift#

Spacelift(spacelift) 조인 방식에만 해당하는 속성입니다. Spacelift가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://docs.spacelift.io/integrations/cloud-providers/oidc/#standard-claims 에 문서화되어 있습니다.

예시:

sub: "string"
space_id: "string"
caller_type: "string"
caller_id: "string"
run_type: "string"
run_id: "string"
scope: "string"
필드 이름 설명 타입
caller_id 런을 생성한 호출자의 ID입니다. string
caller_type 런을 소유한 호출자의 유형이며, stack 또는 module 중 하나입니다. string
run_id 런의 ID입니다. string
run_type 런의 유형이며, PROPOSED, TRACKED, TASK, TESTING, DESTROY 중 하나입니다. string
scope 토큰에 구성된 범위이며, read 또는 write 중 하나입니다. string
space_id 런이 실행되는 스페이스의 ID입니다. string
sub 조인에 사용된 Spacelift JWT의 sub 클레임입니다. string

Join Attrs TPM#

TPM(tpm) 조인 방식에만 해당하는 속성입니다.

예시:

ek_pub_hash: "string"
ek_cert_serial: "string"
ek_cert_verified: true
필드 이름 설명 타입
ek_cert_serial EK 인증서의 일련번호이며, 있는 경우에만 설정됩니다. string
ek_cert_verified EK 인증서가 인증 기관을 기준으로 검증되었는지 여부입니다. Boolean
ek_pub_hash PKIX 형식 EK 공개 키의 SHA256 해시를 16진수로 인코딩한 값입니다. 사실상 특정 TPM을 식별합니다. string

Join Attrs Terraform Cloud#

Terraform Cloud(terraform_cloud) 조인 방식에만 해당하는 속성입니다. Terraform Cloud가 런에 발급하는 JWT의 클레임에서 가져오며, 해당 클레임은 https://developer.hashicorp.com/terraform/enterprise/workspaces/dynamic-provider-credentials/workload-identity-tokens 에 문서화되어 있습니다.

예시:

sub: "string"
organization_name: "string"
project_name: "string"
workspace_name: "string"
full_workspace: "string"
run_id: "string"
run_phase: "string"
필드 이름 설명 타입
full_workspace 조직과 프로젝트 이름을 포함한 정규화된 워크스페이스 경로입니다. 예: organization:\<name\>:project:\<name\>:workspace:\<name\> string
organization_name 프로젝트와 워크스페이스가 속한 조직의 이름입니다. string
project_name 워크스페이스가 속한 프로젝트의 이름입니다. string
run_id 실행 중인 런의 ID입니다. string
run_phase 실행 중인 런의 단계이며, plan 또는 apply 중 하나입니다. string
sub 조인에 사용된 Terraform Cloud JWT의 sub 클레임입니다. string
workspace_name plan/apply가 실행되는 워크스페이스의 이름입니다. string

Metadata#

리소스 메타데이터입니다.

예시:

name: "string"
namespace: "string"
description: "string"
labels: 
  "string": "string"
  "string": "string"
  "string": "string"
expires: # See description
revision: "string"
필드 이름 설명 타입
description 객체에 대한 설명입니다. string
expires 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.
labels 라벨의 집합입니다. map[string]string
name 객체의 이름입니다. string
namespace 객체의 네임스페이스입니다. 이 필드는 Teleport 2.4에서 반환될 때 "namespace"라는 이름이어야 합니다. string
revision 시간에 따른 리소스 버전을 추적하는 불투명 식별자입니다. 클라이언트는 이 값을 무시하고 변경해서는 안 되며, 리소스를 업데이트할 때는 반드시 이 리비전을 그대로 반환해야 합니다. string

Updater Status#

에이전트가 판단한 자동 업데이트 상태를 나타냅니다. 1: 업데이터 상태가 정상입니다. 2: 자동 업데이트가 비활성화되었거나 일시 중지된 것으로 보입니다. 3: 특정 버전이 고정되어 있습니다. 4: 에이전트가 업데이트 상태를 읽지 못했습니다.

Updater V2Info#

Teleport 업데이터의 동작 상태에 대한 정보를 Teleport에 전달하는 데 사용됩니다.

예시:

UpdateGroup: "string"
UpdateUUID: BASE64_STRING
UpdaterStatus: # [...]
필드 이름 설명 타입
UpdateGroup 에이전트의 업데이터가 속한 업데이트 그룹입니다. autoupdate_agent_rollout 리소스가 그룹별 업데이트 시점을 제어합니다. Hello에 업데이트 그룹을 보고하면 그룹별 업데이트 진행 상황을 추적할 수 있습니다. 자세한 내용은 RFD 184를 참고하십시오. string
UpdateUUID 에이전트 업데이터의 UUID입니다. 각 업데이터는 UUID를 가지며, 다음 두 경우에 사용할 수 있습니다. - 카나리 업데이트 시 개별 에이전트를 업데이트하는 경우 - 점진적 롤아웃 시 교착 상태를 피하기 위해 업데이트되지 않은 가장 낮은 버전의 에이전트를 추적하는 경우 base64-encoded string
UpdaterStatus Teleport 클러스터가 알아야 하는 업데이터 관련 상태 정보를 나타냅니다. 예를 들어 업데이터가 비활성화되었거나, 버전이 고정되었거나, 업데이터가 실행 중이 아닌 것으로 보이는 경우입니다. Updater Status