InfoGrab DocsInfoGrab Docs

Linux 데스크톱 접근 구성하기

요약

이 가이드는 X11 데스크톱 환경에서 실행되는 Linux 데스크톱에 대해 안전하고 감사 가능한 접근을 제공하도록 Teleport를 구성하는 방법을 설명합니다. Linux 데스크톱 접근은 Teleport v18.11.0 이상에서 사용할 수 있습니다.

이 가이드는 X11 데스크톱 환경에서 실행되는 Linux 데스크톱에 대해 안전하고 감사 가능한 접근을 제공하도록 Teleport를 구성하는 방법을 설명합니다.

Linux 데스크톱 접근은 Teleport v18.11.0 이상에서 사용할 수 있습니다.

작동 방식#

Teleport Linux Desktop Service는 접근하려는 Linux 호스트에서 직접 실행됩니다. 사용자가 연결하면 서비스는 Xvfb(X virtual framebuffer)를 사용하여 가상 X11 디스플레이를 시작하고, 사용자가 선택한 데스크톱 환경을 그 안에서 실행합니다.

Linux Desktop Service는 Teleport 프록시 서비스로 리버스 터널을 설정하므로, 호스트에서 나가는 연결 하나만 필요하며 인바운드 방화벽 규칙은 필요하지 않습니다.

사용 가능한 데스크톱 세션은 /usr/share/xsessions의 .desktop 파일에서 탐색됩니다. 서비스 구성의 xsessions.included 및 xsessions.excluded 필터를 사용하여 제공할 세션을 제한할 수 있습니다.

사전 요구사항#

이 가이드의 단계를 완료하려면 환경이 다음 요구사항을 충족하는지 확인합니다.

  • 실행 중인 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` 파일을 더블 클릭하여 설치를 시작합니다.
 
     
Warning
       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
     ```
   

 
  • /usr/share/xsessions에 세션 정의가 있는 X11 호환 데스크톱 환경을 실행하는 Linux 호스트.

  • Linux 호스트에 설치된 Xvfb. Xvfb는 Teleport가 데스크톱을 렌더링하는 데 사용하는 가상 프레임버퍼를 제공합니다. 사용 중인 배포판의 패키지 관리자로 설치합니다.

$ sudo apt-get install xvfb
$ sudo dnf install xorg-x11-server-Xvfb

Xvfb가 PATH에 있는지 확인합니다.

$ sudo -i which Xvfb

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단계. Linux Desktop Service 구성#

Linux Desktop Service는 사용자가 연결할 Linux 호스트에서 실행됩니다.

Linux Desktop Service를 구성하려면 다음을 수행합니다.

  1. 관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.

  2. Linux Desktop Service용 초대 토큰을 생성합니다.

    $  tctl tokens add --type=linux_desktop --format=text > /tmp/token
    

    /tmp/token을 대상 Linux 호스트로 복사합니다.

  3. Linux 호스트에 Teleport가 설치되어 있는지 확인합니다.

    $ teleport version
    

    Teleport가 설치되어 있지 않다면 사용 중인 환경에 맞는 설치 안내를 따릅니다.

  4. Linux 호스트에서 /etc/teleport.yaml을 구성합니다.

    version: v3
    teleport:
      nodename: linux-desktop.example.com
      proxy_server: teleport.example.com:443
      auth_token: "/tmp/token"
    linux_desktop_service:
      enabled: true
    
    auth_service:
      enabled: false
    proxy_service:
      enabled: false
    ssh_service:
      enabled: false
    

    proxy_server를 Teleport 클러스터의 주소로 설정합니다.

  5. (선택 사항) Linux Desktop Service에 라벨을 추가합니다. 라벨은 어떤 사용자가 이 호스트에 연결할 수 있는지 제어하는 데 사용됩니다.

    version: v3
    teleport:
      nodename: linux-desktop.example.com
      proxy_server: teleport.example.com:443
      auth_token: "/tmp/token"
    linux_desktop_service:
      enabled: true
    + labels:
    +   datacenter: us-east
    +   env: production
    
  6. (선택 사항) 사용자에게 제공되는 데스크톱 세션을 필터링합니다. Teleport는 /usr/share/xsessions의 .desktop 파일에서 사용 가능한 세션 유형을 탐색합니다. 세션 이름(.desktop 확장자를 제외한 파일 이름)에 대해 일치시키는 정규식을 사용하여 제공할 세션을 제한할 수 있습니다.

    linux_desktop_service:
      enabled: true
    + xsessions:
    +   # Only expose GNOME, KDE, and XFCE sessions.
    +   included: "^(gnome|kde|xfce4)$"
    +   # Exclude classic or fallback variants.
    +   excluded: ".*-classic$"
    

    included 패턴이 먼저 적용됩니다. 이 패턴을 설정하면 이름이 패턴과 일치하는 세션만 제공됩니다. 그다음 excluded 패턴이 적용되어 이름이 해당 패턴과 일치하는 세션을 제거합니다.

