teleport 참조

요약

이 가이드는 teleport의 커맨드, 인수 및 플래그에 대한 종합적인 목록을 제공합니다. teleport는 Teleport Infrastructure Identity Platform을 지원하는 CLI 도구로, 커맨드 라인을 통해 Teleport 서비스를 관리할 수 있게 해줍니다.

이 가이드는 teleport의 커맨드, 인수 및 플래그에 대한 종합적인 목록을 제공합니다.

teleport는 Teleport Infrastructure Identity Platform을 지원하는 CLI 도구로, 커맨드 라인을 통해 Teleport 서비스를 관리할 수 있게 해줍니다.

$ teleport <command> [<args> ...]

teleport app start#

애플리케이션 프록시 서비스를 시작합니다.

사용법:

$ teleport app start [<flags>]

플래그:

플래그	기본값	설명
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025].
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml].
`--cloud`	없음	애플리케이션이 특정 클라우드 API를 프록시해야 하는 경우 [AWS Azure GCP] 중 하나로 설정.
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--name`	없음	시작할 애플리케이션 이름.
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]mcp-demo-server`	`false`	현재 사용자 및 세션 정보를 표시하는 Teleport 데모 MCP 서버를 활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다.
`--public-addr`	없음	프록시할 애플리케이션의 공개 주소.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시할 애플리케이션의 내부 주소.

teleport backend clone#

소스에서 대상 백엔드로 데이터를 복제합니다.

사용법:

$ teleport backend clone

teleport backend edit#

클러스터 상태 백엔드에서 단일 항목을 수정합니다.

사용법:

$ teleport backend edit <key>

인수:

인수	기본값	설명
key	없음 (필수)	검색할 백엔드 키.

teleport backend get#

클러스터 상태 백엔드에서 단일 항목을 검색합니다.

사용법:

$ teleport backend get [<flags>] <key>

플래그:

플래그	기본값	설명
`-f`, `--format`	`text` (다음 중 하나: `text`, `json`, `yaml`)	출력 형식 (text, json, yaml)

인수:

인수	기본값	설명
key	없음 (필수)	검색할 백엔드 키.

teleport backend ls#

클러스터 상태 백엔드의 키 목록을 나열합니다.

사용법:

$ teleport backend ls [<flags>] [<prefix>]

플래그:

플래그	기본값	설명
`-f`, `--format`	`text` (다음 중 하나: `text`, `json`, `yaml`)	출력 형식 (text, json, yaml)

인수:

인수	기본값	설명
prefix	없음 (선택)	목록을 제한하기 위한 선택적 키 접두사.

teleport backend rm#

클러스터 상태 백엔드에서 단일 항목을 제거합니다.

사용법:

$ teleport backend rm <key>

인수:

인수	기본값	설명
key	없음 (필수)	제거할 백엔드 키.

teleport configure#

시작을 위한 간단한 구성 파일을 생성합니다.

사용법:

$ teleport configure [<flags>]

플래그:

플래그	기본값	설명
`--acme-email`	없음	Letsencrypt.org로부터 업데이트를 수신할 이메일.
`--app-name`	없음	app 역할 사용 시 시작할 애플리케이션 이름.
`--app-uri`	없음	프록시할 애플리케이션의 내부 주소.
`--auth-server`	없음	인증 서버 주소.
`--cert-file`	없음	프록시용 TLS 인증서 파일 경로.
`--cluster-name`	없음	고유한 클러스터 이름, 예: example.com.
`--data-dir`	`/var/lib/teleport`	Teleport가 데이터를 보관하는 디렉터리 경로.
`--join-method`	`token` (다음 중 하나: `azure`, `azure_devops`, `bitbucket`, `circleci`, `ec2`, `gcp`, `github`, `gitlab`, `iam`, `kubernetes`, `spacelift`, `token`, `tpm`, `terraform_cloud`, `oracle`, `bound_keypair`, `env0`)	클러스터에 참여할 때 사용할 방법.
`--key-file`	없음	프록시용 TLS 키 파일 경로.
`--[no-]acme`	`false`	ACME를 사용하여 Letsencrypt.org에서 자동 인증서를 가져옵니다.
`--node-labels`	없음	새로 생성된 노드에 추가할 레이블의 쉼표로 구분된 목록, 예: env=staging,cloud=aws.
`--node-name`	없음	Teleport 노드 이름.
`--[no-]mcp-demo-server`	`false`	현재 사용자 및 세션 정보를 표시하는 Teleport 데모 MCP 서버를 활성화합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--proxy`	없음	프록시 주소.
`--public-addr`	없음	프록시가 HTTP 엔드포인트에 알리는 호스트포트.
`--roles`	없음	구성을 생성할 역할의 쉼표로 구분된 목록.
`--test`	없음	테스트할 구성 파일 경로.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.
`--version`	`v3`	Teleport 구성 버전.

teleport db configure aws create-iam#

IAM 정책을 생성, 만들고 연결합니다.

사용법:

$ teleport db configure aws create-iam [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--name`	`DatabaseAccess`	생성된 정책 이름. 기본값은 빈 값입니다. 제공하지 않으면 자동 생성됩니다.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	정책을 연결할 IAM 역할 이름. --user와 상호 배타적
`-r`, `--types`	없음	정책에 포함할 데이터베이스 유형의 쉼표로 구분된 목록. rds,rdsproxy,redshift,redshift-serverless,elasticache,elasticache-serverless,memorydb,keyspace,dynamodb,opensearch,docdb 중 아무거나
`--user`	없음	정책을 연결할 IAM 사용자 이름. --role과 상호 배타적

teleport db configure aws print-iam#

IAM 정책을 생성하고 표시합니다.

사용법:

