이 가이드는 tctl의 명령어, 인수, 플래그에 대한 종합 목록을 제공합니다.

tctl은 클러스터 관리자가 노드, 사용자, 토큰, 인증서, 디바이스를 포함한 클러스터의 모든 리소스를 관리할 수 있는 CLI 도구입니다.

tctl은 새로운 사용자 역할 생성 또는 신뢰할 수 있는 클러스터 연결과 같이 클러스터의 동적 구성을 수정하는 데에도 사용할 수 있습니다.

tctl에 대한 개념적 개요는 tctl 시작하기를 참조하십시오.

$ tctl [<flags>] <command> [<args> ...]

전역 플래그:

전역 환경 변수:

tctl acl get#

액세스 목록에 대한 상세 정보를 가져옵니다.

사용법:

$ tctl acl get [<flags>] <access-list-name>

플래그:

인수:

tctl acl ls#

클러스터 액세스 목록을 나열합니다.

사용법:

$ tctl acl ls [<flags>]

플래그:

tctl acl users add#

액세스 목록에 사용자를 추가합니다.

사용법:

$ tctl acl users add [<flags>] <access-list-name> <user> [<expires>] [<reason>]

플래그:

인수:

tctl acl users ls#

액세스 목록의 멤버인 사용자를 나열합니다.

사용법:

$ tctl acl users ls [<flags>] <access-list-name>

플래그:

인수:

tctl acl users rm#

액세스 목록에서 사용자를 제거합니다.

사용법:

$ tctl acl users rm <access-list-name> <user>

인수:

tctl alerts ack#

클러스터 알림을 확인합니다.

사용법:

$ tctl alerts ack [<flags>] <id>

플래그:

인수:

tctl alerts ack ls#

확인된 클러스터 알림을 나열합니다.

사용법:

$ tctl alerts ack ls

tctl alerts create#

클러스터 알림을 생성합니다.

사용법:

$ tctl alerts create [<flags>] <message>

플래그:

인수:

tctl alerts delete#

클러스터 알림을 삭제합니다.

사용법:

$ tctl alerts delete <id>

인수:

tctl alerts list#

클러스터 알림을 나열합니다.

사용법:

$ tctl alerts list [<flags>]

플래그:

tctl apps ls#

클러스터에 등록된 모든 애플리케이션을 나열합니다.

사용법:

$ tctl apps ls [<flags>] [<labels>]

플래그:

인수:

tctl audit query create#

감사 쿼리를 생성합니다.

사용법:

$ tctl audit query create [<flags>] [<query>]

플래그:

인수:

tctl audit query exec#

감사 쿼리를 실행합니다.

사용법:

$ tctl audit query exec [<query>]

인수:

tctl audit query get#

감사 쿼리를 가져옵니다.

사용법:

$ tctl audit query get <name>

인수:

tctl audit query ls#

감사 쿼리를 나열합니다.

사용법:

$ tctl audit query ls

tctl audit query rm#

감사 쿼리를 제거합니다.

사용법:

$ tctl audit query rm <name>

인수:

tctl audit report get#

보안 보고서를 가져옵니다.

사용법:

$ tctl audit report get <name>

인수:

tctl audit report ls#

보안 보고서를 나열합니다.

사용법:

$ tctl audit report ls

tctl audit report run#

보안 보고서를 실행합니다.

사용법:

$ tctl audit report run <name>

인수:

tctl audit report state#

보안 보고서의 상태를 출력합니다.

사용법:

$ tctl audit report state <name>

인수:

tctl audit schema#

감사 쿼리 스키마를 출력합니다.

사용법:

$ tctl audit schema

tctl auth crl#

Teleport 인증 기관의 빈 인증서 해지 목록(CRL)을 내보냅니다.

사용법:

$ tctl auth crl --type=TYPE [<flags>]

플래그:

tctl auth export#

클러스터 CA 공개 인증서를 stdout으로 내보냅니다.

사용법:

$ tctl auth export [<flags>]

플래그:

tctl auth ls#

연결된 auth 서버를 나열합니다.

사용법:

$ tctl auth ls [<flags>]

플래그:

tctl auth rotate#

클러스터의 인증 기관을 로테이션합니다. 기본적으로 대화형 모드로 시작하며, 수동으로 로테이션 요청을 보내려면 --type을 제공하십시오.

사용법:

$ tctl auth rotate [<flags>]

플래그:

tctl auth sign#

지정된 사용자의 ID 파일을 생성합니다.