systemd 서비스를 생성하여 호스트가 부팅될 때 the Teleport Linux Desktop Service이 자동으로 시작되도록 구성합니다. 지침은 the Teleport Linux Desktop Service을 어떻게 설치했는지에 따라 다릅니다.

Package Manager

the Teleport Linux Desktop Service을 실행할 호스트에서 Teleport를 활성화하고 시작합니다:

$ sudo systemctl enable teleport
$ sudo systemctl start teleport

TAR Archive

the Teleport Linux Desktop Service을 실행할 호스트에서 Teleport용 systemd 서비스 구성을 생성하고, Teleport 서비스를 활성화한 후 Teleport를 시작합니다:

$ sudo teleport install systemd -o /etc/systemd/system/teleport.service
$ sudo systemctl enable teleport
$ sudo systemctl start teleport

systemctl status teleport로 the Teleport Linux Desktop Service의 상태를 확인하고 journalctl -fu teleport로 로그를 볼 수 있습니다.

다음은 문제 해결 팁입니다.

2/3단계. Linux 데스크톱 접근용 역할 구성#

Linux 데스크톱에 접근하려면 Teleport 사용자에게 적절한 권한을 부여하는 역할이 있어야 합니다.

Linux 데스크톱 접근용 역할을 구성하려면 다음을 수행합니다.

  1. 관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.

  2. 새 역할을 정의하는 linux-desktop-admins.yaml 파일을 생성합니다.

    kind: role
    version: v6
    metadata:
      name: linux-desktop-admins
    spec:
      allow:
        linux_desktop_labels:
          "*": "*"
        linux_desktop_logins: ["alice"]
    

    이 파일에서 각 필드는 다음과 같습니다.

    • linux_desktop_labels는 이 역할이 할당된 사용자가 접근할 수 있는 Linux 데스크톱을 지정합니다. 모든 데스크톱에 접근을 허용하려면 "*": "*"를 사용하고, 일치하는 라벨이 있는 데스크톱으로 접근을 제한하려면 라벨을 지정합니다.
    • linux_desktop_logins는 이 역할의 구성원이 연결할 수 있는 Linux 사용자 계정을 지정합니다. 지정한 사용자는 Linux 호스트에 이미 존재해야 합니다.
  3. 새 역할을 클러스터에 적용합니다.

    $ tctl create -f linux-desktop-admins.yaml
    
Tip

Web UI를 사용하여 역할을 생성하고 편집할 수도 있습니다. Access -> Roles로 이동하여 Create New Role을 클릭하거나 편집할 기존 역할을 선택하십시오.

인증 공급자에 맞는 적절한 명령을 실행하여 linux-desktop-admins 역할을 your Teleport user에게 할당하십시오:

Local User

  1. 로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:

    $ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")')
    
  2. 로컬 사용자를 편집하여 새 역할을 추가합니다:

    $ tctl users update $(tsh status -f json | jq -r '.active.username') \
      --set-roles "${ROLES?},linux-desktop-admins"
    
  3. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

GitHub

  1. 텍스트 편집기에서 github 인증 커넥터를 엽니다:

    $ tctl edit github/github
    
  2. github 커넥터를 편집하여 teams_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.

    다음은 예시입니다:

      teams_to_roles:
        - organization: octocats
          team: admins
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.

  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