$ teleport db configure aws print-iam [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--[no-]policy`	`false`	IAM 정책 문서만 출력합니다.
`--policy-name`	`DatabaseAccess`	Teleport 데이터베이스 에이전트 정책 이름. 기본값: "DatabaseAccess".
`--role`	없음	정책을 연결할 IAM 역할 이름. --user와 상호 배타적
`-r`, `--types`	없음	정책에 포함할 데이터베이스 유형의 쉼표로 구분된 목록. rds,rdsproxy,redshift,redshift-serverless,elasticache,elasticache-serverless,memorydb,keyspace,dynamodb,opensearch,docdb 중 아무거나
`--user`	없음	정책을 연결할 IAM 사용자 이름. --role과 상호 배타적

teleport db configure bootstrap#

데이터베이스 에이전트에 필요한 구성을 부트스트랩합니다. 제공된 에이전트 구성을 읽어 부트스트랩할 항목을 결정합니다.

사용법:

$ teleport db configure bootstrap [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--attach-to-role`	없음	정책을 연결할 역할 이름. --attach-to-user와 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`--attach-to-user`	없음	정책을 연결할 사용자 이름. --attach-to-role과 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`-c`, `--config`	`/etc/teleport.yaml`	구성 파일 경로 [/etc/teleport.yaml].
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]manual`	`false`	"manual" 모드로 실행하면 직접 적용하는 대신 구성을 완료하기 위한 지침을 출력합니다.
`--policy-name`	`DatabaseAccess`	Teleport 데이터베이스 에이전트 정책 이름. 기본값: "DatabaseAccess".

teleport db configure create#

샘플 데이터베이스 서비스 구성을 생성합니다.

사용법:

$ teleport db configure create [<flags>]

플래그:

플래그	기본값	설명
`--ad-domain`	없음	(SQL Server 전용) Active Directory 도메인.
`--ad-keytab-file`	없음	(SQL Server 전용) Kerberos keytab 파일.
`--ad-spn`	없음	(SQL Server 전용) Active Directory 인증을 위한 서비스 주체 이름(SPN).
`--aws-account-id`	없음	(Keyspaces 또는 DynamoDB 전용) AWS 계정 ID.
`--aws-assume-role-arn`	없음	수임할 선택적 AWS IAM 역할.
`--aws-elasticache-group-id`	없음	(ElastiCache 전용) ElastiCache 복제 그룹 식별자.
`--aws-elasticache-serverless-cache-name`	없음	(ElastiCache Serverless 전용) ElastiCache Serverless 캐시 이름.
`--aws-external-id`	없음	(AWS 호스팅 데이터베이스 전용) AWS 역할 수임 시 사용할 선택적 AWS 외부 ID.
`--aws-memorydb-cluster-name`	없음	(MemoryDB 전용) MemoryDB 클러스터 이름.
`--aws-rds-cluster-id`	없음	(RDS Aurora 전용) RDS Aurora 데이터베이스 클러스터 식별자.
`--aws-rds-instance-id`	없음	(RDS 전용) RDS 데이터베이스 인스턴스 식별자.
`--aws-redshift-cluster-id`	없음	(Redshift 전용) Redshift 데이터베이스 클러스터 식별자.
`--aws-region`	없음	(AWS 호스팅 데이터베이스 전용) RDS, Aurora, Redshift, Redshift Serverless, ElastiCache, OpenSearch 또는 MemoryDB 데이터베이스 인스턴스가 실행 중인 AWS 리전.
`--aws-tags`	없음	(AWS 검색 전용) 일치시킬 AWS 리소스 태그의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--azure-mysql-discovery`	없음	에이전트가 MySQL 서버를 검색할 Azure 리전 목록.
`--azure-postgres-discovery`	없음	에이전트가 PostgreSQL 서버를 검색할 Azure 리전 목록.
`--azure-redis-discovery`	없음	에이전트가 Azure Cache For Redis 서버를 검색할 Azure 리전 목록.
`--azure-resource-group`	`*`	Azure 검색을 위한 Azure 리소스 그룹 목록. 기본값은 "*"입니다.
`--azure-sqlserver-discovery`	없음	에이전트가 Azure SQL 데이터베이스 및 Managed Instance를 검색할 Azure 리전 목록.
`--azure-subscription`	`*`	Azure 검색을 위한 Azure 구독 ID 목록. 기본값은 "*"입니다.
`--azure-tags`	없음	(Azure 검색 전용) 일치시킬 Azure 리소스 태그의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--ca-cert-file`	없음	데이터베이스 CA 인증서 경로.
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`--dynamic-resources-labels`	없음	동적 리소스를 일치시키기 위한 레이블의 쉼표로 구분된 목록(들), 예: env=dev,dept=it. 동적 리소스 매칭을 활성화하려면 필수입니다.
`--elasticache-discovery`	없음	에이전트가 ElastiCache Valkey 또는 Redis 클러스터를 검색할 AWS 리전 목록.
`--elasticache-serverless-discovery`	없음	에이전트가 ElastiCache Serverless Valkey 또는 Redis 캐시를 검색할 AWS 리전 목록.
`--gcp-instance-id`	없음	(Cloud SQL 전용) GCP Cloud SQL 인스턴스 식별자.
`--gcp-project-id`	없음	(Cloud SQL 전용) GCP Cloud SQL 프로젝트 식별자.
`--labels`	없음	데이터베이스에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--memorydb-discovery`	없음	에이전트가 MemoryDB 클러스터를 검색할 AWS 리전 목록.
`--name`	없음	프록시된 데이터베이스 이름.
`--[no-]trust-system-cert-pool`	`false`	Teleport가 자체 호스팅 데이터베이스에 대해 호스트 시스템에서 사용 가능한 인증 기관을 신뢰하도록 허용합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--opensearch-discovery`	없음	에이전트가 OpenSearch 도메인을 검색할 AWS 리전 목록.
`--protocol`	없음	프록시된 데이터베이스 프로토콜. 지원되는 항목: [postgres mysql mongodb oracle cockroachdb redis snowflake sqlserver cassandra elasticsearch opensearch dynamodb clickhouse clickhouse-http spanner].
`--proxy`	`0.0.0.0:3080`	연결할 Teleport 프록시 주소 [0.0.0.0:3080].
`--rds-discovery`	없음	에이전트가 RDS/Aurora 인스턴스를 검색할 AWS 리전 목록.
`--rdsproxy-discovery`	없음	에이전트가 RDS 프록시를 검색할 AWS 리전 목록.
`--redshift-discovery`	없음	에이전트가 Redshift 인스턴스를 검색할 AWS 리전 목록.
`--redshift-serverless-discovery`	없음	에이전트가 Redshift Serverless 인스턴스를 검색할 AWS 리전 목록.
`--token`	`/tmp/token`	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시된 데이터베이스에 도달할 수 있는 주소.

teleport db start#

데이터베이스 프록시 서비스를 시작합니다.

사용법:

$ teleport db start [<flags>]

플래그:

플래그	기본값	설명
`--ad-domain`	없음	(SQL Server 전용) Active Directory 도메인.
`--ad-keytab-file`	없음	(SQL Server 전용) Kerberos keytab 파일.
`--ad-krb5-file`	`/etc/krb5.conf`	(SQL Server 전용) Kerberos krb5.conf 파일.
`--ad-spn`	없음	(SQL Server 전용) Active Directory 인증을 위한 서비스 주체 이름(SPN).
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025].
`--aws-account-id`	없음	(Keyspaces 또는 DynamoDB 전용) AWS 계정 ID.
`--aws-assume-role-arn`	없음	수임할 선택적 AWS IAM 역할.
`--aws-external-id`	없음	AWS 역할 수임 시 사용되는 선택적 AWS 외부 ID.
`--aws-rds-cluster-id`	없음	(Aurora 전용) Aurora 클러스터 식별자.
`--aws-rds-instance-id`	없음	(RDS 전용) RDS 인스턴스 식별자.
`--aws-redshift-cluster-id`	없음	(Redshift 전용) Redshift 데이터베이스 클러스터 식별자.
`--aws-region`	없음	(RDS, Aurora, Redshift, ElastiCache 또는 MemoryDB 전용) AWS 호스팅 데이터베이스 인스턴스가 실행 중인 AWS 리전.
`--aws-session-tags`	없음	(DynamoDB 전용) STS 태그 목록.
`--ca-cert`	없음	데이터베이스 CA 인증서 경로.
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml].
`--description`	없음	프록시된 데이터베이스 설명.
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--gcp-alloydb-endpoint-type`	없음 (다음 중 하나: `public`, `private`, `psc`)	(AlloyDB 전용) 엔드포인트 유형.
`--gcp-instance-id`	없음	(Cloud SQL 전용) 인스턴스 식별자.
`--gcp-project-id`	없음	(Cloud SQL 전용) 프로젝트 식별자.
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--name`	없음	프록시된 데이터베이스 이름.
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다.
`--protocol`	없음	프록시된 데이터베이스 프로토콜. 지원되는 항목: [postgres mysql mongodb oracle cockroachdb redis snowflake sqlserver cassandra elasticsearch opensearch dynamodb clickhouse clickhouse-http spanner].
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시된 데이터베이스에 도달할 수 있는 주소.

teleport debug check-session-helper#

임베디드 세션 헬퍼가 이 빌드에서 사용 가능한 경우, 정상적으로 작동하는지 확인합니다.

사용법:

$ teleport debug check-session-helper

teleport debug get-log-level#

현재 로그 레벨을 가져옵니다.

사용법:

$ teleport debug get-log-level

teleport debug metrics#

클러스터의 Prometheus 메트릭을 가져옵니다.

사용법:

$ teleport debug metrics

teleport debug profile#

애플리케이션 프로파일을 내보냅니다 (pprof 형식). stdout에 .tar.gz 파일 내용을 출력합니다.

사용법:

$ teleport debug profile [<flags>] []

플래그:

플래그	기본값	설명
`-s`, `--seconds`	`0`	CPU 및 trace 프로파일의 경우, 지정된 기간 동안 프로파일링합니다 (0으로 설정하면 프로파일 스냅샷을 반환). 다른 프로파일의 경우, 델타 프로파일을 반환합니다. 기본값: 0

인수:

인수	기본값	설명
PROFILES	없음 (선택)	내보낼 프로파일 이름의 쉼표로 구분된 목록. 지원되는 프로파일: allocs,block,cmdline,goroutine,heap,mutex,profile,threadcreate,trace. 기본값: goroutine,heap,profile

teleport debug readyz#

인스턴스가 요청을 처리할 준비가 되었는지 확인합니다.

사용법:

$ teleport debug readyz

teleport debug require-session-helper#

임베디드 세션 헬퍼가 정상적으로 작동하는지 확인하며, 이 빌드에서 사용할 수 없으면 실패합니다.

사용법:

$ teleport debug require-session-helper

teleport debug set-log-level#

로그 레벨을 변경합니다.

사용법:

$ teleport debug set-log-level

인수:

인수	기본값	설명
LEVEL	없음 (필수)	로그 레벨 (대소문자 구분 없음). 다음 중 하나: TRACE,DEBUG,INFO,WARN,ERROR

teleport discovery bootstrap#

검색 에이전트에 필요한 구성을 부트스트랩합니다. 제공된 에이전트 구성을 읽어 부트스트랩할 항목을 결정합니다.

사용법:

$ teleport discovery bootstrap [<flags>]

플래그:

플래그	기본값	설명
`--assume-role-arn`	없음	부트스트랩 중 수임할 선택적 AWS IAM 역할.
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--attach-to-role`	없음	정책을 연결할 역할 이름. --attach-to-user와 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`--attach-to-user`	없음	정책을 연결할 사용자 이름. --attach-to-role과 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`-c`, `--config`	`/etc/teleport.yaml`	구성 파일 경로 [/etc/teleport.yaml].
`--database-service-policy-name`	`DatabaseAccess`	database-service-role이 제공된 경우 데이터베이스 서비스 부트스트랩을 위한 정책 이름.
`--database-service-role`	없음	데이터베이스 액세스 정책을 연결할 역할 이름. 지정하면, 이 검색 서비스가 발견한 데이터베이스에 액세스하는 데이터베이스 서비스에 대해 부트스트랩합니다.
`--external-id`	없음	AWS 역할 수임 시 사용되는 선택적 AWS 외부 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]manual`	`false`	"manual" 모드로 실행하면 직접 적용하는 대신 구성을 완료하기 위한 지침을 출력합니다.
`--policy-name`	`TeleportEC2Discovery`	Teleport 검색 서비스 정책 이름. 기본값: "TeleportEC2Discovery".
`--proxy`	없음	연결할 Teleport 프록시 주소

teleport help#

도움말을 표시합니다.

사용법:

$ teleport help [<command>...]

인수:

인수	기본값	설명
command	없음 (선택)	커맨드에 대한 도움말을 표시합니다.

teleport install systemd#

systemd 유닛 파일 구성을 생성합니다.

사용법:

$ teleport install systemd [<flags>]

플래그:

플래그	기본값	설명
`--env-file`	`/etc/default/teleport`	환경 파일의 전체 경로.
`--fd-limit`	`524288`	열 수 있는 최대 파일 디스크립터 수.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기 또는 --output=file:///path로 사용자 지정 경로
`--pid-file`	`/run/teleport.pid`	PID 파일의 전체 경로.
`--teleport-path`	없음	Teleport 바이너리의 전체 경로.

teleport integration configure access-graph aws-iam#

Access Graph 서비스에 AWS 리소스를 동기화하기 위한 필수 AWS IAM 권한을 추가합니다.

사용법:

$ teleport integration configure access-graph aws-iam --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--cloud-trail-bucket`	없음	CloudTrail이 이벤트를 기록하는 S3 버킷의 ARN.
`--kms-key`	없음	SQS 및 S3 버킷 데이터를 복호화하는 데 사용되는 KMS 키 목록.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]eks-audit-logs`	`false`	EKS 감사 로그 수집을 활성화합니다
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.
`--sqs-queue-url`	없음	CloudTrail로부터 알림을 수신하는 데 사용되는 SQS 큐 URL.

teleport integration configure access-graph azure#

Access Graph 서비스에 Azure 리소스를 동기화하기 위한 필수 Azure 권한을 추가합니다.

사용법:

$ teleport integration configure access-graph azure --managed-identity=MANAGED-IDENTITY --role-name=ROLE-NAME [<flags>]

플래그:

플래그	기본값	설명
`--managed-identity`	없음	검색 서비스를 실행할 관리 ID의 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role-name`	없음	생성하여 관리 ID에 할당할 Azure 역할 이름
`--subscription-id`	없음	리소스를 검색할 구독 ID.

