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를 시작하려면 무료 체험판에 가입하거나 데모 환경을 구성하세요.
-
tctlandtshclients.Installing `tctl` and `tsh` clients
-
Teleport 클러스터의 버전을 확인합니다.
tctlandtshclients는 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')" -
사용 중인 플랫폼에 대한 지침에 따라
tctlandtshclients를 설치합니다:
-
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
```
-
/usr/share/xsessions에 세션 정의가 있는 X11 호환 데스크톱 환경을 실행하는 Linux 호스트. -
Linux 호스트에 설치된 Xvfb. Xvfb는 Teleport가 데스크톱을 렌더링하는 데 사용하는 가상 프레임버퍼를 제공합니다. 사용 중인 배포판의 패키지 관리자로 설치합니다.
$ sudo apt-get install xvfb$ sudo dnf install xorg-x11-server-XvfbXvfb가PATH에 있는지 확인합니다.$ sudo -i which XvfbTeleport 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를 구성하려면 다음을 수행합니다.
-
관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.
-
Linux Desktop Service용 초대 토큰을 생성합니다.
$ tctl tokens add --type=linux_desktop --format=text > /tmp/token/tmp/token을 대상 Linux 호스트로 복사합니다. -
Linux 호스트에 Teleport가 설치되어 있는지 확인합니다.
$ teleport versionTeleport가 설치되어 있지 않다면 사용 중인 환경에 맞는 설치 안내를 따릅니다.
-
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: falseproxy_server를 Teleport 클러스터의 주소로 설정합니다. -
(선택 사항) 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 -
(선택 사항) 사용자에게 제공되는 데스크톱 세션을 필터링합니다. 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 teleportTAR 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 teleportsystemctl status teleport로 the Teleport Linux Desktop Service의 상태를 확인하고journalctl -fu teleport로 로그를 볼 수 있습니다.다음은 문제 해결 팁입니다.
-
서비스 상태를 확인합니다.
$ systemctl status teleport -
로그에서 연결 오류를 확인합니다.
$ sudo journalctl -u teleport -
Xvfb가PATH에 있는지 확인합니다.$ sudo -i which Xvfb명령이 아무 출력도 반환하지 않으면 Xvfb가 설치되어 있지 않은 것입니다. 설치 방법은 위의 사전 요구사항 섹션을 참조합니다.
-
/usr/share/xsessions에.desktop파일이 하나 이상 있는지 확인합니다.$ ls /usr/share/xsessions/ -
토큰이 만료되지 않았는지 확인합니다(토큰은 기본적으로 60분 동안 유효합니다).
2/3단계. Linux 데스크톱 접근용 역할 구성#
Linux 데스크톱에 접근하려면 Teleport 사용자에게 적절한 권한을 부여하는 역할이 있어야 합니다.
Linux 데스크톱 접근용 역할을 구성하려면 다음을 수행합니다.
-
관리용 워크스테이션에서 Teleport 클러스터에 로그인합니다.
-
새 역할을 정의하는
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 호스트에 이미 존재해야 합니다.
-
새 역할을 클러스터에 적용합니다.
$ tctl create -f linux-desktop-admins.yaml
TipWeb UI를 사용하여 역할을 생성하고 편집할 수도 있습니다. Access -> Roles로 이동하여 Create New Role을 클릭하거나 편집할 기존 역할을 선택하십시오.
인증 공급자에 맞는 적절한 명령을 실행하여
linux-desktop-admins역할을 your Teleport user에게 할당하십시오:Local User
-
로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:
$ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")') -
로컬 사용자를 편집하여 새 역할을 추가합니다:
$ tctl users update $(tsh status -f json | jq -r '.active.username') \ --set-roles "${ROLES?},linux-desktop-admins" -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
GitHub
-
텍스트 편집기에서
github인증 커넥터를 엽니다:$ tctl edit github/github -
github커넥터를 편집하여teams_to_roles섹션에linux-desktop-admins을 추가합니다.이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.
다음은 예시입니다:
teams_to_roles: - organization: octocats team: admins roles: - access + - linux-desktop-admins -
편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.
-
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
SAML
-
saml구성 리소스를 가져옵니다:$ tctl get --with-secrets saml/mysaml > saml.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을saml.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다. -
saml.yaml을 편집하여attributes_to_roles섹션에linux-desktop-admins을 추가합니다.이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
attributes_to_roles: - name: "groups" value: "my-group" roles: - access + - linux-desktop-admins -
변경 사항을 적용합니다:
$ tctl create -f saml.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
OIDC
-
oidc구성 리소스를 가져옵니다:$ tctl get oidc/myoidc --with-secrets > oidc.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을oidc.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다. -
oidc.yaml을 편집하여claims_to_roles섹션에linux-desktop-admins을 추가합니다.이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
claims_to_roles: - name: "groups" value: "my-group" roles: - access + - linux-desktop-admins -
변경 사항을 적용합니다:
$ tctl create -f oidc.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
3/3단계. 연결#
Linux Desktop Service가 실행 중이고 역할이 구성되었으므로 Teleport 웹 UI 또는 Teleport Connect에서 Linux 데스크톱에 연결할 수 있습니다.
Linux 데스크톱에 연결하려면 다음을 수행합니다.
-
linux-desktop-admins역할이 할당된 계정으로 Teleport 클러스터에 로그인합니다. -
Resources를 선택합니다.
-
Type을 클릭한 다음 Desktops를 선택합니다.
-
접근하려는 Linux 데스크톱의 Connect를 클릭한 다음 연결에 사용할 Linux 사용자 계정을 선택합니다.
Teleport가 원격 데스크톱 연결을 열고 데스크톱 세션 녹화를 시작합니다. 작업을 마치면 More items 메뉴를 클릭한 다음 Disconnect를 클릭합니다.
녹화를 보려면 Teleport 웹 UI에서 Audit을 선택한 다음 Session Recordings를 클릭합니다.
다음은 문제 해결 팁입니다.
-
Teleport 사용자에게
linux-desktop-admins역할(또는 Linux 데스크톱 권한이 있는 동등한 역할)이 할당되어 있는지 확인합니다. -
선택한 Linux 사용자 계정이 호스트에 존재하는지 확인합니다.
-
Linux 호스트에 Xvfb가 설치되어 있고
PATH에 있는지 확인합니다. -
xsessions필터를 적용한 뒤에도 사용 가능한 세션 유형이 하나 이상 있는지 확인합니다./usr/share/xsessions/를 살펴보고 구성의included/excluded패턴과 비교합니다. -
연결에 실패하면 호스트의 Linux Desktop Service 로그를 확인합니다.
$ sudo journalctl -u teleport
다음 단계#
- 어떤 사용자가 어떤 데스크톱에 접근할 수 있는지 제어하는 방법은 데스크톱용 역할 기반 접근 제어를 참조합니다.
- 세션 녹화 옵션을 구성하려면 세션 녹화 및 재생을 참조합니다.
linux_desktop_service구성 옵션의 전체 목록은 데스크톱 접근 구성 레퍼런스를 참조합니다.
-