SAML

  1. saml 구성 리소스를 가져옵니다:

    $ tctl get --with-secrets saml/mysaml > saml.yaml
    

    --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 saml.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다.

  2. saml.yaml을 편집하여 attributes_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

    다음은 예시입니다:

      attributes_to_roles:
        - name: "groups"
          value: "my-group"
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 변경 사항을 적용합니다:

    $ tctl create -f saml.yaml
    
  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

OIDC

  1. oidc 구성 리소스를 가져옵니다:

    $ tctl get oidc/myoidc --with-secrets > oidc.yaml
    

    --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 oidc.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다.

  2. oidc.yaml을 편집하여 claims_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

    다음은 예시입니다:

      claims_to_roles:
        - name: "groups"
          value: "my-group"
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 변경 사항을 적용합니다:

    $ tctl create -f oidc.yaml
    
  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

3/3단계. 연결#

Linux Desktop Service가 실행 중이고 역할이 구성되었으므로 Teleport 웹 UI 또는 Teleport Connect에서 Linux 데스크톱에 연결할 수 있습니다.

Linux 데스크톱에 연결하려면 다음을 수행합니다.

  1. linux-desktop-admins 역할이 할당된 계정으로 Teleport 클러스터에 로그인합니다.

  2. Resources를 선택합니다.

  3. Type을 클릭한 다음 Desktops를 선택합니다.

  4. 접근하려는 Linux 데스크톱의 Connect를 클릭한 다음 연결에 사용할 Linux 사용자 계정을 선택합니다.

    Teleport가 원격 데스크톱 연결을 열고 데스크톱 세션 녹화를 시작합니다. 작업을 마치면 More items 메뉴를 클릭한 다음 Disconnect를 클릭합니다.

    녹화를 보려면 Teleport 웹 UI에서 Audit을 선택한 다음 Session Recordings를 클릭합니다.

다음은 문제 해결 팁입니다.

다음 단계#

Linux 데스크톱 접근 구성하기

Teleport v18.11
원문 보기

요약

이 가이드는 X11 데스크톱 환경에서 실행되는 Linux 데스크톱에 대해 안전하고 감사 가능한 접근을 제공하도록 Teleport를 구성하는 방법을 설명합니다. Linux 데스크톱 접근은 Teleport v18.11.0 이상에서 사용할 수 있습니다.

이 가이드는 X11 데스크톱 환경에서 실행되는 Linux 데스크톱에 대해 안전하고 감사 가능한 접근을 제공하도록 Teleport를 구성하는 방법을 설명합니다.

Linux 데스크톱 접근은 Teleport v18.11.0 이상에서 사용할 수 있습니다.

작동 방식#

Teleport Linux Desktop Service는 접근하려는 Linux 호스트에서 직접 실행됩니다. 사용자가 연결하면 서비스는 Xvfb(X virtual framebuffer)를 사용하여 가상 X11 디스플레이를 시작하고, 사용자가 선택한 데스크톱 환경을 그 안에서 실행합니다.

Linux Desktop Service는 Teleport 프록시 서비스로 리버스 터널을 설정하므로, 호스트에서 나가는 연결 하나만 필요하며 인바운드 방화벽 규칙은 필요하지 않습니다.

사용 가능한 데스크톱 세션은 /usr/share/xsessions의 .desktop 파일에서 탐색됩니다. 서비스 구성의 xsessions.included 및 xsessions.excluded 필터를 사용하여 제공할 세션을 제한할 수 있습니다.

사전 요구사항#

이 가이드의 단계를 완료하려면 환경이 다음 요구사항을 충족하는지 확인합니다.

  • 실행 중인 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` 파일을 더블 클릭하여 설치를 시작합니다.
 
     
Warning
       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
     ```
   

 
  • /usr/share/xsessions에 세션 정의가 있는 X11 호환 데스크톱 환경을 실행하는 Linux 호스트.

  • Linux 호스트에 설치된 Xvfb. Xvfb는 Teleport가 데스크톱을 렌더링하는 데 사용하는 가상 프레임버퍼를 제공합니다. 사용 중인 배포판의 패키지 관리자로 설치합니다.