teleport integration configure aws-app-access-iam#

App Access를 사용하여 AWS에 연결하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure aws-app-access-iam --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할 이름.

teleport integration configure awsoidc-idp#

AWS OIDC 통합이 AWS API에 접근할 수 있도록 AWS 계정에 IAM IdP(OIDC)를 생성합니다.

사용법:

$ teleport integration configure awsoidc-idp --cluster=CLUSTER --name=NAME --role=ROLE --proxy-public-url=PROXY-PUBLIC-URL [<flags>]

플래그:

플래그	기본값	설명
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--policy-preset`	없음	AWS OIDC 통합 역할에 적용될 정책.
`--proxy-public-url`	없음	프록시 공개 URL (예: https://mytenant.teleport.sh).
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure awsra-trust-anchor#

AWS에서 리소스를 생성하여 AWS IAM Roles Anywhere 통합을 구성합니다.

사용법:

$ teleport integration configure awsra-trust-anchor --cluster=CLUSTER --name=NAME --trust-anchor=TRUST-ANCHOR --trust-anchor-cert-b64=TRUST-ANCHOR-CERT-B64 --sync-profile=SYNC-PROFILE --sync-role=SYNC-ROLE [<flags>]

플래그:

플래그	기본값	설명
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--sync-profile`	없음	앱으로 프로파일을 동기화하는 데 사용될, 생성할 AWS IAM Roles Anywhere 프로파일 이름.
`--sync-role`	없음	앱으로 프로파일을 동기화하는 데 사용될, 생성할 AWS IAM 역할 이름.
`--trust-anchor`	없음	AWS Roles Anywhere Trust Anchor 이름.
`--trust-anchor-cert-b64`	없음	base64로 인코딩된 AWS Roles Anywhere Trust Anchor 인증서.

teleport integration configure azure-oidc#

Azure / Entra ID OIDC 통합을 구성합니다.

사용법:

$ teleport integration configure azure-oidc --proxy-public-addr=PROXY-PUBLIC-ADDR --auth-connector-name=AUTH-CONNECTOR-NAME [<flags>]

플래그:

플래그	기본값	설명
`--auth-connector-name`	없음	Teleport에서 Entra ID SAML 인증 커넥터의 이름.
`--[no-]access-graph`	`false`	Access Graph 통합을 활성화합니다.
`--[no-]skip-oidc-integration`	`false`	OIDC 통합을 건너뜁니다.
`--proxy-public-addr`	없음	Teleport 프록시 서비스의 공개 주소

teleport integration configure deployservice-iam#

AWS OIDC 배포 서비스에 필요한 IAM 역할을 생성합니다.

사용법:

$ teleport integration configure deployservice-iam --cluster=CLUSTER --name=NAME --aws-region=AWS-REGION --role=ROLE --task-role=TASK-ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.
`--task-role`	없음	배포된 서비스에 사용될 AWS 역할.

teleport integration configure ec2-ssm-iam#

SSM을 사용한 EC2 자동 검색을 활성화하기 위한 필수 IAM 권한 및 SSM 문서를 추가합니다.

사용법:

$ teleport integration configure ec2-ssm-iam --role=ROLE --aws-region=AWS-REGION --cluster=CLUSTER --name=NAME [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--proxy-public-url`	없음	프록시 공개 URL (예: https://mytenant.teleport.sh).
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할 이름.
`--ssm-document-name`	없음	teleport를 설치하는 데 사용될, 생성할 AWS SSM 문서 이름.

teleport integration configure eks-iam#

Teleport에 EKS 클러스터를 등록하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure eks-iam --aws-region=AWS-REGION --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure externalauditstorage#

External Audit Storage 로그에 필요한 인프라를 부트스트랩하고 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure externalauditstorage --aws-region=AWS-REGION --cluster-name=CLUSTER-NAME --integration=INTEGRATION --role=ROLE --policy=POLICY --session-recordings=SESSION-RECORDINGS --audit-events=AUDIT-EVENTS --athena-results=ATHENA-RESULTS --athena-workgroup=ATHENA-WORKGROUP --glue-database=GLUE-DATABASE --glue-table=GLUE-TABLE [<flags>]

플래그:

플래그	기본값	설명
`--athena-results`	없음	Athena 결과가 저장되는 S3 URI.
`--athena-workgroup`	없음	사용되는 Athena 워크그룹 이름.
`--audit-events`	없음	감사 이벤트가 저장되는 S3 URI.
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-partition`	`aws`	AWS 파티션 (기본값: aws).
`--aws-region`	없음	AWS 리전.
`--cluster-name`	없음	Teleport 클러스터 이름.
`--glue-database`	없음	사용되는 Glue 데이터베이스 이름.
`--glue-table`	없음	사용되는 Glue 테이블 이름.
`--integration`	없음	AWS OIDC 통합 이름.
`--[no-]bootstrap`	`false`	필수 인프라를 부트스트랩합니다.
`--policy`	없음	IAM 역할에 연결할 정책 이름.
`--role`	없음	AWS OIDC 통합에 사용되는 IAM 역할.
`--session-recordings`	없음	세션 녹화가 저장되는 S3 URI.

teleport integration configure listdatabases-iam#

RDS 데이터베이스(인스턴스 및 클러스터)를 나열하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure listdatabases-iam --aws-region=AWS-REGION --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure samlidp gcp-workforce#

GCP Workforce Identity Federation 풀 및 SAML 제공자를 구성합니다.

사용법:

$ teleport integration configure samlidp gcp-workforce --org-id=ORG-ID --pool-name=POOL-NAME --pool-provider-name=POOL-PROVIDER-NAME --idp-metadata-url=IDP-METADATA-URL

플래그:

플래그	기본값	설명
`--idp-metadata-url`	없음	Teleport SAML IdP 메타데이터 엔드포인트.
`--org-id`	없음	GCP 조직 ID.
`--pool-name`	없음	새 workforce identity 풀 이름.
`--pool-provider-name`	없음	새 workforce identity 풀 제공자 이름.

teleport integration configure session-summaries bedrock#

Amazon Bedrock을 사용하는 Session Summaries 기능에 필요한 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure session-summaries bedrock --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--resource`	`*`	액세스 권한을 부여할 Amazon Bedrock 리소스. 전체 ARN 또는 모델 ID일 수 있습니다 (예: 'anthropic.claude-v2' 또는 모든 모델에 대해 '*').
`--role`	없음	AWS OIDC 통합에서 사용하는 AWS 역할 이름.

teleport join openssh#

SSH 서버를 Teleport 클러스터에 참여시킵니다.

사용법:

$ teleport join openssh [<flags>]

플래그:

플래그	기본값	설명
`--additional-principals`	없음	포함할 추가 주체. 여러 번 지정 가능.
`--address`	없음	이 OpenSSH 노드의 호스트명 또는 IP 주소.
`--data-dir`	`/var/lib/teleport`	teleport 데이터를 저장할 디렉터리 경로 [/var/lib/teleport].
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--join-method`	없음 (다음 중 하나: `token`, `iam`, `ec2`)	클러스터에 참여할 때 사용할 방법.
`--labels`	없음	이 OpenSSH 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]restart-sshd`	`true`	OpenSSH를 재시작합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--openssh-config`	`/etc/ssh/sshd_config`	OpenSSH 구성 파일 경로 [/etc/ssh/sshd_config].
`--proxy-server`	없음	프록시 서버 주소.
`--sshd-check-command`	`sshd -t -f`	OpenSSH 구성의 유효성을 확인할 때 사용할 커맨드. (sshd -t -f <sshd_config>)
`--sshd-restart-command`	없음	openssh를 재시작할 때 사용할 커맨드.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.

teleport node configure#

SSH 노드에 대한 구성 파일을 생성합니다.

사용법:

$ teleport node configure [<flags>]

플래그:

플래그	기본값	설명
`--auth-server`	없음	인증 서버 주소.
`--azure-client-id`	없음	참여할 관리 ID의 클라이언트 ID를 설정합니다. 'azure' 참여 방법에만 적용됩니다.
`--ca-pin`	없음	인증 서버를 검증하는 데 사용되는 CA의 SKPI 해시의 쉼표로 구분된 목록.
`--cluster-name`	없음	고유한 클러스터 이름, 예: example.com.
`--data-dir`	`/var/lib/teleport`	Teleport가 데이터를 보관하는 디렉터리 경로.
`--join-method`	`token` (다음 중 하나: `azure`, `azure_devops`, `bitbucket`, `circleci`, `ec2`, `gcp`, `github`, `gitlab`, `iam`, `kubernetes`, `spacelift`, `token`, `tpm`, `terraform_cloud`, `oracle`, `bound_keypair`, `env0`)	클러스터에 참여할 때 사용할 방법.
`--labels`	없음	새로 생성된 노드에 추가할 레이블의 쉼표로 구분된 목록, 예) env=staging,cloud=aws.
`--node-name`	없음	Teleport 노드 이름.
`--[no-]silent`	`false`	사용자 힌트 메시지를 억제합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--proxy`	없음	프록시 서버 주소.
`--public-addr`	없음	노드가 SSH 엔드포인트에 알리는 호스트포트.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.
`--version`	`v3`	Teleport 구성 버전.

teleport start#

Teleport 서비스를 시작합니다.

사용법:

$ teleport start [<flags>]

플래그:

플래그	기본값	설명
`--advertise-ip`	없음	NAT 뒤에서 실행 중인 경우 클라이언트에 알릴 IP
`--apply-on-startup`	없음	시작 시 적용할 리소스가 포함된 비어 있지 않은 YAML 파일 경로. --bootstrap과 달리 초기화된 클러스터에서 작동합니다. 다음 종류만 지원합니다: bot,cluster_auth_preference,cluster_networking_config,inference_model,inference_policy,inference_secret,retrieval_model,role,token,user,workload_identity.
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025]
`--bootstrap`	없음	부트스트랩 리소스가 포함된 비어 있지 않은 YAML 파일 경로 (이미 초기화된 경우 무시)
`--ca-pin`	없음	인증 서버(Auth Server)를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능)
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml]
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web
`-l`, `--listen-ip`	없음	바인딩할 IP 주소 [0.0.0.0]
`--nodename`	없음	이 노드의 이름, 기본값은 호스트명
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]insecure-no-tls`	`false`	웹 소켓에 대한 TLS를 비활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]permit-user-env`	`false`	세션 생성 시 ~/.tsh/environment 읽기를 활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다
`-r`, `--roles`	없음	시작할 역할의 쉼표로 구분된 목록 [proxy,node,auth,app,db]
`--token`	없음	초대 토큰 또는 토큰 값이 포함된 파일 경로. 인증 서버에 등록하는 데 사용 [없음]

teleport status#

현재 SSH 세션의 상태를 출력합니다.

사용법:

$ teleport status

teleport tpm identify#

시스템에서 감지된 TPM에 관련된 식별 정보를 출력합니다.

사용법:

$ teleport tpm identify

teleport version#

teleport 바이너리 버전을 출력합니다.

사용법:

$ teleport version [<flags>]

플래그:

플래그	기본값	설명
`--[no-]raw`	`false`	원시 teleport 버전 문자열을 출력합니다.

teleport 참조

Teleport v18.10

원문 보기

번역일: 2026-08-05

요약

이 가이드는 teleport의 커맨드, 인수 및 플래그에 대한 종합적인 목록을 제공합니다.

teleport는 Teleport Infrastructure Identity Platform을 지원하는 CLI 도구로, 커맨드 라인을 통해 Teleport 서비스를 관리할 수 있게 해줍니다.

$ teleport <command> [<args> ...]

teleport app start#

애플리케이션 프록시 서비스를 시작합니다.

사용법:

$ teleport app start [<flags>]

플래그:

플래그	기본값	설명
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025].
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml].
`--cloud`	없음	애플리케이션이 특정 클라우드 API를 프록시해야 하는 경우 [AWS Azure GCP] 중 하나로 설정.
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--name`	없음	시작할 애플리케이션 이름.
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]mcp-demo-server`	`false`	현재 사용자 및 세션 정보를 표시하는 Teleport 데모 MCP 서버를 활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다.
`--public-addr`	없음	프록시할 애플리케이션의 공개 주소.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시할 애플리케이션의 내부 주소.

teleport backend clone#

소스에서 대상 백엔드로 데이터를 복제합니다.

사용법:

$ teleport backend clone

teleport backend edit#

클러스터 상태 백엔드에서 단일 항목을 수정합니다.

사용법:

$ teleport backend edit <key>

인수:

인수	기본값	설명
key	없음 (필수)	검색할 백엔드 키.

teleport backend get#

클러스터 상태 백엔드에서 단일 항목을 검색합니다.

사용법:

$ teleport backend get [<flags>] <key>

플래그:

플래그	기본값	설명
`-f`, `--format`	`text` (다음 중 하나: `text`, `json`, `yaml`)	출력 형식 (text, json, yaml)

인수:

인수	기본값	설명
key	없음 (필수)	검색할 백엔드 키.

teleport backend ls#

클러스터 상태 백엔드의 키 목록을 나열합니다.

사용법:

$ teleport backend ls [<flags>] [<prefix>]

플래그:

플래그	기본값	설명
`-f`, `--format`	`text` (다음 중 하나: `text`, `json`, `yaml`)	출력 형식 (text, json, yaml)

인수:

인수	기본값	설명
prefix	없음 (선택)	목록을 제한하기 위한 선택적 키 접두사.

teleport backend rm#

클러스터 상태 백엔드에서 단일 항목을 제거합니다.

사용법:

$ teleport backend rm <key>

인수:

인수	기본값	설명
key	없음 (필수)	제거할 백엔드 키.

teleport configure#

시작을 위한 간단한 구성 파일을 생성합니다.

사용법:

$ teleport configure [<flags>]

플래그:

플래그	기본값	설명
`--acme-email`	없음	Letsencrypt.org로부터 업데이트를 수신할 이메일.
`--app-name`	없음	app 역할 사용 시 시작할 애플리케이션 이름.
`--app-uri`	없음	프록시할 애플리케이션의 내부 주소.
`--auth-server`	없음	인증 서버 주소.
`--cert-file`	없음	프록시용 TLS 인증서 파일 경로.
`--cluster-name`	없음	고유한 클러스터 이름, 예: example.com.
`--data-dir`	`/var/lib/teleport`	Teleport가 데이터를 보관하는 디렉터리 경로.
`--join-method`	`token` (다음 중 하나: `azure`, `azure_devops`, `bitbucket`, `circleci`, `ec2`, `gcp`, `github`, `gitlab`, `iam`, `kubernetes`, `spacelift`, `token`, `tpm`, `terraform_cloud`, `oracle`, `bound_keypair`, `env0`)	클러스터에 참여할 때 사용할 방법.
`--key-file`	없음	프록시용 TLS 키 파일 경로.
`--[no-]acme`	`false`	ACME를 사용하여 Letsencrypt.org에서 자동 인증서를 가져옵니다.
`--node-labels`	없음	새로 생성된 노드에 추가할 레이블의 쉼표로 구분된 목록, 예: env=staging,cloud=aws.
`--node-name`	없음	Teleport 노드 이름.
`--[no-]mcp-demo-server`	`false`	현재 사용자 및 세션 정보를 표시하는 Teleport 데모 MCP 서버를 활성화합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--proxy`	없음	프록시 주소.
`--public-addr`	없음	프록시가 HTTP 엔드포인트에 알리는 호스트포트.
`--roles`	없음	구성을 생성할 역할의 쉼표로 구분된 목록.
`--test`	없음	테스트할 구성 파일 경로.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.
`--version`	`v3`	Teleport 구성 버전.

