Beams 데이터베이스 데모
Teleport v18.11요약
Teleport Beams를 사용하면 AI 에이전트가 비결정적인 접근 패턴으로 피해를 일으키는 것을 방지하기 위해 제한된 권한으로 데이터베이스에 접근하도록 허용할 수 있습니다. 이 가이드에서는 데이터베이스를 Teleport에 등록하고 AI 에이전트가 Teleport beam에서 데이터베이스에 접근하도록 프롬프트를 입력합니다.
Teleport Beams를 사용하면 AI 에이전트가 비결정적인 접근 패턴으로 피해를 일으키는 것을 방지하기 위해 제한된 권한으로 데이터베이스에 접근하도록 허용할 수 있습니다.
이 가이드에서는 데이터베이스를 Teleport에 등록하고 AI 에이전트가 Teleport beam에서 데이터베이스에 접근하도록 프롬프트를 입력합니다. 이 가이드에서 보여 주듯이 Teleport RBAC으로 데이터베이스에 대한 접근을 제한하면 에이전트가 데이터베이스에서 예상된 범위의 작업만 수행할 수 있습니다.
작동 방식#
Teleport Beams는 Teleport Cloud 인프라에서 호스팅되며 에이전트 워크로드를 실행하는 마이크로 VM 샌드박스입니다. 사용자가 beam을 생성하면 Teleport Auth 서비스는 사용자와 해당 사용자의 Teleport 역할을 포함하는 위임 세션을 생성합니다.
beam의 tbot 데몬 인스턴스는 위임 세션의 ID를 받아 Auth 서비스에 질의하여 beam에서
실행되는 서비스에 새 Teleport 아이덴티티를 발급합니다. 그 결과 beam에서 실행되는 모든
에이전트 워크로드는 beam을 시작한 사용자의 Teleport 권한을 위임받습니다.
Teleport로 보호되는 데이터베이스의 경우, beam을 생성한 사용자가 해당 데이터베이스에 접근할 권한이 있다면 beam에서 AI 에이전트를 실행하여 그 데이터베이스에 접근할 수 있습니다. Teleport RBAC으로 에이전트 워크로드가 데이터베이스에 접근할 때 갖는 권한을 제한할 수 있습니다.
사전 요구사항#
Teleport Beams 계정이 필요합니다. 무료 체험을 시작하십시오.
이 가이드는 간단하게 진행하기 위해 로컬 PostgreSQL 컨테이너를 Teleport 클러스터에 등록하고 해당 데이터베이스의 RBAC을 구성하는 데모를 안내합니다. Beams는 Teleport로 보호되는 모든 데이터베이스를 지원하며 PostgreSQL 클라이언트 도구가 기본으로 포함되어 있습니다.
로컬 데모를 따라 하려면 다음이 필요합니다.
- 워크스테이션에 설치된 Docker
Teleport cluster에 연결할 수 있는지 확인하려면 tsh login으로 로그인한 다음,
현재 자격 증명으로 tctl 명령을 실행할 수 있는지 확인합니다.
예를 들어, teleport.example.com에 cluster 내 Teleport Proxy Service의
도메인 이름을, email@example.com에 Teleport 사용자 이름을 지정하여
다음 명령을 실행합니다:
$ tsh login --proxy=teleport.example.com --user=email@example.com
$ tctl status
# Cluster (=teleport.url=)
# Version (=teleport.version=)
# CA pin (=presets.ca_pin=)
cluster에 연결하여 tctl status 명령을 실행할 수 있다면, 현재 자격 증명을 사용하여
워크스테이션에서 이후의 tctl 명령을 실행할 수 있습니다.
자체 Teleport cluster를 호스팅하는 경우, 전체 권한을 얻기 위해 Teleport Auth Service를
호스팅하는 컴퓨터에서 tctl 명령을 실행할 수도 있습니다.
1/3단계. Teleport에 데이터베이스 등록#
이 섹션에서는 데이터베이스를 Teleport에 등록하고 해당 데이터베이스의 RBAC을 구성합니다. Beams의 동작을 확인하기 위해 먼저 이 최소 예제를 따라 해 보시기를 권장합니다.
이미 데이터베이스가 등록되어 있고 Teleport RBAC을 이해하고 있다면 이 섹션은 필요하지 않습니다. AI 에이전트에게 부여할 데이터베이스와 역할이 있다면 2단계로 건너뜁니다.
로컬 데모 데이터베이스 시작#
-
워크스테이션에서 PostgreSQL 컨테이너에 마운트할 TLS 자격 증명용 로컬 디렉터리를 생성합니다.
$ mkdir certs -
PostgreSQL 컨테이너가 Teleport Database 서비스를 신뢰하는 데 사용할 mTLS 자격 증명을 가져옵니다.
$ tctl auth sign --format=db --host=postgres --out=certs/server --ttl=2160h
더 짧은 TTL을 사용하는 것을 권장하지만, 연결 기능을 잃지 않으려면 데이터베이스 서버 인증서가 만료되기 전에 갱신해야 한다는 점에 유의하십시오. 사용 사례에 가장 적합한 TTL 값을 선택하십시오.
이 명령은 3개의 파일을 생성합니다.
server.cas: 데이터베이스가 Teleport Database 서비스의 연결을 검증하는 데 사용하는 Database Client CA 인증서입니다.server.crt: Database CA가 서명한 데이터베이스 서버용 인증서입니다.server.key: 서버 인증서의 개인 키입니다.
-
PostgreSQL 컨테이너와 Teleport Database 서비스를 위한 로컬 Docker 브리지 네트워크를 생성합니다.
$ docker network create local-postgres -
PostgreSQL 컨테이너의 슈퍼유저 계정에 사용할 강력한 비밀번호를 생성합니다. PostgreSQL 컨테이너를 실행할 터미널에서 해당 비밀번호를 내보냅니다.
$ export POSTGRES_PASSWORD=<strong generated password> -
로컬 브리지 네트워크에 연결하고 생성한 TLS 자격 증명을 마운트하여 데이터베이스 컨테이너를 시작합니다.
이 명령은 이미지가 요구하므로 컨테이너에
POSTGRES_PASSWORD환경 변수를 지정하지만, 컨테이너는 인증에 인증서를 강제하도록 구성합니다. 또한 Teleport가 발급한 자격 증명으로 TLS를 활성화하며,postgres데몬의 요구에 맞게 해당 파일의 소유권을 변경합니다. Docker가 바인드 마운트를 생성할 때 예기치 않은 소유권 변경이 발생하지 않도록 이 작업은 컨테이너 내부에서 수행합니다.$ docker run -d \ --name postgres \ -e POSTGRES_PASSWORD \ -v ./certs:/certs \ --network local-postgres \ --entrypoint bash \ postgres:18 \ -c "chown 999:999 /certs/server.key \ && chmod 600 /certs/server.key \ && chmod 644 /certs/server.crt /certs/server.cas \ && exec docker-entrypoint.sh postgres \ -c ssl=on \ -c ssl_cert_file=/certs/server.crt \ -c ssl_key_file=/certs/server.key \ -c ssl_ca_file=/certs/server.cas" -
호스트 기반 인증용 PostgreSQL 구성 파일을 편집하고 구성 리로드를 실행하여 모든 연결에 TLS를 요구합니다. 이렇게 하면 컨테이너 내부에서 데이터베이스로 들어오는 모든 연결이 인증됩니다.
$ docker exec postgres bash -c "echo 'local all all trust' > /var/lib/postgresql/18/docker/pg_hba.conf" $ docker exec postgres bash -c "echo 'hostssl all all 0.0.0.0/0 cert' >> /var/lib/postgresql/18/docker/pg_hba.conf" $ docker exec postgres psql -U postgres -c "SELECT pg_reload_conf()"
로컬 데모 데이터베이스 구성#
로컬 데모 데이터베이스가 실행되면 데모를 지원하도록 설정합니다. 모든 데이터베이스 작업을
수행할 수 있는 관리자와 단일 테이블에 대해 SELECT 쿼리만 실행할 수 있는 읽기 전용
사용자, 이렇게 두 사용자를 포함합니다.
-
관리자 역할을 생성합니다.
$ docker exec postgres psql -U postgres -c "CREATE ROLE admin LOGIN SUPERUSER" -
예제 데이터를 보관할 테이블과 해당 테이블을 조회할 수 있는 읽기 전용 역할을 생성합니다.
$ docker exec postgres psql -U postgres -c "CREATE TABLE users (id INT PRIMARY KEY, name TEXT, ssn TEXT)" $ docker exec postgres psql -U postgres -c "CREATE ROLE readonly LOGIN" $ docker exec postgres psql -U postgres -c "GRANT CONNECT ON DATABASE postgres TO readonly" $ docker exec postgres psql -U postgres -c "GRANT SELECT ON users TO readonly" -
예제 데이터를 추가합니다.
$ docker exec postgres psql -U postgres -c "INSERT INTO users (id, name, ssn) VALUES (123, 'alice', '000-00-0000')"
Teleport Database 서비스 시작#
다음으로 워크스테이션에서 Teleport Database 서비스를 컨테이너로 시작합니다. Teleport Database 서비스 컨테이너는 클러스터의 Teleport Proxy 서비스로 SSH 리버스 터널을 시작합니다. beam에서 실행할 AI 에이전트가 데이터베이스에 접속하면 트래픽이 이 리버스 터널을 통해 흐릅니다.
-
Teleport Database 서비스가 Teleport 클러스터와 신뢰를 설정하는 데 사용할 토큰을 생성합니다.
워크스테이션에서 다음 명령을 실행하여 조인 토큰을 가져오고, Database 서비스를 시작할 때 사용할
dbtoken파일에 기록합니다.$ tctl tokens add --type=db --ttl=15m --format=text > dbtoken -
터미널의 현재 작업 디렉터리에
db-service-config.yaml경로로 Teleport Database 서비스용 구성 파일을 작성합니다. 다음 명령에서example.beams.sh를 Teleport Proxy 서비스의 주소로 바꿉니다.$ teleport db configure create \ -o file:///$(pwd)/db-service-config.yaml \ --token=/tmp/token \ --proxy='example.beams.sh:443' \ --name=local-postgres \ --protocol=postgres \ --uri=postgres:5432 \ --labels=service=local-postgresTeleport Database 서비스는
/tmp/token에서 토큰을 읽습니다. 이는 앞서 생성한 토큰을 마운트할 컨테이너 내부 경로입니다. -
앞서 시작한 PostgreSQL 컨테이너와 같은 로컬 Docker 네트워크에서 Teleport Database 서비스를 시작합니다.
$ docker run \ -v ./db-service-config.yaml:/etc/teleport/teleport.yaml \ -v ./dbtoken:/tmp/token \ --network local-postgres \ (=teleport.latest_oss_docker_image=) -
1~2분 후 Teleport가 PostgreSQL 인스턴스를 프록시하는지 확인합니다.
$ tsh db ls Name Description Allowed Users Labels Connect -------------- ----------- ------------- ---------------------- ------- local-postgres (none) service=local-postgres
데이터베이스용 RBAC 구성#
이 데모 설정에서는 AI 에이전트가 권한이 제한된 역할로만 PostgreSQL 인스턴스에 접근하도록 합니다. beam에서 실행되는 AI 에이전트는 beam에 접속한 사용자의 Teleport 역할로 Teleport로 보호되는 리소스에 접근합니다.
이 섹션에서는 읽기 전용 사용자로 데이터베이스에 접근할 수 있는 사용자와 역할을 생성합니다.
-
읽기 전용 사용자로만 데이터베이스에 접근할 수 있는 역할을 정의합니다. 다음 내용으로
read-only-demo-postgres.yaml파일을 생성합니다.version: v8 kind: role metadata: name: read-only-demo-postgres spec: allow: db_labels: service: local-postgres db_users: - readonly db_names: - postgres -
역할을 생성합니다.
$ tctl create -f read-only-demo-postgres.yaml -
read-only-demo-postgres역할을 가진dbdemo사용자를 생성합니다.$ tctl users add --roles=read-only-demo-postgres,beam-user dbdemo -
터미널의 안내에 따라 사용자를 활성화합니다.
2/3단계. beam 준비#
Teleport에 데이터베이스를 등록하고 AI 에이전트 사용자를 위한 역할을 만들었다면 beam을 생성하고, beam에 SSH 세션을 시작한 다음, 에이전트가 데이터베이스에 접근하도록 프롬프트를 입력할 수 있습니다.
-
이전 단계에서 생성한
dbdemo사용자로 Teleport에 인증하고 자격 증명을 입력합니다.$ tsh login --proxy=example.beams.sh --user=dbdemo -
beam을 생성하고 접속합니다.
$ tsh beams add
이 명령은 새 beam에 SSH 세션을 시작합니다.
다음 단계를 진행하는 동안 beam 셸 세션을 유지합니다.
3/3단계. 에이전트에 프롬프트 입력#
에이전트가 데이터베이스에 접근하도록 프롬프트를 입력합니다.
-
LLM CLI를 시작합니다. beam은
claude와codex가 사전 설치된 상태로 초기화됩니다. 권한 프롬프트를 건너뛰는 LLM 에이전트 세션을 시작합니다. 에이전트가 예기치 않은 작업을 수행하더라도 Teleport RBAC으로 설정한 제한을 넘는 작업은 수행할 수 없습니다. 다음 명령 중 하나를 실행합니다.$ claude --dangerously-skip-permissions또는 다음을 실행합니다.
$ codex --dangerously-bypass-approvals-and-sandbox -
다음 프롬프트를 입력합니다.
Access the PostgreSQL database with name local-postgres. Retrieve the SSN of user alice and update it to 999-99-9999.
LLM은 현재 SSN을 찾는 데는 성공하지만 업데이트에는 실패해야 합니다. 다음은 에이전트 요약의 한 예시입니다.
● The readonly user doesn't have write permissions. That's the only allowed database user according to the
Teleport configuration. I'm unable to perform the UPDATE — the database role readonly only has SELECT
privileges on the users table.
Summary:
- Alice's current SSN is 000-00-0000 (id: 123)
- The UPDATE to 999-99-9999 failed because the only available database user (readonly) lacks write permissions
on the users table
To complete the update, you'd need a database user with write privileges to be added to the Teleport database
configuration.