Question 1

Teleport 통합 테스트 TestTimeReconciliation이 'expected notification is not found' 오류와 함께 간헐적으로 실패하는 이유는 무엇인가요?

Accepted Answer

이 결함성 테스트는 x/crypto 업데이트에 도입된 스핀 루프 버그로 인해 발생했습니다. 해당 문제는 PR #67111에서 해당 업데이트를 되돌려 해결되었습니다. 수정하려면 Teleport 빌드에 이 PR(5월 26일 이후 병합됨)이 포함되어 있는지 확인하세요. 업그레이드할 수 없는 경우 임시 해결 방법은 스핀 루프 최적화를 비활성화하거나 로컬에서 x/crypto 변경 사항을 되돌리는 것입니다.

Question 2

Redshift JDBC 드라이버가 Teleport 프록시를 통해 연결할 때 'Illegal UTF-8 sequence' 오류가 발생하는 이유는 무엇인가요?

Accepted Answer

Redshift JDBC 드라이버는 PostgreSQL 시작 메시지가 단일 TCP 패킷으로 전송되기를 기대합니다. Teleport의 프록시는 이 메시지를 여러 패킷으로 분할하여 UTF-8 디코딩 오류를 발생시킵니다. 해결 방법: Redshift 전용 드라이버 대신 표준 PostgreSQL JDBC 드라이버(org.postgresql.Driver)를 사용하십시오. 이 드라이버는 Teleport의 프록시와 정상적으로 작동합니다. 영구적인 수정에 대해서는 이슈 #29417을 참조하십시오.

Question 3

사용자의 홈 디렉터리가 없을 때 'server unexpectedly closed connection: unexpected EOF' 오류로 tsh scp가 실패하는 문제를 해결하는 방법

Accepted Answer

이는 알려진 Teleport 버그입니다(v18.7.3에서 확인됨): 로그인 사용자의 홈 디렉터리가 대상 호스트에 존재하지 않을 때 `tsh ssh`는 동작하지만(`/`로 폴백함) `tsh scp`는 `error receiving version packet from server: server unexpectedly closed connection: unexpected EOF` 오류와 함께 실패합니다. 두 가지 해결 방법이 있습니다:

1. **Teleport 업그레이드** — 이 버그는 업스트림에서 수정되었습니다(gravitational/core PR #563, issue #65579 해결 완료로 종료됨). Teleport 클러스터(대상 노드의 SSH Service)와 `tsh` 클라이언트를 모두 수정 사항이 포함된 릴리스로 업그레이드하세요.

2. **우회 방법(업그레이드 없이):** SFTP가 작업 디렉터리를 설정할 수 있도록 대상 호스트에 사용자의 홈 디렉터리를 다시 생성하세요:
```
sudo mkdir -p /home/testuser
sudo chown testuser:testuser /home/testuser
```
홈 디렉터리를 복원하면 `tsh scp testuser@host:/etc/hostname .`이 다시 정상적으로 동작합니다.

Question 4

Teleport에서 리소스를 새로운 tctl 핸들러 형식으로 추가하거나 마이그레이션하는 방법

Accepted Answer

Teleport는 tctl 리소스 처리를 기존 방식(리소스당 하나의 컬렉션과 create/update 함수들, 그리고 `ResourceCommand.getCollection` 및 `ResourceCommand.Delete`의 거대한 switch문 내 case들)에서 PR #59518에서 도입된 중앙 집중식 `Handler` 구조체로 마이그레이션하고 있습니다. 리소스를 마이그레이션하거나 추가하려면: 1) 해당 리소스의 모든 로직을 담은 전용 파일 `tool/tctl/common/resources/<resource-kind>.go`를 생성합니다. 2) 해당 파일에 리소스의 get/create/update/delete 동작을 구현하는 `Handler` 구조체를 정의합니다. 3) `tool/tctl/common/resources/resource.go`의 `Handlers()` 함수에 핸들러를 등록합니다. 추가적인 연결 작업은 필요하지 않습니다. 등록하고 나면 해당 리소스 종류에 대해 `tctl get`, `tctl create`, `tctl update`, `tctl delete` 또는 `tctl edit`을 실행할 때 핸들러가 자동으로 사용됩니다. `types.KindNetworkRestrictions`는 해당 기능이 더 이상 사용되지 않아 Teleport v15에서 제거되었기 때문에(흔적 코드만 남아 있음) 마이그레이션 목록에서 제외되었습니다. 이미 마이그레이션된 리소스 목록과 예시로 참고할 PR은 추적 이슈 #60370을 확인하세요.

Question 5

Teleport SSH (tsh ssh) 세션이 `w` 또는 `loginctl`에 표시되지 않는 이유는 무엇이며, logind Class=background 세션은 어떻게 해결하나요?

Accepted Answer

원인: Teleport의 PAM 통합이 `pam_open_session()` 전에 `PAM_TTY`(또는 `PAM_RHOST`)를 설정하지 않기 때문에, `pam_systemd`가 빈 TTY 상태로 `Type=unspecified`, `Class=background`로 폴백합니다. OpenSSH는 `PAM_TTY="ssh"`(PAM_TTY_KLUDGE)를 설정하므로 정상 작동하며, pam_systemd는 이를 특별 처리하여 `Type=tty`, `Class=user`로 설정합니다. 이전 호스트에서는 `w`가 `/run/utmp`를 읽었기 때문에 이 문제가 드러나지 않았습니다. utmp가 없는 최신 systemd(예: 259, Ubuntu 26.04)에서는 `w`가 logind에 의존하며 Teleport 로그인에 대해 `0 users`를 보고합니다.

Teleport가 수정 사항을 배포할 때까지의 해결 방법(패치가 issue #69773에 제안되었지만 v18.11 기준으로 테스트되지 않았고 병합되지 않음): pam_systemd가 인식하는 PAM 환경 변수를 통해 세션 유형/클래스를 재정의합니다.

1. `/etc/security/teleport-session-env` 파일을 생성합니다:
```
XDG_SESSION_TYPE DEFAULT=tty
XDG_SESSION_CLASS DEFAULT=user
```
2. 세션 스택에서 pam_systemd보다 먼저 pam_env를 로드하는 사용자 정의 PAM 서비스 `/etc/pam.d/teleport`를 생성합니다:
```
session required pam_env.so envfile=/etc/security/teleport-session-env
session optional pam_systemd.so
```
(그리고 `sshd` 서비스 파일에서 복사한 일반적인 auth/account 라인을 추가합니다)
3. teleport.yaml에서 Teleport가 이를 사용하도록 지정하고 재시작합니다:
```
ssh_service:
  pam:
    enabled: true
    service_name: teleport
```
4. 확인: `loginctl show-session "$XDG_SESSION_ID" -p Class -p Type`이 이제 `Class=user`, `Type=tty`를 표시해야 하며, `w`가 해당 사용자를 나열해야 합니다.

주의: 이 환경 변수 재정의는 PTY가 없는 비대화형 세션을 포함하여 해당 PAM 서비스를 사용하는 모든 세션에 적용됩니다. 올바른 영구 수정 방법은 Teleport가 PAM 세션을 열기 전에 `PAM_TTY`(예: OpenSSH처럼 리터럴 `ssh` 또는 실제 pts 이름)와 `PAM_RHOST`를 설정하는 것입니다.

Teleport

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트