사용법:

$ tctl auth sign --out=OUT [<flags>]

플래그:

tctl autoupdate agents mark-done#

하나 또는 여러 그룹을 업데이트 완료로 표시합니다.

사용법:

$ tctl autoupdate agents mark-done [<groups>...]

인수:

tctl autoupdate agents report#

에이전트 자동 업데이트 보고서를 집계하고 버전별, 업데이트 그룹별 에이전트 수를 표시합니다.

사용법:

$ tctl autoupdate agents report

tctl autoupdate agents rollback#

하나 또는 여러 그룹을 롤백합니다.

사용법:

$ tctl autoupdate agents rollback [<groups>...]

인수:

tctl autoupdate agents start-update#

하나 또는 여러 그룹의 업데이트를 시작합니다.

사용법:

$ tctl autoupdate agents start-update [<flags>] [<groups>...]

플래그:

인수:

tctl autoupdate agents status#

에이전트 자동 업데이트 상태를 출력합니다.

사용법:

$ tctl autoupdate agents status

tctl autoupdate client-tools disable#

클라이언트 도구 자동 업데이트를 비활성화합니다. 클라이언트에 대상 버전으로 업데이트하라는 알림이 전송되지 않습니다.

사용법:

$ tctl autoupdate client-tools disable

tctl autoupdate client-tools enable#

클라이언트 도구 자동 업데이트를 활성화합니다. 클라이언트에 대상 버전으로 업데이트하라는 알림이 전송됩니다.

사용법:

$ tctl autoupdate client-tools enable

tctl autoupdate client-tools status#

클라이언트 도구 업데이트의 활성화/비활성화 여부와 지정된 형식의 대상 버전을 출력합니다.

사용법:

$ tctl autoupdate client-tools status [<flags>]

플래그:

tctl autoupdate client-tools target#

클라이언트 도구의 대상 버전을 설정합니다. 이 명령은 Teleport Cloud에서 지원되지 않습니다.

사용법:

$ tctl autoupdate client-tools target [<flags>] [<version>]

플래그:

인수:

tctl bots add#

클러스터에 새 인증서 갱신 봇을 추가합니다.

사용법:

$ tctl bots add [<flags>] <name>

플래그:

인수:

tctl bots instances add#

기존 봇에 새 인스턴스를 추가합니다.

사용법:

$ tctl bots instances add [<flags>] <name>

플래그:

인수:

tctl bots instances list#

봇 인스턴스를 나열합니다.

사용법:

$ tctl bots instances list [<flags>] [<name>]

플래그:

인수:

tctl bots instances show#

특정 봇 인스턴스에 대한 정보를 표시합니다.

사용법:

$ tctl bots instances show <id>

인수:

tctl bots ls#

클러스터에 등록된 모든 인증서 갱신 봇을 나열합니다.

사용법:

$ tctl bots ls

tctl bots rm#

클러스터에서 인증서 갱신 봇을 영구적으로 제거합니다.

사용법:

$ tctl bots rm <name>

인수:

tctl bots update#

기존 봇을 업데이트합니다.

사용법:

$ tctl bots update [<flags>] <name>

플래그:

인수:

tctl bound-keypair request-rotation#

다음 참가 시도에서 키 쌍 로테이션을 요청합니다.

사용법:

$ tctl bound-keypair request-rotation <name>

인수:

tctl create#

YAML 파일에서 Teleport 리소스를 생성하거나 업데이트합니다.

사용법:

$ tctl create [<flags>] [<filename>]

플래그:

인수:

tctl db ls#

클러스터에 등록된 모든 데이터베이스를 나열합니다.

사용법:

$ tctl db ls [<flags>] [<labels>]

플래그:

인수:

tctl desktop bootstrap#

Active Directory를 부트스트랩하기 위한 PowerShell 스크립트를 생성합니다.

사용법:

$ tctl desktop bootstrap

tctl desktop ls#

클러스터에 등록된 모든 데스크톱을 나열합니다.

사용법:

$ tctl desktop ls [<flags>]

플래그:

tctl devices add#

관리 디바이스를 등록합니다.

사용법:

$ tctl devices add [<flags>]

플래그:

tctl devices enroll#

새 디바이스 등록 토큰을 생성합니다.

사용법:

$ tctl devices enroll [<flags>]

플래그:

tctl devices lock#

디바이스를 잠급니다.

사용법:

$ tctl devices lock [<flags>]

플래그:

tctl devices ls#

관리 디바이스를 나열합니다.

