Teleport의 SSH 서비스가 Linux 감사 시스템(auditd)과 통합되도록 구성할 수 있습니다.

사전 요구사항#

• 실행 중인 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 클러스터에 에이전트를 추가하는 방법은 시작 가이드를 참조하세요. 에이전트에서 teleport는 root 권한을 가진 systemd 서비스로 실행되어야 합니다.
• CONFIG_AUDIT로 컴파일된 Linux 커널 2.6.6 이상. 대부분의 Linux 배포판에서는 이 옵션이 기본적으로 활성화되어 있습니다.
• auditd 상태를 확인하기 위한 auditctl(선택 사항).

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는 시스템에서 auditd가 활성화되어 있음을 감지하면 자동으로 auditd 이벤트를 전송합니다. root 권한으로 auditctl -s를 호출하여 이를 확인할 수 있습니다.

이 명령의 예시 출력은 다음과 같습니다:

$ sudo auditctl -s
enabled 1
failure 1
pid 879
rate_limit 0
backlog_limit 8192
lost 0
backlog 0
backlog_wait_time 60000
backlog_wait_time_actual 0
loginuid_immutable 0 unlocked

첫 번째 줄인 enabled 1은 auditd가 활성화되어 있으며 Teleport가 이벤트를 전송함을 나타냅니다.

모든 이벤트는 Teleport 노드에서 생성됩니다. invalid user 이벤트는 Teleport 사용자가 인증에 실패했을 때 프록시 서비스에서도 생성됩니다.

2/3단계. Teleport 구성 및 시작#

Teleport는 root 권한을 가진 시스템 서비스(예: systemd 서비스)로 실행하는 것이 중요합니다. 그렇지 않으면 권한 부족으로 인해 Teleport가 auditd에 어떤 이벤트도 전송하지 못합니다.

1. [선택 사항] PAM(Pluggable Authentication Modules)이 활성화된 경우 auditd는 추가 이벤트를 생성할 수 있습니다.

   Teleport에서 PAM 통합을 활성화하려면 Teleport 노드의 구성 파일(기본값은 /etc/teleport.yaml)에 다음 pam 섹션을 추가하세요:

   ssh_service:
     # Enabled SSH Service
     enabled: true
     # Enable PAM integration
     pam:
       # "no" by default
       enabled: true
       # use /etc/pam.d/sshd configuration (the default)
       service_name: "sshd"
   

   PAM 통합이 활성화된 경우 PAM에서 생성되는 이벤트는 sshd 구성에 따라 달라집니다. 대부분의 시스템은 USER_ACCT 또는 USER_START와 같은 이벤트를 생성합니다. 또한 pam_tty_audit.so 모듈을 활성화하면 TTY 입력을 로깅할 수 있습니다.

   자세한 내용은 PAM 또는 사용 중인 운영체제 문서를 참조하세요.

   PAM 통합이 활성화되면 auditd 이벤트는 OpenSSH가 생성하는 이벤트와 거의 일치해야 합니다.

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

Package Manager

your Teleport instance을 실행할 호스트에서 Teleport를 활성화하고 시작합니다:

$ sudo systemctl enable teleport
$ sudo systemctl start teleport

TAR Archive

your Teleport instance을 실행할 호스트에서 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로 your Teleport instance의 상태를 확인하고 journalctl -fu teleport로 로그를 볼 수 있습니다.

 ```code
 $ cat /proc/$(pidof teleport)/loginuid
 ```

 이 값은 `4294967295`로 설정되어 있어야 합니다. Teleport 프로세스를 systemd
 서비스로 시작하면 로그인 UID가 설정되지 않은 상태가 됩니다.

3/3단계. auditd로 SSH 세션 추적#

Teleport에서 SSH 세션을 추적하는 방법은 몇 가지가 있습니다. auditd 이벤트와 상호작용하기 위해 ausearch를 사용하겠습니다. 시스템에 해당 도구가 없다면 배포판 문서를 참조하여 설치 방법을 확인하세요.

시스템 사용자로 검색#

-ua 스위치를 사용하여 시스템 사용자로 로그인할 때 발생하는 이벤트를 검색할 수 있습니다. id 명령을 사용하면 사용자의 UID를 확인할 수 있습니다:

$ id bob
uid=1000(bob) gid=1000(bob) groups=1000(bob)

그런 다음 uid를 사용하여 auditd 로그를 검색할 수 있습니다:

ausearch -ua 1000 -m USER_LOGIN

Teleport 사용자로 검색#

Teleport가 auditd로 전송하는 이벤트에는 Teleport 사용자의 이름이 포함된 teleportUser 필드가 추가됩니다. ausearch는 커스텀 필드로 검색할 수 없지만, 이를 위해 grep을 사용할 수 있습니다:

ausearch -m USER_LOGIN | grep teleportUser=bob

세션 ID로 검색#

특정 세션에서 생성된 모든 이벤트를 찾으려면 먼저 세션 ID를 찾아야 합니다. 다음을 사용하여 이를 확인할 수 있습니다:

ausearch  -m USER_LOGIN -x teleport --just-one

그런 다음 해당 세션과 관련된 이벤트만 검색합니다:

ausearch --session 42