$ sudo apt-get install xvfb
$ sudo dnf install xorg-x11-server-Xvfb

Xvfb가 PATH에 있는지 확인합니다.

$ sudo -i which Xvfb

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단계. Linux Desktop Service 구성#

Linux Desktop Service는 사용자가 연결할 Linux 호스트에서 실행됩니다.

Linux Desktop Service를 구성하려면 다음을 수행합니다.

  1. 관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.

  2. Linux Desktop Service용 초대 토큰을 생성합니다.

    $  tctl tokens add --type=linux_desktop --format=text > /tmp/token
    

    /tmp/token을 대상 Linux 호스트로 복사합니다.

  3. Linux 호스트에 Teleport가 설치되어 있는지 확인합니다.

    $ teleport version
    

    Teleport가 설치되어 있지 않다면 사용 중인 환경에 맞는 설치 안내를 따릅니다.

  4. Linux 호스트에서 /etc/teleport.yaml을 구성합니다.

    version: v3
    teleport:
      nodename: linux-desktop.example.com
      proxy_server: teleport.example.com:443
      auth_token: "/tmp/token"
    linux_desktop_service:
      enabled: true
    
    auth_service:
      enabled: false
    proxy_service:
      enabled: false
    ssh_service:
      enabled: false
    

    proxy_server를 Teleport 클러스터의 주소로 설정합니다.

  5. (선택 사항) Linux Desktop Service에 라벨을 추가합니다. 라벨은 어떤 사용자가 이 호스트에 연결할 수 있는지 제어하는 데 사용됩니다.

    version: v3
    teleport:
      nodename: linux-desktop.example.com
      proxy_server: teleport.example.com:443
      auth_token: "/tmp/token"
    linux_desktop_service:
      enabled: true
    + labels:
    +   datacenter: us-east
    +   env: production
    
  6. (선택 사항) 사용자에게 제공되는 데스크톱 세션을 필터링합니다. Teleport는 /usr/share/xsessions의 .desktop 파일에서 사용 가능한 세션 유형을 탐색합니다. 세션 이름(.desktop 확장자를 제외한 파일 이름)에 대해 일치시키는 정규식을 사용하여 제공할 세션을 제한할 수 있습니다.

    linux_desktop_service:
      enabled: true
    + xsessions:
    +   # Only expose GNOME, KDE, and XFCE sessions.
    +   included: "^(gnome|kde|xfce4)$"
    +   # Exclude classic or fallback variants.
    +   excluded: ".*-classic$"
    

    included 패턴이 먼저 적용됩니다. 이 패턴을 설정하면 이름이 패턴과 일치하는 세션만 제공됩니다. 그다음 excluded 패턴이 적용되어 이름이 해당 패턴과 일치하는 세션을 제거합니다.

systemd 서비스를 생성하여 호스트가 부팅될 때 the Teleport Linux Desktop Service이 자동으로 시작되도록 구성합니다. 지침은 the Teleport Linux Desktop Service을 어떻게 설치했는지에 따라 다릅니다.

Package Manager

the Teleport Linux Desktop Service을 실행할 호스트에서 Teleport를 활성화하고 시작합니다:

$ sudo systemctl enable teleport
$ sudo systemctl start teleport

TAR Archive

the Teleport Linux Desktop Service을 실행할 호스트에서 Teleport용 systemd 서비스 구성을 생성하고, Teleport 서비스를 활성화한 후 Teleport를 시작합니다:

$ sudo teleport install systemd -o /etc/systemd/system/teleport.service
$ sudo systemctl enable teleport
$ sudo systemctl start teleport

systemctl status teleport로 the Teleport Linux Desktop Service의 상태를 확인하고 journalctl -fu teleport로 로그를 볼 수 있습니다.

다음은 문제 해결 팁입니다.

2/3단계. Linux 데스크톱 접근용 역할 구성#

Linux 데스크톱에 접근하려면 Teleport 사용자에게 적절한 권한을 부여하는 역할이 있어야 합니다.

