이 참조는 Teleport 데이터베이스 서비스 관리를 위한 일반적인 명령 실행 방법을 보여줍니다. 포함된 내용:

• Teleport 데이터베이스 서비스를 실행할 호스트에서 실행되는 teleport 데몬 명령입니다.

• Teleport 클러스터에서 알려진 데이터베이스를 나타내는 db 리소스를 관리하는 데 사용하는 tctl 관리 도구입니다.

  당신의 Teleport 클러스터에 연결할 수 있는지 확인하려면, tsh login으로 로그인한 다음 현재 자격 증명을 사용하여 tctl 명령어를 실행할 수 있는지 확인하십시오.

  예를 들어:

  tsh login --proxy=teleport.example.com --user=email@example.com
  tctl status
  클러스터  teleport.example.com
  버전  16.2.0
  CA 핀   sha256:abdc1245efgh5678abdc1245efgh5678abdc1245efgh5678abdc1245efgh5678

  클러스터에 연결하고 tctl status 명령어를 실행할 수 있다면, 현재 자격 증명을 사용하여 작업대에서 후속 tctl 명령어를 실행할 수 있습니다.

  자신의 Teleport 클러스터를 호스팅하는 경우, Teleport 인증 서비스를 호스팅하는 컴퓨터에서 전체 권한으로 tctl 명령어를 실행할 수도 있습니다.

• 클러스터의 데이터베이스에 접근하기 위해 최종 사용자가 실행하는 tsh 클라이언트 도구입니다.

teleport db start

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

teleport db start \    --token=/path/to/token \    --auth-server=proxy.example.com:3080 \    --name=example \    --protocol=postgres \    --uri=postgres.example.com:5432

teleport db start \    --token=/path/to/token \    --auth-server=mytenant.teleport.sh:443 \    --name=example \    --protocol=postgres \    --uri=postgres.mytenant.teleport.sh:5432

teleport db configure create

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

teleport db configure create --rds-discovery=us-west-1 --rds-discovery=us-west-2
teleport db configure create \  --token=/tmp/token \  --proxy=proxy.example.com:3080 \  --name=example \  --protocol=postgres \  --uri=postgres://postgres.example.com:5432 \  --labels=env=prod

teleport db configure create --rds-discovery=us-west-1 --rds-discovery=us-west-2
teleport db configure create \  --token=/tmp/token \  --proxy=mytenant.teleport.sh:443 \  --name=example \  --protocol=postgres \  --uri=postgres://postgres.mytenant.teleport.sh:5432 \  --labels=env=prod

teleport db configure bootstrap

데이터베이스 서비스의 필요한 구성을 부트스트랩합니다. 제공된 구성을 읽어 무엇을 부트스트랩할지 결정합니다.

teleport db configure bootstrap -c /etc/teleport.yaml --attach-to-user TeleportUser
teleport db configure bootstrap -c /etc/teleport.yaml --attach-to-role TeleportRole
teleport db configure bootstrap -c /etc/teleport.yaml --manual

teleport db configure aws print-iam

제공된 데이터베이스 유형에 따라 데이터베이스 서비스에 필요한 IAM 권한을 출력합니다.

teleport db configure aws print-iam --types rds
teleport db configure aws print-iam --types rds,redshift --role my-db-service-role
teleport db configure aws print-iam --types redshift-serverless --assumes-roles my-access-role --policy

tctl auth sign

--format=db (또는 MongoDB의 경우 --format=mongodb) 플래그와 함께 호출되면, 데이터베이스 서비스를 자가 호스팅된 데이터베이스 인스턴스와 구성하는 데 필요한 CA 인증서, 클라이언트 인증서 및 개인 키 파일을 생성합니다.

tctl auth sign --format=db --host=db.example.com --out=db --ttl=2190h
tctl auth sign --format=db --host=host1,localhost,127.0.0.1 --out=db --ttl=2190h

이 예에서 db.example.com은 Teleport 데이터베이스 서비스가 데이터베이스 서버에 연결하는 데 사용하는 호스트 이름입니다. 두 번째 예에서는 Teleport와 동일한 호스트에서 실행 중인 데이터베이스를 가정합니다.

kind: role
version: v5
metadata:
  name: db-impersonator
spec:
  options:
  allow:
    impersonate:
      users: ['Db']
      roles: ['Db']

tctl create -f db-impersonator.yaml

TELEPORT_USER=<your user>
tctl get user/${TELEPORT_USER?} > myuser.yaml

spec:
   - access
   - auditor
   - editor
+  - db-impersonator
   status:
     is_locked: false

tctl create -f myuser.yaml

tctl db ls

클러스터에 등록된 모든 데이터베이스를 나열하는 관리 명령입니다.

tctl db ls
tctl db ls --format=yaml

tctl get db

구성된 모든 데이터베이스 리소스를 출력합니다.

tctl get db/database-resource-name

database-resource-name 데이터베이스 리소스에 대한 세부 정보를 출력합니다.

tctl rm db/database-resource-name

database-resource-name이라는 데이터베이스 리소스를 제거합니다.

tsh db ls

사용 가능한 데이터베이스와 해당 연결 정보를 나열합니다.

tsh db ls

사용자가 액세스할 수 있는 데이터베이스만 표시됩니다 (참조: RBAC).

tsh db login

데이터베이스 자격 증명을 검색합니다.

tsh db login example
tsh db login --db-user=postgres --db-name=postgres example

데이터 입력: --db-user 또는 --db-name이 필요하면, 기본 설정은 이전에 tsh db login을 사용하여 얻은 활성 데이터베이스 인증서 또는 사용자의 허용된 db_users 또는 db_names에서 선택됩니다.

데이터베이스 사용자는 항상 필요합니다.

PostgreSQL, MongoDB 및 Oracle 데이터베이스의 경우 데이터베이스 이름이 필요합니다.

tsh db logout

데이터베이스 자격 증명을 제거합니다.

tsh db logout example
tsh db logout

tsh db connect

CLI 클라이언트를 사용하여 데이터베이스에 연결합니다.

단일 데이터베이스에 로그인할 때 짧은 구문.
tsh db connect
명시적으로 연결할 데이터베이스 서비스를 지정합니다.
tsh db connect example
연결할 데이터베이스 사용자 및 이름을 제공합니다.
tsh db connect --db-user=alice --db-name=db example
허용된 데이터베이스 역할의 하위 집합을 선택합니다.
tsh db connect --db-user=alice --db-name=db --db-roles reader example

데이터 입력: --db-user 또는 --db-name이 필요하면, 기본 설정은 이전에 tsh db login을 사용하여 얻은 활성 데이터베이스 인증서 또는 사용자의 허용된 db_users 또는 db_names에서 선택됩니다.

데이터베이스 사용자는 항상 필요합니다.

PostgreSQL, MongoDB 및 Oracle 데이터베이스의 경우 데이터베이스 이름이 필요합니다.

tsh db env

특정 데이터베이스에 대한 환경 변수를 출력합니다.

tsh db env
tsh db env example
eval $(tsh db env)

tsh db config

데이터베이스 연결 정보를 출력합니다. GUI 클라이언트를 구성할 때 유용합니다.

tsh db config
tsh db config example
tsh db config --format=cmd example