teleport db configure aws create-iam#

IAM 정책을 생성, 만들고 연결합니다.

사용법:

$ teleport db configure aws create-iam [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--name`	`DatabaseAccess`	생성된 정책 이름. 기본값은 빈 값입니다. 제공하지 않으면 자동 생성됩니다.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	정책을 연결할 IAM 역할 이름. --user와 상호 배타적
`-r`, `--types`	없음	정책에 포함할 데이터베이스 유형의 쉼표로 구분된 목록. rds,rdsproxy,redshift,redshift-serverless,elasticache,elasticache-serverless,memorydb,keyspace,dynamodb,opensearch,docdb 중 아무거나
`--user`	없음	정책을 연결할 IAM 사용자 이름. --role과 상호 배타적

teleport db configure aws print-iam#

IAM 정책을 생성하고 표시합니다.

사용법:

$ teleport db configure aws print-iam [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--[no-]policy`	`false`	IAM 정책 문서만 출력합니다.
`--policy-name`	`DatabaseAccess`	Teleport 데이터베이스 에이전트 정책 이름. 기본값: "DatabaseAccess".
`--role`	없음	정책을 연결할 IAM 역할 이름. --user와 상호 배타적
`-r`, `--types`	없음	정책에 포함할 데이터베이스 유형의 쉼표로 구분된 목록. rds,rdsproxy,redshift,redshift-serverless,elasticache,elasticache-serverless,memorydb,keyspace,dynamodb,opensearch,docdb 중 아무거나
`--user`	없음	정책을 연결할 IAM 사용자 이름. --role과 상호 배타적

teleport db configure bootstrap#

데이터베이스 에이전트에 필요한 구성을 부트스트랩합니다. 제공된 에이전트 구성을 읽어 부트스트랩할 항목을 결정합니다.

사용법:

$ teleport db configure bootstrap [<flags>]

플래그:

플래그	기본값	설명
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--attach-to-role`	없음	정책을 연결할 역할 이름. --attach-to-user와 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`--attach-to-user`	없음	정책을 연결할 사용자 이름. --attach-to-role과 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`-c`, `--config`	`/etc/teleport.yaml`	구성 파일 경로 [/etc/teleport.yaml].
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]manual`	`false`	"manual" 모드로 실행하면 직접 적용하는 대신 구성을 완료하기 위한 지침을 출력합니다.
`--policy-name`	`DatabaseAccess`	Teleport 데이터베이스 에이전트 정책 이름. 기본값: "DatabaseAccess".

teleport db configure create#

샘플 데이터베이스 서비스 구성을 생성합니다.

사용법:

$ teleport db configure create [<flags>]

플래그:

플래그	기본값	설명
`--ad-domain`	없음	(SQL Server 전용) Active Directory 도메인.
`--ad-keytab-file`	없음	(SQL Server 전용) Kerberos keytab 파일.
`--ad-spn`	없음	(SQL Server 전용) Active Directory 인증을 위한 서비스 주체 이름(SPN).
`--aws-account-id`	없음	(Keyspaces 또는 DynamoDB 전용) AWS 계정 ID.
`--aws-assume-role-arn`	없음	수임할 선택적 AWS IAM 역할.
`--aws-elasticache-group-id`	없음	(ElastiCache 전용) ElastiCache 복제 그룹 식별자.
`--aws-elasticache-serverless-cache-name`	없음	(ElastiCache Serverless 전용) ElastiCache Serverless 캐시 이름.
`--aws-external-id`	없음	(AWS 호스팅 데이터베이스 전용) AWS 역할 수임 시 사용할 선택적 AWS 외부 ID.
`--aws-memorydb-cluster-name`	없음	(MemoryDB 전용) MemoryDB 클러스터 이름.
`--aws-rds-cluster-id`	없음	(RDS Aurora 전용) RDS Aurora 데이터베이스 클러스터 식별자.
`--aws-rds-instance-id`	없음	(RDS 전용) RDS 데이터베이스 인스턴스 식별자.
`--aws-redshift-cluster-id`	없음	(Redshift 전용) Redshift 데이터베이스 클러스터 식별자.
`--aws-region`	없음	(AWS 호스팅 데이터베이스 전용) RDS, Aurora, Redshift, Redshift Serverless, ElastiCache, OpenSearch 또는 MemoryDB 데이터베이스 인스턴스가 실행 중인 AWS 리전.
`--aws-tags`	없음	(AWS 검색 전용) 일치시킬 AWS 리소스 태그의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--azure-mysql-discovery`	없음	에이전트가 MySQL 서버를 검색할 Azure 리전 목록.
`--azure-postgres-discovery`	없음	에이전트가 PostgreSQL 서버를 검색할 Azure 리전 목록.
`--azure-redis-discovery`	없음	에이전트가 Azure Cache For Redis 서버를 검색할 Azure 리전 목록.
`--azure-resource-group`	`*`	Azure 검색을 위한 Azure 리소스 그룹 목록. 기본값은 "*"입니다.
`--azure-sqlserver-discovery`	없음	에이전트가 Azure SQL 데이터베이스 및 Managed Instance를 검색할 Azure 리전 목록.
`--azure-subscription`	`*`	Azure 검색을 위한 Azure 구독 ID 목록. 기본값은 "*"입니다.
`--azure-tags`	없음	(Azure 검색 전용) 일치시킬 Azure 리소스 태그의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--ca-cert-file`	없음	데이터베이스 CA 인증서 경로.
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`--dynamic-resources-labels`	없음	동적 리소스를 일치시키기 위한 레이블의 쉼표로 구분된 목록(들), 예: env=dev,dept=it. 동적 리소스 매칭을 활성화하려면 필수입니다.
`--elasticache-discovery`	없음	에이전트가 ElastiCache Valkey 또는 Redis 클러스터를 검색할 AWS 리전 목록.
`--elasticache-serverless-discovery`	없음	에이전트가 ElastiCache Serverless Valkey 또는 Redis 캐시를 검색할 AWS 리전 목록.
`--gcp-instance-id`	없음	(Cloud SQL 전용) GCP Cloud SQL 인스턴스 식별자.
`--gcp-project-id`	없음	(Cloud SQL 전용) GCP Cloud SQL 프로젝트 식별자.
`--labels`	없음	데이터베이스에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,dept=it
`--memorydb-discovery`	없음	에이전트가 MemoryDB 클러스터를 검색할 AWS 리전 목록.
`--name`	없음	프록시된 데이터베이스 이름.
`--[no-]trust-system-cert-pool`	`false`	Teleport가 자체 호스팅 데이터베이스에 대해 호스트 시스템에서 사용 가능한 인증 기관을 신뢰하도록 허용합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--opensearch-discovery`	없음	에이전트가 OpenSearch 도메인을 검색할 AWS 리전 목록.
`--protocol`	없음	프록시된 데이터베이스 프로토콜. 지원되는 항목: [postgres mysql mongodb oracle cockroachdb redis snowflake sqlserver cassandra elasticsearch opensearch dynamodb clickhouse clickhouse-http spanner].
`--proxy`	`0.0.0.0:3080`	연결할 Teleport 프록시 주소 [0.0.0.0:3080].
`--rds-discovery`	없음	에이전트가 RDS/Aurora 인스턴스를 검색할 AWS 리전 목록.
`--rdsproxy-discovery`	없음	에이전트가 RDS 프록시를 검색할 AWS 리전 목록.
`--redshift-discovery`	없음	에이전트가 Redshift 인스턴스를 검색할 AWS 리전 목록.
`--redshift-serverless-discovery`	없음	에이전트가 Redshift Serverless 인스턴스를 검색할 AWS 리전 목록.
`--token`	`/tmp/token`	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시된 데이터베이스에 도달할 수 있는 주소.

teleport db start#

데이터베이스 프록시 서비스를 시작합니다.

사용법:

$ teleport db start [<flags>]

플래그:

플래그	기본값	설명
`--ad-domain`	없음	(SQL Server 전용) Active Directory 도메인.
`--ad-keytab-file`	없음	(SQL Server 전용) Kerberos keytab 파일.
`--ad-krb5-file`	`/etc/krb5.conf`	(SQL Server 전용) Kerberos krb5.conf 파일.
`--ad-spn`	없음	(SQL Server 전용) Active Directory 인증을 위한 서비스 주체 이름(SPN).
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025].
`--aws-account-id`	없음	(Keyspaces 또는 DynamoDB 전용) AWS 계정 ID.
`--aws-assume-role-arn`	없음	수임할 선택적 AWS IAM 역할.
`--aws-external-id`	없음	AWS 역할 수임 시 사용되는 선택적 AWS 외부 ID.
`--aws-rds-cluster-id`	없음	(Aurora 전용) Aurora 클러스터 식별자.
`--aws-rds-instance-id`	없음	(RDS 전용) RDS 인스턴스 식별자.
`--aws-redshift-cluster-id`	없음	(Redshift 전용) Redshift 데이터베이스 클러스터 식별자.
`--aws-region`	없음	(RDS, Aurora, Redshift, ElastiCache 또는 MemoryDB 전용) AWS 호스팅 데이터베이스 인스턴스가 실행 중인 AWS 리전.
`--aws-session-tags`	없음	(DynamoDB 전용) STS 태그 목록.
`--ca-cert`	없음	데이터베이스 CA 인증서 경로.
`--ca-pin`	없음	인증 서버를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능).
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml].
`--description`	없음	프록시된 데이터베이스 설명.
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--gcp-alloydb-endpoint-type`	없음 (다음 중 하나: `public`, `private`, `psc`)	(AlloyDB 전용) 엔드포인트 유형.
`--gcp-instance-id`	없음	(Cloud SQL 전용) 인스턴스 식별자.
`--gcp-project-id`	없음	(Cloud SQL 전용) 프로젝트 식별자.
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--name`	없음	프록시된 데이터베이스 이름.
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다.
`--protocol`	없음	프록시된 데이터베이스 프로토콜. 지원되는 항목: [postgres mysql mongodb oracle cockroachdb redis snowflake sqlserver cassandra elasticsearch opensearch dynamodb clickhouse clickhouse-http spanner].
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로 [없음].
`--uri`	없음	프록시된 데이터베이스에 도달할 수 있는 주소.

teleport debug check-session-helper#

임베디드 세션 헬퍼가 이 빌드에서 사용 가능한 경우, 정상적으로 작동하는지 확인합니다.

사용법:

$ teleport debug check-session-helper

teleport debug get-log-level#

현재 로그 레벨을 가져옵니다.

사용법:

$ teleport debug get-log-level

teleport debug metrics#

클러스터의 Prometheus 메트릭을 가져옵니다.

사용법:

$ teleport debug metrics

teleport debug profile#

애플리케이션 프로파일을 내보냅니다 (pprof 형식). stdout에 .tar.gz 파일 내용을 출력합니다.

사용법:

$ teleport debug profile [<flags>] []

플래그:

플래그	기본값	설명
`-s`, `--seconds`	`0`	CPU 및 trace 프로파일의 경우, 지정된 기간 동안 프로파일링합니다 (0으로 설정하면 프로파일 스냅샷을 반환). 다른 프로파일의 경우, 델타 프로파일을 반환합니다. 기본값: 0

인수:

인수	기본값	설명
PROFILES	없음 (선택)	내보낼 프로파일 이름의 쉼표로 구분된 목록. 지원되는 프로파일: allocs,block,cmdline,goroutine,heap,mutex,profile,threadcreate,trace. 기본값: goroutine,heap,profile

teleport debug readyz#

인스턴스가 요청을 처리할 준비가 되었는지 확인합니다.

사용법:

$ teleport debug readyz

teleport debug require-session-helper#

임베디드 세션 헬퍼가 정상적으로 작동하는지 확인하며, 이 빌드에서 사용할 수 없으면 실패합니다.

사용법:

$ teleport debug require-session-helper

teleport debug set-log-level#

로그 레벨을 변경합니다.

사용법:

$ teleport debug set-log-level

인수:

인수	기본값	설명
LEVEL	없음 (필수)	로그 레벨 (대소문자 구분 없음). 다음 중 하나: TRACE,DEBUG,INFO,WARN,ERROR

teleport discovery bootstrap#

검색 에이전트에 필요한 구성을 부트스트랩합니다. 제공된 에이전트 구성을 읽어 부트스트랩할 항목을 결정합니다.

사용법:

$ teleport discovery bootstrap [<flags>]

플래그:

플래그	기본값	설명
`--assume-role-arn`	없음	부트스트랩 중 수임할 선택적 AWS IAM 역할.
`--assumes-roles`	없음	IAM 자격 증명이 수임할 수 있어야 하는 추가 IAM 역할의 쉼표로 구분된 목록. 각 역할은 IAM 역할 ARN 또는 자격 증명 계정의 역할 이름일 수 있습니다.
`--attach-to-role`	없음	정책을 연결할 역할 이름. --attach-to-user와 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`--attach-to-user`	없음	정책을 연결할 사용자 이름. --attach-to-role과 상호 배타적. attach-to 플래그 중 어느 것도 제공하지 않으면, 자격 증명을 기준으로 현재 사용자/역할에 정책을 연결하려고 시도합니다.
`-c`, `--config`	`/etc/teleport.yaml`	구성 파일 경로 [/etc/teleport.yaml].
`--database-service-policy-name`	`DatabaseAccess`	database-service-role이 제공된 경우 데이터베이스 서비스 부트스트랩을 위한 정책 이름.
`--database-service-role`	없음	데이터베이스 액세스 정책을 연결할 역할 이름. 지정하면, 이 검색 서비스가 발견한 데이터베이스에 액세스하는 데이터베이스 서비스에 대해 부트스트랩합니다.
`--external-id`	없음	AWS 역할 수임 시 사용되는 선택적 AWS 외부 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]manual`	`false`	"manual" 모드로 실행하면 직접 적용하는 대신 구성을 완료하기 위한 지침을 출력합니다.
`--policy-name`	`TeleportEC2Discovery`	Teleport 검색 서비스 정책 이름. 기본값: "TeleportEC2Discovery".
`--proxy`	없음	연결할 Teleport 프록시 주소

teleport help#

도움말을 표시합니다.

사용법:

$ teleport help [<command>...]

인수:

인수	기본값	설명
command	없음 (선택)	커맨드에 대한 도움말을 표시합니다.

teleport install systemd#

systemd 유닛 파일 구성을 생성합니다.

사용법:

$ teleport install systemd [<flags>]

플래그:

플래그	기본값	설명
`--env-file`	`/etc/default/teleport`	환경 파일의 전체 경로.
`--fd-limit`	`524288`	열 수 있는 최대 파일 디스크립터 수.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기 또는 --output=file:///path로 사용자 지정 경로
`--pid-file`	`/run/teleport.pid`	PID 파일의 전체 경로.
`--teleport-path`	없음	Teleport 바이너리의 전체 경로.

teleport integration configure access-graph aws-iam#

Access Graph 서비스에 AWS 리소스를 동기화하기 위한 필수 AWS IAM 권한을 추가합니다.

사용법:

$ teleport integration configure access-graph aws-iam --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--cloud-trail-bucket`	없음	CloudTrail이 이벤트를 기록하는 S3 버킷의 ARN.
`--kms-key`	없음	SQS 및 S3 버킷 데이터를 복호화하는 데 사용되는 KMS 키 목록.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]eks-audit-logs`	`false`	EKS 감사 로그 수집을 활성화합니다
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.
`--sqs-queue-url`	없음	CloudTrail로부터 알림을 수신하는 데 사용되는 SQS 큐 URL.

teleport integration configure access-graph azure#

Access Graph 서비스에 Azure 리소스를 동기화하기 위한 필수 Azure 권한을 추가합니다.

사용법:

$ teleport integration configure access-graph azure --managed-identity=MANAGED-IDENTITY --role-name=ROLE-NAME [<flags>]

플래그:

플래그	기본값	설명
`--managed-identity`	없음	검색 서비스를 실행할 관리 ID의 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role-name`	없음	생성하여 관리 ID에 할당할 Azure 역할 이름
`--subscription-id`	없음	리소스를 검색할 구독 ID.

teleport integration configure aws-app-access-iam#

App Access를 사용하여 AWS에 연결하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure aws-app-access-iam --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할 이름.

teleport integration configure awsoidc-idp#

AWS OIDC 통합이 AWS API에 접근할 수 있도록 AWS 계정에 IAM IdP(OIDC)를 생성합니다.

사용법:

$ teleport integration configure awsoidc-idp --cluster=CLUSTER --name=NAME --role=ROLE --proxy-public-url=PROXY-PUBLIC-URL [<flags>]

플래그:

플래그	기본값	설명
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--policy-preset`	없음	AWS OIDC 통합 역할에 적용될 정책.
`--proxy-public-url`	없음	프록시 공개 URL (예: https://mytenant.teleport.sh).
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure awsra-trust-anchor#

AWS에서 리소스를 생성하여 AWS IAM Roles Anywhere 통합을 구성합니다.

사용법:

$ teleport integration configure awsra-trust-anchor --cluster=CLUSTER --name=NAME --trust-anchor=TRUST-ANCHOR --trust-anchor-cert-b64=TRUST-ANCHOR-CERT-B64 --sync-profile=SYNC-PROFILE --sync-role=SYNC-ROLE [<flags>]

플래그:

플래그	기본값	설명
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--sync-profile`	없음	앱으로 프로파일을 동기화하는 데 사용될, 생성할 AWS IAM Roles Anywhere 프로파일 이름.
`--sync-role`	없음	앱으로 프로파일을 동기화하는 데 사용될, 생성할 AWS IAM 역할 이름.
`--trust-anchor`	없음	AWS Roles Anywhere Trust Anchor 이름.
`--trust-anchor-cert-b64`	없음	base64로 인코딩된 AWS Roles Anywhere Trust Anchor 인증서.

teleport integration configure azure-oidc#

Azure / Entra ID OIDC 통합을 구성합니다.

사용법:

$ teleport integration configure azure-oidc --proxy-public-addr=PROXY-PUBLIC-ADDR --auth-connector-name=AUTH-CONNECTOR-NAME [<flags>]

플래그:

플래그	기본값	설명
`--auth-connector-name`	없음	Teleport에서 Entra ID SAML 인증 커넥터의 이름.
`--[no-]access-graph`	`false`	Access Graph 통합을 활성화합니다.
`--[no-]skip-oidc-integration`	`false`	OIDC 통합을 건너뜁니다.
`--proxy-public-addr`	없음	Teleport 프록시 서비스의 공개 주소

teleport integration configure deployservice-iam#

AWS OIDC 배포 서비스에 필요한 IAM 역할을 생성합니다.

사용법:

$ teleport integration configure deployservice-iam --cluster=CLUSTER --name=NAME --aws-region=AWS-REGION --role=ROLE --task-role=TASK-ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.
`--task-role`	없음	배포된 서비스에 사용될 AWS 역할.

teleport integration configure ec2-ssm-iam#

SSM을 사용한 EC2 자동 검색을 활성화하기 위한 필수 IAM 권한 및 SSM 문서를 추가합니다.

사용법:

$ teleport integration configure ec2-ssm-iam --role=ROLE --aws-region=AWS-REGION --cluster=CLUSTER --name=NAME [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--cluster`	없음	Teleport 클러스터 이름.
`--name`	없음	통합 이름.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--proxy-public-url`	없음	프록시 공개 URL (예: https://mytenant.teleport.sh).
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할 이름.
`--ssm-document-name`	없음	teleport를 설치하는 데 사용될, 생성할 AWS SSM 문서 이름.

teleport integration configure eks-iam#

Teleport에 EKS 클러스터를 등록하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure eks-iam --aws-region=AWS-REGION --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure externalauditstorage#

External Audit Storage 로그에 필요한 인프라를 부트스트랩하고 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure externalauditstorage --aws-region=AWS-REGION --cluster-name=CLUSTER-NAME --integration=INTEGRATION --role=ROLE --policy=POLICY --session-recordings=SESSION-RECORDINGS --audit-events=AUDIT-EVENTS --athena-results=ATHENA-RESULTS --athena-workgroup=ATHENA-WORKGROUP --glue-database=GLUE-DATABASE --glue-table=GLUE-TABLE [<flags>]

플래그:

플래그	기본값	설명
`--athena-results`	없음	Athena 결과가 저장되는 S3 URI.
`--athena-workgroup`	없음	사용되는 Athena 워크그룹 이름.
`--audit-events`	없음	감사 이벤트가 저장되는 S3 URI.
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-partition`	`aws`	AWS 파티션 (기본값: aws).
`--aws-region`	없음	AWS 리전.
`--cluster-name`	없음	Teleport 클러스터 이름.
`--glue-database`	없음	사용되는 Glue 데이터베이스 이름.
`--glue-table`	없음	사용되는 Glue 테이블 이름.
`--integration`	없음	AWS OIDC 통합 이름.
`--[no-]bootstrap`	`false`	필수 인프라를 부트스트랩합니다.
`--policy`	없음	IAM 역할에 연결할 정책 이름.
`--role`	없음	AWS OIDC 통합에 사용되는 IAM 역할.
`--session-recordings`	없음	세션 녹화가 저장되는 S3 URI.

teleport integration configure listdatabases-iam#

RDS 데이터베이스(인스턴스 및 클러스터)를 나열하기 위한 필수 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure listdatabases-iam --aws-region=AWS-REGION --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--aws-region`	없음	AWS 리전.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--role`	없음	AWS OIDC 통합에 사용되는 AWS 역할.

teleport integration configure samlidp gcp-workforce#

GCP Workforce Identity Federation 풀 및 SAML 제공자를 구성합니다.

사용법:

$ teleport integration configure samlidp gcp-workforce --org-id=ORG-ID --pool-name=POOL-NAME --pool-provider-name=POOL-PROVIDER-NAME --idp-metadata-url=IDP-METADATA-URL

플래그:

플래그	기본값	설명
`--idp-metadata-url`	없음	Teleport SAML IdP 메타데이터 엔드포인트.
`--org-id`	없음	GCP 조직 ID.
`--pool-name`	없음	새 workforce identity 풀 이름.
`--pool-provider-name`	없음	새 workforce identity 풀 제공자 이름.

teleport integration configure session-summaries bedrock#

Amazon Bedrock을 사용하는 Session Summaries 기능에 필요한 IAM 권한을 추가합니다.

사용법:

$ teleport integration configure session-summaries bedrock --role=ROLE [<flags>]

플래그:

플래그	기본값	설명
`--aws-account-id`	없음	AWS 계정 ID.
`--[no-]confirm`	`false`	확인 프롬프트 없이 변경 사항을 적용합니다.
`--resource`	`*`	액세스 권한을 부여할 Amazon Bedrock 리소스. 전체 ARN 또는 모델 ID일 수 있습니다 (예: 'anthropic.claude-v2' 또는 모든 모델에 대해 '*').
`--role`	없음	AWS OIDC 통합에서 사용하는 AWS 역할 이름.

teleport join openssh#

SSH 서버를 Teleport 클러스터에 참여시킵니다.

사용법:

$ teleport join openssh [<flags>]

플래그:

플래그	기본값	설명
`--additional-principals`	없음	포함할 추가 주체. 여러 번 지정 가능.
`--address`	없음	이 OpenSSH 노드의 호스트명 또는 IP 주소.
`--data-dir`	`/var/lib/teleport`	teleport 데이터를 저장할 디렉터리 경로 [/var/lib/teleport].
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다.
`--join-method`	없음 (다음 중 하나: `token`, `iam`, `ec2`)	클러스터에 참여할 때 사용할 방법.
`--labels`	없음	이 OpenSSH 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]restart-sshd`	`true`	OpenSSH를 재시작합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--openssh-config`	`/etc/ssh/sshd_config`	OpenSSH 구성 파일 경로 [/etc/ssh/sshd_config].
`--proxy-server`	없음	프록시 서버 주소.
`--sshd-check-command`	`sshd -t -f`	OpenSSH 구성의 유효성을 확인할 때 사용할 커맨드. (sshd -t -f <sshd_config>)
`--sshd-restart-command`	없음	openssh를 재시작할 때 사용할 커맨드.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.

teleport node configure#

SSH 노드에 대한 구성 파일을 생성합니다.

사용법:

$ teleport node configure [<flags>]

플래그:

플래그	기본값	설명
`--auth-server`	없음	인증 서버 주소.
`--azure-client-id`	없음	참여할 관리 ID의 클라이언트 ID를 설정합니다. 'azure' 참여 방법에만 적용됩니다.
`--ca-pin`	없음	인증 서버를 검증하는 데 사용되는 CA의 SKPI 해시의 쉼표로 구분된 목록.
`--cluster-name`	없음	고유한 클러스터 이름, 예: example.com.
`--data-dir`	`/var/lib/teleport`	Teleport가 데이터를 보관하는 디렉터리 경로.
`--join-method`	`token` (다음 중 하나: `azure`, `azure_devops`, `bitbucket`, `circleci`, `ec2`, `gcp`, `github`, `gitlab`, `iam`, `kubernetes`, `spacelift`, `token`, `tpm`, `terraform_cloud`, `oracle`, `bound_keypair`, `env0`)	클러스터에 참여할 때 사용할 방법.
`--labels`	없음	새로 생성된 노드에 추가할 레이블의 쉼표로 구분된 목록, 예) env=staging,cloud=aws.
`--node-name`	없음	Teleport 노드 이름.
`--[no-]silent`	`false`	사용자 힌트 메시지를 억제합니다.
`-o`, `--output`	`stdout`	"--output=stdout"으로 stdout에 쓰기, "--output=file"로 기본 구성 파일, 또는 --output=file:///path로 사용자 지정 경로
`--proxy`	없음	프록시 서버 주소.
`--public-addr`	없음	노드가 SSH 엔드포인트에 알리는 호스트포트.
`--token`	없음	인증 서버에 등록하기 위한 초대 토큰 또는 토큰 값이 포함된 파일 경로.
`--version`	`v3`	Teleport 구성 버전.