Linux 데스크톱 접근용 역할을 구성하려면 다음을 수행합니다.

  1. 관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.

  2. 새 역할을 정의하는 linux-desktop-admins.yaml 파일을 생성합니다.

    kind: role
    version: v6
    metadata:
      name: linux-desktop-admins
    spec:
      allow:
        linux_desktop_labels:
          "*": "*"
        linux_desktop_logins: ["alice"]
    

    이 파일에서 각 필드는 다음과 같습니다.

    • linux_desktop_labels는 이 역할이 할당된 사용자가 접근할 수 있는 Linux 데스크톱을 지정합니다. 모든 데스크톱에 접근을 허용하려면 "*": "*"를 사용하고, 일치하는 라벨이 있는 데스크톱으로 접근을 제한하려면 라벨을 지정합니다.
    • linux_desktop_logins는 이 역할의 구성원이 연결할 수 있는 Linux 사용자 계정을 지정합니다. 지정한 사용자는 Linux 호스트에 이미 존재해야 합니다.
  3. 새 역할을 클러스터에 적용합니다.

    $ tctl create -f linux-desktop-admins.yaml
    
Tip

Web UI를 사용하여 역할을 생성하고 편집할 수도 있습니다. Access -> Roles로 이동하여 Create New Role을 클릭하거나 편집할 기존 역할을 선택하십시오.

인증 공급자에 맞는 적절한 명령을 실행하여 linux-desktop-admins 역할을 your Teleport user에게 할당하십시오:

Local User

  1. 로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:

    $ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")')
    
  2. 로컬 사용자를 편집하여 새 역할을 추가합니다:

    $ tctl users update $(tsh status -f json | jq -r '.active.username') \
      --set-roles "${ROLES?},linux-desktop-admins"
    
  3. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

GitHub

  1. 텍스트 편집기에서 github 인증 커넥터를 엽니다:

    $ tctl edit github/github
    
  2. github 커넥터를 편집하여 teams_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.

    다음은 예시입니다:

      teams_to_roles:
        - organization: octocats
          team: admins
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.

  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

SAML

  1. saml 구성 리소스를 가져옵니다:

    $ tctl get --with-secrets saml/mysaml > saml.yaml
    

    --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 saml.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다.

  2. saml.yaml을 편집하여 attributes_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

    다음은 예시입니다:

      attributes_to_roles:
        - name: "groups"
          value: "my-group"
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 변경 사항을 적용합니다:

    $ tctl create -f saml.yaml
    
  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

OIDC

  1. oidc 구성 리소스를 가져옵니다:

    $ tctl get oidc/myoidc --with-secrets > oidc.yaml
    

    --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 oidc.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다.

  2. oidc.yaml을 편집하여 claims_to_roles 섹션에 linux-desktop-admins을 추가합니다.

    이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

    다음은 예시입니다:

      claims_to_roles:
        - name: "groups"
          value: "my-group"
          roles:
            - access
    +       - linux-desktop-admins
    
  3. 변경 사항을 적용합니다:

    $ tctl create -f oidc.yaml
    
  4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

3/3단계. 연결#

Linux Desktop Service가 실행 중이고 역할이 구성되었으므로 Teleport 웹 UI 또는 Teleport Connect에서 Linux 데스크톱에 연결할 수 있습니다.

Linux 데스크톱에 연결하려면 다음을 수행합니다.

  1. linux-desktop-admins 역할이 할당된 계정으로 Teleport 클러스터에 로그인합니다.

  2. Resources를 선택합니다.

  3. Type을 클릭한 다음 Desktops를 선택합니다.

  4. 접근하려는 Linux 데스크톱의 Connect를 클릭한 다음 연결에 사용할 Linux 사용자 계정을 선택합니다.

    Teleport가 원격 데스크톱 연결을 열고 데스크톱 세션 녹화를 시작합니다. 작업을 마치면 More items 메뉴를 클릭한 다음 Disconnect를 클릭합니다.

    녹화를 보려면 Teleport 웹 UI에서 Audit을 선택한 다음 Session Recordings를 클릭합니다.

다음은 문제 해결 팁입니다.

다음 단계#