이 참조에서는 Teleport 데이터베이스 서비스를 관리하기 위한 일반적인 명령을 실행하는 방법을 보여줍니다:

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

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

  연결이 가능한지 확인하기 위해 tsh login 으로 로그인한 다음, 현재 자격 증명을 사용하여 tctl 명령어를 실행할 수 있는지 확인하십시오.

  예를 들어:

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

  클러스터에 연결할 수 있고 tctl status 명령어를 실행할 수 있다면, 현재 자격 증명을 사용하여 워크스테이션에서 후속 tctl 명령어를 실행할 수 있습니다.
  자신의 Teleport 클러스터를 호스팅하는 경우, Teleport Auth Service를 호스팅하는 컴퓨터에서 전체 권한으로 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

Database Service에 필요한 구성을 부트스트랩합니다. 제공된 구성을 읽어서 어떤 항목을 부트스트랩할지 결정합니다.

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

제공된 데이터베이스 유형에 기반하여 Database Service에 필요한 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 인증서, 클라이언트 인증서 및 Database Service와 셀프 호스팅 데이터베이스 인스턴스를 구성하는 데 사용되는 개인 키 파일을 생성합니다.

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 Database Service가 데이터베이스 서버에 연결할 수 있는 호스트 이름입니다. 두 번째 예제는 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 edit user/${TELEPORT_USER?}

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

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