teleport start#

Teleport 서비스를 시작합니다.

사용법:

$ teleport start [<flags>]

플래그:

플래그	기본값	설명
`--advertise-ip`	없음	NAT 뒤에서 실행 중인 경우 클라이언트에 알릴 IP
`--apply-on-startup`	없음	시작 시 적용할 리소스가 포함된 비어 있지 않은 YAML 파일 경로. --bootstrap과 달리 초기화된 클러스터에서 작동합니다. 다음 종류만 지원합니다: bot,cluster_auth_preference,cluster_networking_config,inference_model,inference_policy,inference_secret,retrieval_model,role,token,user,workload_identity.
`--auth-server`	없음	인증 서버 주소 [127.0.0.1:3025]
`--bootstrap`	없음	부트스트랩 리소스가 포함된 비어 있지 않은 YAML 파일 경로 (이미 초기화된 경우 무시)
`--ca-pin`	없음	인증 서버(Auth Server)를 검증하기 위한 CA 핀 (여러 핀을 위해 반복 지정 가능)
`-c`, `--config`	없음	구성 파일 경로 [/etc/teleport.yaml]
`--diag-addr`	없음	진단용 prometheus 및 healthz 엔드포인트를 시작합니다.
`-d`, `--[no-]debug`	`false`	stderr에 상세 로그 출력을 활성화합니다
`--labels`	없음	이 노드에 대한 레이블의 쉼표로 구분된 목록, 예: env=dev,app=web
`-l`, `--listen-ip`	없음	바인딩할 IP 주소 [0.0.0.0]
`--nodename`	없음	이 노드의 이름, 기본값은 호스트명
`--[no-]fips`	`false`	FedRAMP/FIPS 140 모드로 Teleport를 시작합니다.
`--[no-]insecure`	`false`	비보안 모드는 인증서 검증을 비활성화합니다.
`--[no-]insecure-no-tls`	`false`	웹 소켓에 대한 TLS를 비활성화합니다.
`--[no-]no-debug-service`	`false`	디버그 서비스를 비활성화합니다.
`--[no-]permit-user-env`	`false`	세션 생성 시 ~/.tsh/environment 읽기를 활성화합니다.
`--[no-]skip-version-check`	`false`	서버와 클라이언트 간의 버전 확인을 건너뜁니다.
`--pid-file`	없음	PID 파일의 전체 경로. 기본적으로 PID 파일이 생성되지 않습니다
`-r`, `--roles`	없음	시작할 역할의 쉼표로 구분된 목록 [proxy,node,auth,app,db]
`--token`	없음	초대 토큰 또는 토큰 값이 포함된 파일 경로. 인증 서버에 등록하는 데 사용 [없음]

teleport status#

현재 SSH 세션의 상태를 출력합니다.

사용법:

$ teleport status

teleport tpm identify#

시스템에서 감지된 TPM에 관련된 식별 정보를 출력합니다.

사용법:

$ teleport tpm identify

teleport version#

teleport 바이너리 버전을 출력합니다.

사용법:

$ teleport version [<flags>]

플래그:

플래그	기본값	설명
`--[no-]raw`	`false`	원시 teleport 버전 문자열을 출력합니다.