사용법:

$ tctl devices ls [<flags>]

플래그:

tctl devices rm#

관리 디바이스를 제거합니다.

사용법:

$ tctl devices rm [<flags>]

플래그:

tctl edit#

Teleport 리소스를 편집합니다.

사용법:

$ tctl edit [<resource type/resource name>]

인수:

tctl get#

다양한 Teleport 리소스의 YAML 선언을 출력합니다.

사용법:

$ tctl get [<flags>] <resources>

플래그:

인수:

tctl help#

도움말을 표시합니다.

사용법:

$ tctl help [<command>...]

인수:

tctl idp saml test-attribute-mapping#

속성 매핑의 표현식 평가를 테스트합니다.

사용법:

$ tctl idp saml test-attribute-mapping --users=USERS --sp=SP [<flags>]

플래그:

tctl inventory list#

Teleport 인스턴스 인벤토리를 나열합니다.

사용법:

$ tctl inventory list [<flags>]

플래그:

tctl inventory ping#

로컬에서 연결된 인스턴스에 ping을 보냅니다.

사용법:

$ tctl inventory ping <server-id>

인수:

tctl inventory status#

인벤토리 상태 요약을 표시합니다.

사용법:

$ tctl inventory status [<flags>]

플래그:

tctl kube ls#

클러스터에 등록된 모든 Kubernetes 클러스터를 나열합니다.

사용법:

$ tctl kube ls [<flags>] [<labels>]

플래그:

인수:

tctl lock#

새 잠금을 생성합니다.

사용법:

$ tctl lock [<flags>]

플래그:

tctl login_rule test#

로그인 규칙의 파싱 및 평가를 테스트합니다.

사용법:

$ tctl login_rule test [<flags>] [<traits-file>]

플래그:

인수:

tctl nodes add#

노드 초대 토큰을 생성합니다.

사용법:

$ tctl nodes add [<flags>]

플래그:

tctl nodes ls#

클러스터 내의 모든 활성 SSH 노드를 나열합니다.

사용법:

$ tctl nodes ls [<flags>] [<labels>]

플래그:

인수:

tctl notifications create#

클러스터 알림을 생성합니다.

사용법:

$ tctl notifications create --title=TITLE --content=CONTENT [<flags>]

플래그:

tctl notifications ls#

tctl notifications create를 사용하여 수동으로 생성된 알림을 나열합니다. 기본적으로 역할 기반 알림과 같이 여러 사용자를 대상으로 할 수 있는 알림을 나열합니다. 특정 사용자에게만 전달되는 알림을 나열하려면 --user 플래그를 사용하십시오. Teleport에서 생성된 알림을 포함하려면 --all을 사용하십시오.

사용법:

$ tctl notifications ls [<flags>]

플래그:

tctl notifications rm#

클러스터 알림을 제거합니다.

사용법:

$ tctl notifications rm [<flags>] <id>

플래그:

인수:

tctl plugins cleanup#

지정된 플러그인 유형을 정리합니다.

사용법:

$ tctl plugins cleanup [<flags>] <type>

플래그:

인수:

tctl plugins delete#

플러그인 인스턴스를 제거합니다.

사용법:

$ tctl plugins delete [<name>]

인수:

tctl plugins edit awsic#

AWS IAM Identity Center 통합의 설정을 편집합니다.

사용법:

$ tctl plugins edit awsic [<flags>]

플래그:

tctl plugins install awsic#

AWS IAM Identity Center 통합을 설치합니다.

사용법:

$ tctl plugins install awsic --access-list-default-owner=ACCESS-LIST-DEFAULT-OWNER --scim-url=SCIM-URL --scim-token=SCIM-TOKEN --instance-region=INSTANCE-REGION --instance-arn=INSTANCE-ARN [<flags>]

플래그:

tctl plugins install entraid#

Microsoft Entra ID 통합을 설치합니다.

사용법:

$ tctl plugins install entraid --default-owner=DEFAULT-OWNER [<flags>]

플래그:

tctl plugins install github#

Access Graph Github 통합을 설치합니다.

사용법:

$ tctl plugins install github [<flags>]

플래그:

tctl plugins install netiq#

Access Graph NetIQ 통합을 설치합니다.

사용법:

$ tctl plugins install netiq [<flags>]

플래그:

tctl plugins install okta#

Okta 통합을 설치합니다.

사용법:

$ tctl plugins install okta --org=ORG --saml-connector=SAML-CONNECTOR [<flags>]

플래그:

tctl plugins install scim#

Teleport SCIM 플러그인을 설치합니다.

사용법:

$ tctl plugins install scim --connector=CONNECTOR [<flags>]

플래그:

tctl plugins rotate awsic#

AWS Identity Center SCIM 베어러 토큰을 로테이션합니다.

사용법:

$ tctl plugins rotate awsic [<flags>] TOKEN

플래그:

인수:

tctl proxy ls#

클러스터에 연결된 proxy를 나열합니다.

사용법:

$ tctl proxy ls [<flags>]

플래그:

tctl recordings download#

클러스터의 녹화 저장소에서 세션 녹화를 로컬 파일로 다운로드합니다. 출력 디렉터리를 생략하면 녹화가 현재 작업 디렉터리에 저장됩니다.

클러스터에서 세션 녹화 암호화가 활성화된 경우, 녹화는 다운로드 중에 복호화됩니다.

예시#

$ tctl recordings download [--output-dir <output-dir>] <session_id>

tctl recordings encryption complete-rotation#

진행 중인 암호화 키 로테이션을 완료합니다.

사용법:

$ tctl recordings encryption complete-rotation

tctl recordings encryption rollback-rotation#

진행 중인 암호화 키 로테이션을 롤백합니다.

사용법:

$ tctl recordings encryption rollback-rotation

tctl recordings encryption rotate#

세션 녹화 암호화에 사용되는 암호화 키를 로테이션합니다.

사용법:

$ tctl recordings encryption rotate

tctl recordings encryption status#

현재 로테이션 상태를 표시합니다.

사용법:

$ tctl recordings encryption status [<flags>]

플래그:

tctl recordings ls#

녹화된 세션을 나열합니다.

사용법:

$ tctl recordings ls [<flags>]

플래그:

tctl requests approve#

대기 중인 액세스 요청을 승인합니다.

사용법:

$ tctl requests approve [<flags>] <request-id>

플래그:

인수:

tctl requests create#

대기 중인 액세스 요청을 생성합니다.

사용법:

$ tctl requests create [<flags>] <username>

플래그:

인수:

tctl requests deny#

대기 중인 액세스 요청을 거부합니다.

사용법:

$ tctl requests deny [<flags>] <request-id>

플래그:

인수:

tctl requests get#

ID로 액세스 요청을 표시합니다.

사용법:

$ tctl requests get <request-id>

인수:

tctl requests ls#

활성 액세스 요청을 표시합니다.

사용법:

$ tctl requests ls [<flags>]

플래그:

tctl requests review#

액세스 요청을 검토합니다.

사용법:

$ tctl requests review --author=AUTHOR [<flags>] <request-id>

플래그:

인수:

tctl requests rm#

액세스 요청을 삭제합니다.

사용법:

$ tctl requests rm [<flags>] <request-id>

플래그:

인수:

tctl rm#

리소스를 삭제합니다.

사용법:

$ tctl rm [<resource type/resource name>]

인수:

\<resource type\>  리소스 유형 \[예: connector,user,cluster,token\]
\<resource name\>  삭제할 리소스 이름

예시:
$ tctl rm role/devs
$ tctl rm cluster/main|

tctl saml export#

SAML 서명 키를 .crt 형식으로 내보냅니다.

사용법:

$ tctl saml export <connector_name>

인수:

tctl scoped status#

범위가 지정된 리소스의 상태를 표시합니다

사용법:

$ tctl scoped status

tctl scoped tokens add#

범위가 지정된 초대 토큰을 생성합니다.

사용법:

$ tctl scoped tokens add --type=TYPE [<flags>]

플래그:

tctl scoped tokens ls#

초대 토큰을 나열합니다.

사용법:

$ tctl scoped tokens ls [<flags>]

플래그:

tctl scoped tokens rm#

범위가 지정된 초대 토큰을 삭제/취소합니다.

사용법:

$ tctl scoped tokens rm [<token>]

인수:

tctl sso configure github#

GitHub 인증 커넥터를 구성합니다.

사용법:

$ tctl sso configure github --teams-to-roles=org,team,role1,role2,... --id=ID --secret=SECRET [<flags>]

플래그:

tctl sso configure oidc#

OIDC 인증 커넥터를 구성합니다. 선택적으로 프리셋 사용. 사용 가능한 프리셋: [google gitlab okta].

사용법:

$ tctl sso configure oidc --claims-to-roles=name,value,role1,role2,... --secret=SECRET [<flags>]

플래그:

