Teleport는 서버에 대한 SSH 접근을 보호하고 제어합니다. 머신 및 워크로드 아이덴티티를 사용하여 머신에 이러한 서버에 대한 안전하고 단기적인 접근을 허용할 수 있습니다.

이 가이드에서는 Teleport에 등록된 Linux 서버에 접근하는 데 사용할 수 있는 자격 증명을 생성하도록 tbot을 설정합니다. 가이드는 Teleport CLI tsh 및 OpenSSH 클라이언트를 사용한 접근을 다룹니다.

사전 조건#

• 실행 중인 Teleport 클러스터. Teleport를 시작하려면 무료 체험판에 가입하거나 데모 환경을 구성하세요.

• tctl and tsh clients.

  Installing `tctl` and `tsh` clients

  1. Teleport 클러스터의 버전을 확인합니다. tctl and tsh clients는 Teleport 클러스터 버전보다 최대 한 개의 메이저 버전까지만 뒤처질 수 있습니다. Proxy Service의 /v1/webapi/find로 GET 요청을 보내고 JSON 쿼리 도구를 사용하여 클러스터 버전을 확인합니다. teleport.example.com:443를 Teleport Proxy Service의 웹 주소로 바꿉니다:

     $ TELEPORT_DOMAIN=teleport.example.com:443
     $ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
     

  2. 사용 중인 플랫폼에 대한 지침에 따라 tctl and tsh clients를 설치합니다:

Mac

     `tctl` and `tsh` clients가 포함된, 서명된 Teleport macOS .pkg 설치 프로그램을 다운로드합니다:
 
     ```code
     $ curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION?}.pkg
     ```

     Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다.
 
     

       Homebrew를 사용하여 Teleport를 설치하는 것은 지원되지 않습니다. Homebrew의
       Teleport 패키지는 Teleport에서 유지 관리하지 않으므로 신뢰성이나 보안을
       보장할 수 없습니다.
     

Windows - Powershell

     ```code
     $ curl.exe -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-windows-amd64-bin.zip
     # Unzip the archive and move the `tctl` and `tsh` clients to your %PATH%
     # NOTE: Do not place the `tctl` and `tsh` clients in the System32 directory, as this can cause issues when using WinSCP.
     # Use %SystemRoot% (C:\Windows) or %USERPROFILE% (C:\Users\<username>) instead.
     ```
 
   

 
   

Linux

     Linux 설치판의 모든 Teleport 바이너리에는 `tctl` and `tsh` clients가 포함되어 있습니다.  RPM/DEB
     패키지 및 i386/ARM/ARM64용 다운로드를 포함한 더 많은 옵션은
     [설치 페이지](../installation/installation.mdx)를 참조하세요.
 
     ```code
     $ curl -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
     $ tar -xzf teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
     $ cd teleport
     $ sudo ./install
     # Teleport binaries have been copied to /usr/local/bin
     ```
   

 

• 아직 서버를 Teleport에 연결하지 않았다면 시작하기 가이드를 따라 진행하세요.

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 명령을 실행할 수도 있습니다.

• SSH로 Linux 호스트에 연결할 머신에 tbot이 이미 설치되어 설정되어 있어야 합니다. 자세한 내용은 배포 가이드를 참조하세요.

1/3단계. RBAC 설정#

먼저, 봇이 생성한 자격 증명이 인프라 내 SSH 서버에 연결할 수 있도록 Teleport를 설정해야 합니다. 이 예시에서는 사용자 이름 root로 모든 SSH 노드에 대한 접근이 허용됩니다. 이는 필요한 권한을 부여하는 역할을 생성한 뒤 이 역할을 봇에 할당하는 방식으로 이루어집니다.

다음 내용으로 role.yaml 파일을 생성하세요:

kind: role
version: v6
metadata:
  name: example-role
spec:
  allow:
    # Allow login to the Linux user 'root'.
    logins: ['root']
    # Allow connection to any node. Adjust these labels to match only nodes
    # needed to access.
    node_labels:
      '*': '*'

example-role을 사용 사례와 관련된 설명적인 이름으로 바꾸세요.

또한 자격 증명으로 어떤 명령을 실행해야 하는지에 따라 root가 아닌 다른 사용자에게 접근을 부여하도록 조정할 수 있습니다.

프로덕션 환경에서 사용할 경우, 봇이 접근해야 하는 호스트로만 접근을 제한하도록 node_labels를 조정해야 합니다. 이는 최소 권한 원칙으로 알려져 있으며 유출된 자격 증명이 끼칠 수 있는 피해를 제한합니다.

역할을 생성하려면 tctl create -f ./role.yaml을 사용하세요.

이제 tctl bots update를 사용하여 봇에 역할을 추가합니다. example을 배포 가이드에서 생성한 봇의 이름으로, example-role을 방금 생성한 역할의 이름으로 바꾸세요:

$ tctl bots update example --add-roles example-role

2/3단계. tbot 출력 서비스 설정#

이제 SSH 인증서와 OpenSSH 설정을 생성할 서비스로 tbot을 설정해야 합니다. 이를 위해 identity 출력 서비스 유형을 사용합니다.

출력 서비스는 대상(destination)과 함께 설정되어야 합니다. 이 예시에서는 directory 대상을 사용합니다. 이는 디스크의 지정된 디렉터리에 이러한 자격 증명을 기록합니다. 이 디렉터리는 tbot이 실행되는 Linux 사용자가 쓸 수 있고, SSH를 사용해야 하는 Linux 사용자가 읽을 수 있어야 합니다.

tbot 설정을 수정하여 identity 서비스를 추가하세요:

services:
- type: identity
  destination:
    type: directory
    # For this guide, /opt/machine-id is used as the destination directory.
    # You may wish to customize this. Multiple outputs cannot share the same
    # destination.
    path: /opt/machine-id

3/3단계. 출력 자격 증명 사용#

tbot이 실행되거나 재시작되면 이제 /opt/machine-id 아래에서 다음과 같은 여러 파일을 확인할 수 있습니다:

• identity: tsh가 인증에 사용할 수 있는 자격 증명 묶음입니다.
• ssh_config: OpenSSH 및 기타 도구와 함께 사용하여 연결 시 올바른 자격 증명으로 Teleport 프록시 서비스를 사용하도록 이러한 도구를 설정하는 데 사용할 수 있습니다.
• known_hosts: Teleport SSH 호스트 CA를 포함하고 있으며 SSH 클라이언트가 호스트의 인증서를 검증할 수 있도록 합니다.
• key-cert.pub: Teleport SSH 사용자 CA가 서명한 SSH 인증서입니다.
• key: SSH 인증서를 사용하는 데 필요한 개인 키입니다.

이러한 자격 증명은 Teleport의 CLI tsh와 함께, 또는 ssh와 sftp 같은 OpenSSH 클라이언트 도구와 함께 사용할 수 있습니다.

tsh를 사용하여 연결하기#

tbot identity 서비스와 함께 tsh를 사용하려면 -i 플래그로 identity 파일의 경로를 지정해야 합니다. 또한 연결 시 사용할 Teleport 프록시 서비스의 주소를 지정하려면 --proxy를 사용해야 합니다.

이 예시에서는 tsh를 사용하여 프록시 example.teleport.sh:443을 통해 my-host라는 노드에 연결하고 hostname 명령을 실행합니다:

$ tsh -i /opt/machine-id/identity --proxy example.teleport.sh:443 ssh root@my-host hostname
my-host

OpenSSH를 사용하여 연결하기#

identity 서비스와 함께 OpenSSH를 사용하려면 -F 플래그로 ssh에 ssh_config 경로를 제공해야 합니다.

생성된 ssh_config를 사용할 경우 노드 이름에 Teleport 클러스터 이름을 붙여야 합니다. 이 예시에서는 클러스터 example.teleport.sh에 속한 노드 my-host에서 root로 hostname 명령을 실행합니다:

$ ssh -F /opt/machine-id/ssh_config root@my-host.example.teleport.sh hostname
my-host

기타 도구를 사용하여 연결하기#

다른 SSH 도구와 통합하려면 먼저 ssh_config가 해당 도구와 호환되는지 확인하세요. Ansible을 비롯한 많은 도구가 이에 해당하며, "OpenSSH를 사용하여 연결하기"에서 제공된 안내로 충분할 것입니다.

Ansible과 통합하려면 Ansible 전용 가이드를 확인하세요.

도구가 ssh_config와 호환되지 않는 경우에도, 머신 및 워크로드 아이덴티티가 생성한 자격 증명을 사용하도록 설정하는 것이 여전히 가능할 수 있습니다. 이 경우 해당 도구는 SSH 클라이언트 인증서와 ProxyCommand 또는 ProxyJump 기능 중 하나를 지원해야 합니다.

다음 단계#

• 사용 가능한 모든 설정 옵션을 살펴보려면 설정 참조를 읽어보세요.