일부 시나리오에서는 tbot 없이 수동으로 SPIFFE SVID를 발급하고 싶을 수 있습니다. 이는 디버깅 목적으로 서비스를 가장해야 하거나 인증에 SPIFFE SVID를 사용하는 서비스에 대한 접근 메커니즘을 제공하는 시나리오에서 유용할 수 있습니다.

이 가이드에서는 tsh 도구를 사용하여 SPIFFE SVID를 발급합니다.

사전 요구 사항#

• SPIFFE SVID 발급을 허용하도록 구성된 역할과 사용자에게 할당된 이 역할. 자세한 정보는 시작하기를 참조하세요.

• 실행 중인 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
     ```
   

 

1/2단계. tsh를 사용하여 SPIFFE X509 SVID 발급#

먼저 SPIFFE SVID를 쓸 위치를 결정합니다. 디렉터리에 쓰려면 먼저 디렉터리를 생성해야 합니다. 예제에서는 SVID를 svid라는 디렉터리에 쓸 것입니다.

다음으로 X509 SVID를 발급하는 데 사용할 워크로드 아이덴티티 리소스를 결정합니다. 예제에서는 my-workload-identity라는 워크로드 아이덴티티를 사용합니다.

--output을 사용하여 출력 디렉터리를 지정하고 --name-selector를 사용하여 워크로드 아이덴티티 리소스의 이름을 지정하여 SVID를 발급합니다:

$ tsh workload-identity issue-x509 --output ./svid --name-selector my-workload-identity

또한 플래그를 사용하여 SVID를 추가로 사용자 정의할 수 있습니다:

원격 호스트에서 SVID를 발급하기 위한 헤드리스 인증 사용#

일부 시나리오에서는 SSH로 연결한 호스트에서 해당 호스트에서 Teleport에 로그인하지 않고 tsh를 사용하여 SVID를 발급하고 싶을 수 있습니다. 이는 하드웨어 토큰을 사용하여 인증하는 경우와 같이 인증이 불가능할 수 있는 시나리오에서 특히 유용할 수 있습니다.

이 경우 tsh의 헤드리스 인증 기능을 사용할 수 있습니다. 이는 로컬 tsh 클라이언트를 사용하여 원격 머신의 명령을 인증하는 프롬프트를 제공합니다.

헤드리스 인증을 사용하려면 --headless 플래그를 제공하고 --proxy 및 --user 플래그도 지정해야 합니다:

$ tsh --proxy=example.teleport.sh \
  --user example \
  --headless \
  workload-identity issue-x509 \
  --output . \
  --name-selector my-workload-identity

2/2단계. 출력 SVID 사용#

SVID가 발급되면 워크로드가 사용하도록 구성할 수 있습니다. 이는 워크로드에 따라 다릅니다.

디스크에 쓰면 SVID는 세 개의 파일로 작성됩니다:

다음 단계#

• 워크로드 아이덴티티 개요: Teleport 워크로드 아이덴티티 개요.
• 시작하기: 워크로드 아이덴티티를 위한 Teleport 구성 방법.
• 모범 사례: 프로덕션에서 워크로드 아이덴티티 사용에 대한 모범 사례.
• 구성 참조를 읽어 사용 가능한 모든 구성 옵션을 탐색하세요.