tctl sso configure saml#

SAML 인증 커넥터를 구성합니다. 선택적으로 프리셋 사용. 사용 가능한 프리셋: [okta onelogin ad adfs].

사용법:

$ tctl sso configure saml --attributes-to-roles=ATTRIBUTES-TO-ROLES [<flags>]

플래그:

tctl sso test#

제공된 인증 커넥터 정의를 사용하여 SSO 흐름의 종단 간 테스트를 수행합니다.

사용법:

$ tctl sso test [<flags>] [<filename>]

플래그:

인수:

tctl stable-unix-users ls#

클러스터에 현재 지속된 안정적인 UNIX 사용자를 나열합니다.

사용법:

$ tctl stable-unix-users ls [<flags>]

플래그:

tctl status#

클러스터 상태를 보고합니다.

사용법:

$ tctl status

tctl terraform env#

인증서를 획득하고 환경 변수에 로드합니다. 임시 MachineID 봇을 생성합니다.

사용법:

$ tctl terraform env [<flags>]

플래그:

tctl tokens add#

초대 토큰을 생성합니다.

사용법:

$ tctl tokens add --type=TYPE [<flags>]

플래그:

tctl tokens configure-kube#

Kubernetes 클러스터의 워크로드가 Teleport 클러스터에 참가할 수 있는 토큰을 생성합니다.

사용법:

$ tctl tokens configure-kube --service-account=SERVICE-ACCOUNT [<flags>]

플래그:

tctl tokens ls#

노드 및 사용자 초대 토큰을 나열합니다.

사용법:

$ tctl tokens ls [<flags>]

플래그:

tctl tokens rm#

초대 토큰을 삭제/취소합니다.

사용법:

$ tctl tokens rm [<token>]

인수:

tctl top#

진단 정보를 보고합니다.

사용법:

$ tctl top [<diag-addr>] [<refresh>]

인수:

tctl update#

리소스 필드를 업데이트합니다.

사용법:

$ tctl update [<flags>] [<resource type/resource name>]

플래그:

인수:

\<resource type\>  리소스 유형 \[예: rc\]
\<resource name\>  업데이트할 리소스 이름

예시:
$ tctl update rc/remote|

tctl users add#

사용자 초대 토큰을 생성합니다 [Teleport 로컬 사용자만 해당].

사용법:

$ tctl users add --roles=ROLES [<flags>] <account>

플래그:

인수:

tctl users ls#

모든 사용자 계정을 나열합니다.

사용법:

$ tctl users ls

tctl users reset#

사용자 비밀번호를 초기화하고 새 토큰을 생성합니다 [Teleport 로컬 사용자만 해당].

사용법:

$ tctl users reset [<flags>] <account>

플래그:

인수:

tctl users rm#

사용자 계정을 삭제합니다.

사용법:

$ tctl users rm <logins>

인수:

tctl users update#

사용자 계정을 업데이트합니다.

사용법:

$ tctl users update [<flags>] <account>

플래그:

인수:

tctl version#

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

사용법:

$ tctl version

tctl workload-identity ls#

워크로드 ID 구성을 나열합니다.

사용법:

$ tctl workload-identity ls

tctl workload-identity revocations add#

새 해지를 생성합니다.

사용법:

$ tctl workload-identity revocations add --serial=SERIAL --type=TYPE --reason=REASON [<flags>]

플래그:

tctl workload-identity revocations crl#

기존 해지에 대한 서명된 CRL을 가져옵니다.

사용법:

$ tctl workload-identity revocations crl [<flags>]

플래그:

tctl workload-identity revocations ls#

해지를 나열합니다.

사용법:

$ tctl workload-identity revocations ls

tctl workload-identity revocations rm#

해지를 삭제합니다.

사용법:

$ tctl workload-identity revocations rm --serial=SERIAL --type=TYPE

플래그:

tctl workload-identity rm#

워크로드 ID 구성을 삭제합니다.

사용법:

$ tctl workload-identity rm <name>

인수:

tctl workload-identity x509-issuer-overrides create#

지정된 인증서 체인에서 발급자 재정의를 생성합니다.

사용법:

$ tctl workload-identity x509-issuer-overrides create [<flags>] <fullchain.pem>...

플래그:

인수:

tctl workload-identity x509-issuer-overrides sign-csrs#

SPIFFE X.509 CA 키로 CSR에 서명합니다.

사용법:

$ tctl workload-identity x509-issuer-overrides sign-csrs [<flags>]

플래그: