---
title: "2026년 11월 Teleport 최신 버전 주요 업데이트"
description: "2026년 10~11월 Teleport 릴리즈의 주요 기능·보안 개선과 버그 수정을 정리합니다. Hardware Keys 정책, MCP OAuth와 Beams 연동, 스코프 조인 토큰, 프록시 멀티플렉싱이 추가되었으며, 비공개 보안 릴리즈와 Electron 취약점 수정, LTS 업데이트 및 두 가지 Breaking Change에 대한 업그레이드 지침을 안내합니다."
url: https://insight.infograb.net/release/2026/11/18/teleport-update-release/
source: content/generated/release/2026-11-18-teleport-update-release.md
---

안녕하세요, 인포그랩입니다. 2026년 11월 노트에서는 10월 노트(v18.11.1~v18.11.3, v17.7.29~v17.7.30)에 이어 10월 8일부터 11월 18일까지 배포된 Teleport 릴리즈 10건을 다룹니다. 기능 개선이 모인 릴리즈는 v18.11.8(10-29) 과 v18.11.9(11-06) 입니다. v18.11.8은 Beams의 VNet이 streamable-HTTP MCP 앱을 터널링하도록 하고, MCP 서버 앱에 OAuth 파라미터를 지정할 수 있게 했으며, `terraform_cloud`, `spacelift`, `bitbucket`, `env0` 조인 방식에 스코프 토큰을 지원합니다.  v18.11.9는 40개 항목으로 구성되며, 멀티플렉싱 `tsh aws proxy`, `tsh proxy kube`의 HTTP/2 멀티플렉싱, PostgreSQL 백엔드 연결 풀 지표, EC2 자동 검색 진단 개선이 들어 있습니다. 보안 쪽에서는 10월 2일 비공개 보안 릴리즈(v18.11.3)의 후속인 v18.11.4(10-14) 에 이어 비공개 보안 릴리즈 v18.11.5가 배포되었고, v18.11.7(10-21) 은 Teleport Connect의 Electron을 43.8.1로 올려 CVE-2026-111943과 관련된 인증서를 받아들이지 않도록 했습니다. LTS(장기 지원) 17.x 라인에서는 v17.7.31(10-20), 비공개 보안 릴리즈 v17.7.32(10-20) 가 이어졌고, v17.7.34(11-06) 에는 brotli 의존성 업데이트(GHSA-c9gr-gmg4-2vqv)와 Auth Service 크래시 수정 등이 들어 있습니다(v17.7.33은 빌드 파이프라인 문제로 건너뛰었습니다). 이번 기간에는 Breaking Change 2건(`tctl detections` 플래그 위치 변경, `teleportmwi_kubernetes` 데이터 소스 deprecate)이 있습니다. 참고로 Teleport는 7월 이후 GitHub Releases 페이지 대신 공식 문서 체인지로그에 릴리즈 노트를 게시하고 있습니다.

## 한눈에 보는 11월 릴리즈 하이라이트

- [긴급] 비공개 보안 릴리즈 2건 (v18.11.5, v17.7.32): 변경 내역은 후속 공개 릴리즈에서 발표됩니다. v18.11.4는 10월 2일 비공개 릴리즈(v18.11.3)의 후속이며, v17.7.31은 v17.7.30의 후속입니다.
- [보안] Teleport Connect Electron 43.8.1 (v18.11.7, v17.7.32): CVE-2026-111943과 관련된 인증서를 Teleport Connect(데스크톱 클라이언트)가 받아들이지 않도록 Electron을 올렸습니다.
- [보안] LTS v17.7.34 (11-06): brotli 의존성을 업데이트해 GHSA-c9gr-gmg4-2vqv를 해결하고, 파싱할 수 없는 인증 기관(CA)으로 Auth Service가 멈추던 문제 등을 수정했습니다. v17.7.33은 빌드 파이프라인 문제로 건너뛰었습니다.
- [Breaking Change] `tctl detections` 플래그 위치 변경 (v18.11.8): `--format`, `--from`, `--to`가 `ls`와 `get` 하위 명령으로 옮겨져 하위 명령 뒤에 써야 합니다. 예: `tctl detections ls --format json`
- [Breaking Change] `teleportmwi_kubernetes` 데이터 소스 deprecate (v18.11.8): Terraform provider의 데이터 소스 대신 같은 이름의 ephemeral 리소스를 쓰도록 안내합니다.
- Hardware Keys 강제 정책 (v18.11.5, v18.11.8): 세션별 MFA 없이 사람 사용자에게 하드웨어 키를 강제하는 `human_private_key_policy`가 추가되었고, Machine ID 봇은 영향을 받지 않습니다.
- MCP 개선 (v18.11.8, v18.11.10): MCP 서버 앱의 OAuth 파라미터 지정, Beams의 VNet 터널, 접근 거부 시 연결 끊김·멈춤 수정, tool-list 응답의 필드 누락 수정이 포함됩니다.
- tbot·Machine ID 개선 (v18.11.8, v18.11.9): application proxy의 업스트림 연결 재사용, 유휴 타임아웃, `workload-identity-aws-roles-anywhere` 스코프, 갱신 루프 지터가 추가되었습니다.
- 스코프 조인 토큰 확장 (v18.11.8): `terraform_cloud`, `spacelift`, `bitbucket`, `env0` 조인 방식이 스코프 토큰을 지원하고, 모든 스코프 조인 방식에서 `usage_mode: single`이 올바르게 동작합니다.
- 멀티플렉싱 프록시와 MFA (v18.11.8, v18.11.9): 하나의 로컬 `tsh proxy`로 여러 AWS 앱을 다루고, 한 번의 MFA 세리머니로 여러 애플리케이션의 인증서를 발급합니다. `tsh proxy kube`는 HTTP/2 멀티플렉싱으로 연결 수를 줄입니다.
- 대규모 클러스터 성능 (v18.11.5, v18.11.8, v18.11.9): 에이전트가 많은 클러스터의 Auth Service CPU 사용량, Athena 감사 로그 소비자의 메모리 사용량, 에이전트 재연결 비용이 줄었습니다.
- 자동 검색·Terraform (v18.11.8, v18.11.9): Azure AKS 등록 Terraform 모듈, AWS ECS 에이전트 배포 모듈, `tctl discovery databases`, EC2 자동 검색의 동시 처리와 백오프가 추가되었습니다.
- 런타임·이미지 업데이트: Go 1.26.10(v18.11.6, v17.7.31), distroless 이미지 debian13(v18.11.8, v17.7.34)으로 올라갔습니다.

---

## 11월 핵심 릴리즈 심층 분석

이번 기간 릴리즈 가운데 운영자가 설정을 바꾸거나 작업 방식을 조정해야 하는 변경을 주제별로 묶었습니다. 비공개 보안 릴리즈와 Electron 수정은 보안 수정사항 섹션에서 다룹니다.

### 1) Hardware Keys 강제 정책: `human_private_key_policy` (v18.11.5, v18.11.8)

v18.11.5는 `cluster_auth_preference`와 `teleport.yaml`의 `human_private_key_policy` 필드로, 세션별 MFA(per-session MFA) 없이 사람 사용자에게 Hardware Keys를 강제할 수 있게 했습니다. v18.11.8에는 클러스터의 모든 사용자 크리덴셜에 하드웨어 키를 요구하면서 세션별 MFA는 요구하지 않고, Machine ID 봇에는 영향을 주지 않는 방법이 추가되었습니다. 원본에 Enterprise 전용으로 표기된 기능입니다.

또한 v18.11.5는 Hardware Keys가 켜진 환경에서 `tsh`와 `tctl`의 성능도 개선했습니다.

### 2) MCP: OAuth 파라미터, Beams VNet, 오류 처리 (v18.11.8, v18.11.10)

- OAuth 파라미터 지정: MCP 서버 앱에 OAuth 파라미터를 지정할 수 있습니다 (v18.11.8).
- Beams의 VNet 터널: Beams 안의 VNet이 streamable-HTTP MCP 앱을 터널링해, Beam 안의 MCP 클라이언트가 해당 앱에 접근할 수 있습니다 (v18.11.8).
- 접근 거부 시 오류 반환: Application Service가 MCP 서버 접근을 거부하면 클라이언트에 오류 대신 연결 끊김이나 멈춤이 나타나던 문제가 수정되었습니다 (v18.11.8).
- tool-list 응답 필드 누락: MCP tool-list 응답에서 필드가 빠지던 문제가 수정되었습니다 (v18.11.10).
- Beam 감사 이벤트 재생: 트래픽 캡처와 세션 종료 이벤트를 포함한 Beam 관련 감사 이벤트를 재생할 수 있습니다 (v18.11.10).

### 3) tbot·Machine ID와 스코프 조인 토큰 (v18.11.8, v18.11.9)

스코프(Scopes) 기반 접근이 조인 방식으로 더 넓어졌고, tbot application proxy 동작도 바뀌었습니다.

- `terraform_cloud`, `spacelift`, `bitbucket`, `env0` 조인 방식이 스코프 토큰을 지원합니다 (v18.11.8).
- `usage_mode: single`이 모든 스코프 조인 방식에서 올바르게 동작합니다 (v18.11.8).
- tbot 서비스 `workload-identity-aws-roles-anywhere`에서 스코프를 사용할 수 있습니다 (v18.11.8).
- tbot application proxy가 업스트림 연결을 재사용해 성능이 개선되었습니다 (v18.11.8).
- tbot application proxy는 3xx 응답을 따라가지 않고 클라이언트에 그대로 반환합니다 (v18.11.8, v17.7.34).
- tbot application tunnel에 유휴 타임아웃 옵션이 추가되었고, application proxy와 tunnel의 타임아웃 처리가 개선되었습니다 (v18.11.8).
- 갱신 루프에 지터가 추가되어 대규모 환경의 부하가 분산됩니다 (v18.11.9).

### 4) 멀티플렉싱 프록시와 MFA 세리머니 (v18.11.8, v18.11.9)

- AWS 앱 멀티플렉싱: 하나의 `tsh proxy` 또는 `tsh aws --exec` 명령으로 여러 AWS 앱을 다룰 수 있습니다 (v18.11.8).
- 단일 MFA 세리머니: 하나의 멀티플렉싱 로컬 `tsh proxy`를 거치는 여러 애플리케이션의 인증서를 한 번의 MFA 세리머니로 발급합니다 (v18.11.8).
- `tsh aws proxy` 사용성: 역할 선택이 모호하지 않으면 앱에 먼저 로그인하지 않아도 동작하고, `--all` 플래그로 권한이 있는 모든 AWS 앱을 프록시할 수 있습니다 (v18.11.9).
- Kubernetes 동시 요청: `tsh proxy kube`에서 동시 요청을 HTTP/2로 멀티플렉싱해 연결 수와 Hardware Key 서명 횟수를 줄입니다. TLS 핸드셰이크도 업스트림 연결 재사용으로 줄었습니다 (v18.11.9).
- 클러스터 하나에 에이전트가 없을 때: Kubernetes 클러스터 하나에 실행 중인 에이전트가 없으면 `tsh proxy kube`가 모든 클러스터에서 실패하던 문제가 수정되었습니다 (v18.11.9).

### 5) 대규모 클러스터 성능과 안정성 (v18.11.5, v18.11.8, v18.11.9)

- 에이전트가 많은 클러스터에서 Auth Service가 시작하거나 클러스터 상태 저장소 연결을 다시 맺은 직후의 CPU 사용량이 줄었습니다 (v18.11.8).
- Kubernetes Service 에이전트가 많은 클러스터의 Auth Service CPU 사용량이 줄었습니다 (v18.11.8).
- Athena 감사 로그 소비자의 메모리 사용량이 줄었습니다 (v18.11.8).
- 접근 검사 성능이 개선되어 리소스 목록 조회 시 Auth Service CPU 사용량이 줄었습니다 (v18.11.9).
- SSH 서버, Kubernetes 클러스터, 애플리케이션을 읽거나 나열할 때 발생하던 과도한 데이터베이스 읽기가 수정되었습니다 (v18.11.9).
- 앱 서버가 많은 클러스터에서 app service가 시작할 때 메모리를 많이 쓰던 문제가 수정되었습니다 (v18.11.9).
- v18.11.5는 대규모 클러스터에서 auth 백엔드 연결이 일시적으로 끊겼을 때의 안정성, 에이전트 재연결 비용과 복구 시간, Role과 User 목록 조회 성능, Role·App·Database 등 리소스 처리 성능을 개선했습니다.

---

## 세부 기능 개선 사항

핵심 분석에서 다룬 항목을 제외한 개선을 영역별로 정리했습니다. 괄호 안은 해당 변경이 들어간 버전입니다. 원본에 Enterprise로 표기된 항목은 `[Enterprise]`로 표시했습니다.

### 접근·인증

1. SSO 웹 세션과 삭제된 사용자 (v18.11.8)

- 더 짧게 설정한 `tsh login`이 SSO 사용자의 웹 세션을 중간에 끊지 않습니다. 삭제된 사용자는 404 화면 대신 로그인 페이지로 이동합니다.

2. 웹·앱 세션의 사용자·Role 누락 처리 (v18.11.9)

- 사용자나 Role이 없어진 웹 세션과 앱 세션을 일관된 재로그인 흐름으로 처리합니다.

3. SSO 사용자 MFA 디바이스 초기화 (v18.11.8)

- SSO 사용자의 MFA 디바이스를 초기화할 수 있습니다.

4. SAML IdP의 Access Request 속성 매핑 (v18.11.8)

- Teleport SAML IdP가 사용자의 활성 Access Request 속성 매핑을 지원합니다.

5. `saml_idp_service_provider` 검증 (v18.11.9)

- API가 생성과 수정 시 속성 값 predicate를 검증합니다.

6. 세션 요약 추론 리소스의 MFA (v18.11.9)

- 세션 요약 추론 리소스의 관리 작업에 MFA가 필요합니다.

7. Access Request 시간대 처리 (v18.11.9)

- 일광 절약 시간 전환 시점에 Access Request 생성이 실패하거나 기간 표시가 틀리던 문제가 수정되었습니다.

8. Access Request 리뷰의 trait 부여 (v18.11.5)

- Access Request 리뷰가 trait을 부여하는 실험적 기능이 옵트인 방식으로 추가되었습니다.

9. Kubernetes Namespace 리소스의 AMR 평가 (v18.11.9)

- Kubernetes Namespace 리소스가 포함된 Access Request에 AMR 평가를 지원합니다.

10. SSH 세션 logind 기록 (v18.11.9, v17.7.34)

- 최신 Linux에서 SSH 세션이 logind에 기록되지 않던 문제가 수정되었습니다. `pam_group.so`도 지원합니다.

11. `tsh` 종료 코드 (v18.11.9)

- `tsh`가 일반적인 SSH exit-status 오류를 출력하지 않으며, 종료 코드와 오류 상세는 그대로 유지됩니다.

### Kubernetes

12. Kubernetes 게이트웨이 TLS 핸드셰이크 감소 (v18.11.9)

- `tsh proxy kube`와 Teleport Connect Kubernetes 게이트웨이가 업스트림 연결을 재사용합니다.

13. 포트 포워드 프록시 goroutine 누수 (v18.11.8, v17.7.34)

- 누수가 Proxy와 Kube 에이전트의 OOM으로 이어질 수 있던 문제가 수정되었습니다.

### 데이터베이스

14. Oracle SCAN (v18.11.9)

- Oracle SCAN을 켠 환경에서 Database Service 연결 문제가 수정되었습니다.

15. PostgreSQL·Redshift 자동 사용자 프로비저닝 (v18.11.9)

- 자동 사용자 생성과 정리의 신뢰성이 개선되었습니다.

16. PostgreSQL 백엔드 (v18.11.9)

- 백엔드 작업 시도마다 30초 타임아웃을 두어 멈춘 쿼리가 풀 연결을 붙잡지 않도록 했고, 연결 풀 지표와 연결 실패 로그를 추가했습니다.

17. DynamoDB 세션 검색 RBAC (v18.11.9, v17.7.34)

- OR 표현식, 맵 참조, 반복 필드를 가진 RBAC predicate가 DynamoDB 기반 세션 검색에 올바르게 적용됩니다.

18. AWS KMS 복제 키 태그 (v18.11.9)

- 세션 녹화 암호화 키의 AWS KMS 멀티 리전 복제본에 `TeleportClusterEncryption` 대신 `TeleportCluster` 태그가 붙던 문제가 수정되었습니다. 기존 복제본은 키 로테이션 전까지 이전 태그를 유지합니다.

19. `dynamo_requests` 충돌 표기 (v18.11.8)

- 충돌을 오류로 표시하지 않고 `"conflict"` 레이블로 구분합니다.

### 자동 검색 (Discovery)

20. `tctl discovery databases` (v18.11.8)

- Teleport Discovery Service가 찾은 AWS 데이터베이스의 가용성을 보고합니다.

21. EC2 자동 검색 처리 (v18.11.8, v18.11.9)

- SSM 설치 그룹을 제한된 동시성으로 병렬 처리하고, 겹치는 matcher가 같은 스캔에서 SSM 설치 명령을 중복 제출하지 않도록 했습니다. SSM으로 등록하는 EC2 인스턴스에는 설치 백오프를 추가했습니다.

22. EC2 등록 실패 진단 (v18.11.9)

- SSM 호출 링크와 재시도 정보를 추가했고, UserTask에 재시도 시점과 시도 횟수 메타데이터를 넣었습니다.

23. `discovery_config` 상태 (v18.11.8)

- 가장 최근 동기화에 오류가 없으면 상태의 오류를 지웁니다. 혼합 SSM 설치 배치의 EC2 실패 중복 보고도 수정되었습니다.

24. 표준 레이블 (v18.11.9)

- 자동 검색한 EC2 인스턴스에 `teleport.dev/aws-region`, AWS 데이터베이스와 EKS 클러스터에 `teleport.dev/account-id`, `teleport.dev/aws-region` 레이블이 붙습니다. EC2 인스턴스에는 리전 레이블만 추가됩니다.

### tbot·Machine ID

25. `workload-identity-jwt` 갱신 주기 (v18.11.8)

- JWT-SVID가 일정한 주기로 갱신되지 않던 문제가 수정되었습니다.

26. `workload-identity-api`의 X509-SVID 갱신 (v18.11.9)

- Envoy SDS API로 X509-SVID가 일정한 주기로 갱신되지 않던 문제가 수정되었습니다.

27. 정적 SPIFFE 페더레이션 (v18.11.9, v17.7.34)

- 정적 SPIFFE 페더레이션 구성이 불필요하게 다시 동기화되던 문제가 수정되었습니다.

28. tbot 텔레메트리 메시지 (v18.11.8)

- 익명 텔레메트리가 꺼져 있거나 이미 전송된 경우에도 "waiting for anonymous telemetry to be sent"가 표시되던 문제가 수정되었습니다.

29. Helm 차트 DNS 설정 (v18.11.9)

- tbot과 tbot-spiffe-daemon-set 차트에 `dnsConfig`, `dnsPolicy`를 지원합니다.

30. Bot Instances 보고서 (v18.11.9)

- 고유 버전 표시 한도가 20에서 40으로 올랐습니다.

31. List Bots 페이지네이션 (v18.11.8)

- 봇이 많은 클러스터의 페이지 로딩 시간을 줄이기 위해 List Bots 화면에 페이지네이션이 도입되었습니다.

### Terraform·Operator

32. Azure AKS 등록 모듈 (v18.11.8)

- Terraform 모듈이 Azure AKS 클러스터 등록과 접근을 지원합니다.

33. AWS ECS 배포 (v18.11.8)

- Teleport 에이전트를 AWS ECS에 배포하는 Terraform 모듈과, Database Service를 ECS에 배포하는 에이전트 스킬이 추가되었습니다.

34. 동적 앱 등록 (v18.11.8)

- Operator와 Terraform에서 동적 앱 등록을 지원합니다.

35. `crown_jewel` matcher (v18.11.8)

- Teleport Operator와 Terraform provider가 `crown_jewel` matcher를 지원합니다.

36. `teleportmwi_aws_roles_anywhere` (v18.11.8)

- AWS Roles Anywhere 임시 크리덴셜을 위한 ephemeral 리소스가 MWI Terraform provider에 추가되었습니다.

37. 검색 템플릿 providers 블록 (v18.11.8)

- 생성되는 discovery Terraform 템플릿에 providers 블록이 포함됩니다.

### Desktop Access·Web UI·CLI

38. 공유 디렉터리 파일 복사 (v18.11.8, v17.7.34)

- 대상 데스크톱의 공유 디렉터리에서 로컬로 파일을 복사할 때 파일이 손상될 수 있던 문제가 수정되었습니다.

39. Linux 데스크톱 표시 (v18.11.4)

- Web UI에서 Linux 데스크톱이 보이지 않던 문제가 수정되었습니다.

40. 원격 데스크톱 Prometheus 지표 (v18.11.9)

- Proxy와 데스크톱 에이전트가 원격 데스크톱 연결 시도와 지연 시간 지표를 내보냅니다.

41. `tctl detections` 상태 변경 명령 (v18.11.8)

- `triage`, `resolve`, `close`, `reopen`이 추가되었고, `--reason` 또는 대화형 편집기로 사유를 남깁니다. 플래그 위치 변경은 Breaking Change로 마이그레이션 체크리스트에 정리했습니다.

42. 스코프 통합과 콘솔 앱 (v18.11.9)

- `tsh`와 `tctl`이 스코프 통합, AWS OIDC·Roles Anywhere 콘솔 앱을 지원하고, AWS 콘솔 앱에 스코프를 지원합니다.

43. `phase.yaml` 셸 명령 (v18.11.10)

- 여러 줄로 쓴 셸 명령이 첫 오류에서 실패합니다.

44. Intune 통합 (v18.11.9)

- Intune 통합에서 시스템 크리덴셜을 사용할 수 있습니다.

45. 감사 로그 업로드 로그 (v18.11.9)

- 앱 세션 청크 업로드마다 Auth Service가 "Failed to complete upload"를 기록하던 문제가 수정되었습니다.

### 플러그인·Enterprise

46. [Enterprise] Hardware Keys 강제 (v18.11.8)

- 심층 분석 1)에서 설명했습니다.

47. [Enterprise] Okta Identity Security 동기화 (v18.11.8)

- Teleport Enterprise Cloud에서 Okta Identity Security 동기화를 켤 수 있습니다.

48. Access Request 자동 리뷰 수정 (v18.11.8)

- 보안 수정사항 섹션에서 다룹니다.

49. Identity Security 감사 로그 내보내기 수정 (v18.11.8)

- Access Graph로 가는 스트림이 끝난 뒤 내보내기가 멈추던 문제가 수정되었습니다.

50. Jira 플러그인 (v18.11.8, v17.7.34)

- Jira 응답이 5초를 넘으면 이슈를 만들기만 하고 갱신하지 않던 문제가 수정되었습니다.

### LTS v17.7.34

51. Auth Service 크래시 (v17.7.34)

- 백엔드에 저장된 인증 기관(CA)을 파싱하지 못할 때 Auth Service가 멈추던 문제가 수정되었습니다.

52. Windows 인증 (v17.7.34)

- Teleport가 관리하는 비 AD 사용자로 Windows 인증이 실패하던 문제가 수정되었습니다.

53. Windows Desktop 감사 로그 압축 (v17.7.34)

- Windows Desktop 세션이 남긴 감사 로그의 압축이 무기한 멈추거나 CPU를 제한 없이 쓰던 문제가 수정되었습니다.

54. Bot 종류 보고 (v17.7.34)

- 하트비트에서 Bot 종류가 정확히 보고되지 않던 문제가 수정되었습니다.

55. libnss-extrausers 교착·segfault (v17.7.34)

- 사용자 생성을 켠 Linux 에이전트에서 libnss-extrausers를 쓸 때 발생할 수 있던 교착(deadlock)과 segfault가 수정되었습니다.

56. `tsh scp` (v17.7.34)

- 사용자 홈 디렉터리를 찾지 못하면 SFTP 서버를 띄우지 못하던 문제가 수정되었습니다. 존재하지 않는 파일은 여전히 실패하지만 절대 경로는 정상 처리됩니다.

---

## 보안 수정사항

이번 기간의 보안 관련 변경은 비공개 보안 릴리즈 2건(v18.11.5, v17.7.32)과 그 후속 릴리즈, Teleport Connect의 Electron 업데이트, 보안 성격의 버그 수정입니다. 10월 2일 비공개 릴리즈(v18.11.3, v17.7.30)는 10월 노트에서 다루었습니다.

### 비공개 보안 릴리즈: v18.11.5, v17.7.32

두 릴리즈는 Teleport의 비공개 릴리즈 정책에 따라 배포되었고, 변경 내역은 후속 공개 릴리즈에서 발표됩니다. 비공개 릴리즈 정책은 [SECURITY.md](https://github.com/gravitational/teleport/blob/master/SECURITY.md#private-releases)에서 확인할 수 있습니다. 체인지로그의 v18.11.5 항목에는 배포 날짜가 적혀 있지 않습니다. v17.7.32는 10월 20일에 배포되었습니다.

- v18.11.4 (10-14): v18.11.3 비공개 보안 릴리즈의 후속이며, 비보안 개선으로 Linux 데스크톱 표시 문제 수정 1건을 더했습니다.
- v18.11.6 (10-20): v18.11.5의 후속이며 Go 툴체인 1.26.10 업데이트를 더했습니다.
- v17.7.31 (10-20): v17.7.30의 후속이며 Go 툴체인 1.26.10 업데이트를 더했습니다.
- v17.7.34 (11-06): v17.7.33은 빌드 파이프라인 문제로 건너뛰었습니다. brotli 의존성 업데이트(GHSA-c9gr-gmg4-2vqv), CA 파싱 실패 시 Auth Service 크래시 수정을 포함한 버그 수정과 개선 16건이 들어 있습니다.

### Teleport Connect Electron 43.8.1: CVE-2026-111943 (v18.11.7, v17.7.32)

Electron을 43.8.1로 올려, Teleport Connect(데스크톱 클라이언트)가 CVE-2026-111943과 관련된 인증서를 받아들이지 않도록 했습니다. v18 라인에서는 v18.11.7(10-21), LTS v17 라인에서는 비공개 보안 릴리즈 v17.7.32(10-20)에 들어 있습니다.

### 보안 성격의 수정

- Access Request 자동 리뷰 수정 (v18.11.8): deny 규칙 평가에 실패했거나 리소스를 확인하지 못한 요청이 자동 리뷰에서 승인되던 문제가 수정되었습니다.
- 비활성 trusted cluster CA 캐시 (v18.11.8): 비활성화한 trusted cluster의 인증 기관(CA)이 다음 재시작까지 Auth Service 캐시에 남던 문제가 수정되었습니다.
- `brotli` 의존성 (v18.11.8, v17.7.34): GHSA-c9gr-gmg4-2vqv를 해결하는 업데이트입니다.
- Auth Service CA 파싱 실패 크래시 (v17.7.34): 백엔드에 저장된 인증 기관이 파싱되지 않을 때 Auth Service가 멈추던 문제가 수정되었습니다.
- DynamoDB 세션 검색 RBAC (v18.11.9, v17.7.34): RBAC OR 표현식의 그룹이 유지되고 스칼라가 아닌 세션 필드가 안전하게 평가됩니다.
- 컨테이너 이미지 (v18.11.8, v17.7.34): 모든 Teleport 컨테이너 이미지의 CA 인증서 번들을 갱신하고, distroless 이미지를 debian12에서 debian13으로 올렸습니다.
- 세션 요약 추론 리소스의 MFA (v18.11.9): 관리 작업에 MFA를 요구합니다.

### 런타임 업데이트

- Go 1.26.10 (v18.11.6, v17.7.31)
- Electron 43.8.1 (v18.11.7, v17.7.32)
- distroless 이미지 debian13 (v18.11.8, v17.7.34)

---

## 주요 버그 수정 내역

항목 뒤 괄호는 해당 수정이 들어간 버전입니다.

1. Linux 데스크톱 Web UI 미표시 (v18.11.4)

2. MCP tool-list 응답 필드 누락 (v18.11.10)

3. MCP 접근 거부 시 연결 끊김·멈춤 (v18.11.8)

- Application Service가 접근을 거부해도 클라이언트가 오류를 받지 못하던 문제입니다.

4. `workload-identity-jwt` JWT-SVID 갱신 주기 (v18.11.8)

5. tbot 텔레메트리 대기 메시지 오표시 (v18.11.8)

6. Desktop Access 공유 디렉터리 파일 손상 (v18.11.8, v17.7.34)

7. EC2 자동 검색 실패 중복 보고 (v18.11.8)

8. `discovery_config` 오류 상태 미해제 (v18.11.8)

9. Access Request 자동 리뷰의 잘못된 승인 (v18.11.8)

10. 비활성 trusted cluster CA 캐시 잔존 (v18.11.8)

11. Kubernetes 포트 포워드 프록시 goroutine 누수 (v18.11.8, v17.7.34)

- Proxy와 Kube 에이전트의 OOM으로 이어질 수 있던 문제입니다.

12. TCP 앱 연결의 후발 Application Service 미도달 (v18.11.8)

- 앱 세션 시작 후 조인한 Application Service에 TCP 앱 연결이 닿지 못하던 문제입니다.

13. exec 세션 이벤트 인덱스 중복 (v18.11.8)

14. Identity Security 감사 로그 내보내기 중단 (v18.11.8)

15. Jira 플러그인 이슈 미갱신 (v18.11.8, v17.7.34)

16. `trust_x_forwarded_for` 사용 시 앱 접근의 스트리밍 응답 버퍼링 (v18.11.8)

- Server-Sent Events 등 스트리밍 응답이 끝날 때까지 버퍼링되던 문제입니다.

17. app service 시작 시 높은 메모리 사용 (v18.11.9)

18. AWS KMS 복제 키 태그(`TeleportClusterEncryption` 대신 `TeleportCluster`) (v18.11.9)

19. DynamoDB 세션 검색 RBAC predicate (v18.11.9, v17.7.34)

20. Oracle SCAN Database Service 연결 문제 (v18.11.9)

21. `tsh proxy kube` 클러스터 하나의 에이전트 부재로 전체 실패 (v18.11.9)

22. SSH 서버·Kubernetes 클러스터·앱 조회의 과도한 DB 읽기 (v18.11.9)

23. Access Request 일광 절약 시간 전환 오류 (v18.11.9)

24. Auth Service "Failed to complete upload" 반복 로그 (v18.11.9)

25. SSH 세션 logind 미기록 (v18.11.9, v17.7.34)

26. `workload-identity-api` X509-SVID 갱신 주기 (v18.11.9)

27. 정적 SPIFFE 페더레이션 불필요한 재동기화 (v18.11.9, v17.7.34)

28. Auth Service의 CA 파싱 실패 크래시 (v17.7.34)

29. Windows 인증 실패(Teleport 관리 비 AD 사용자) (v17.7.34)

30. Windows Desktop 감사 로그 압축 중단·CPU 무제한 사용 (v17.7.34)

31. 하트비트의 Bot 종류 오보고 (v17.7.34)

32. libnss-extrausers 사용 시 교착·segfault (v17.7.34)

33. `tsh scp`의 SFTP 서버 기동 실패(홈 디렉터리 없음) (v17.7.34)

---

## 마이그레이션 및 운영 체크리스트

이번 업데이트를 적용할 때 확인할 사항을 정리했습니다. 운영 환경에 적용하기 전에 아래 항목을 검토하시기 바랍니다.

- [필수/Breaking Change] `tctl detections` 플래그 위치 변경 (v18.11.8): `--format`, `--from`, `--to`는 이제 `ls`와 `get` 하위 명령 뒤에 넣어야 합니다. 예: `tctl detections ls --format json`. 스크립트와 자동화에서 하위 명령 앞에 플래그를 쓰고 있다면 수정해야 합니다.
- [필수/Breaking Change] `teleportmwi_kubernetes` 데이터 소스 deprecate (v18.11.8): 같은 이름의 ephemeral 리소스를 사용하도록 안내합니다. 데이터 소스를 쓰는 Terraform 구성을 점검하시기 바랍니다.
- [필수/긴급] 비공개 보안 릴리즈 적용 권고 (v18.11.5, v17.7.32): 변경 내역은 후속 공개 릴리즈에서 발표됩니다. v18 사용자는 v18.11.5 이상(이번 노트 기준 최신 v18.11.10), LTS v17 사용자는 v17.7.32 이상(이번 노트 기준 최신 v17.7.34)으로 업그레이드하는 것이 권장됩니다.
- [필수] Teleport Connect 사용 환경: Electron 수정(CVE-2026-111943)은 v18.11.7과 v17.7.32에 있습니다. 데스크톱 클라이언트 배포본을 이 버전 이상으로 올려야 합니다.
- [확인] 컨테이너 이미지 사용 환경: distroless 이미지가 debian13으로 바뀌었습니다(v18.11.8, v17.7.34). 이미지를 기반으로 확장하거나 내부 스캐너 정책을 두었다면 호환을 확인하시기 바랍니다.
- [확인] tbot application proxy의 3xx 처리: 3xx 응답을 proxy가 따라가지 않고 클라이언트에 그대로 전달합니다(v18.11.8, v17.7.34). 리디렉션을 proxy에서 처리하던 구성이 있는지 확인하시기 바랍니다.
- [확인] Hardware Keys 정책: `human_private_key_policy`를 켜기 전에 사용 중인 에디션, 사용자의 하드웨어 키 보유 여부, 봇이 영향을 받지 않는지를 확인하시기 바랍니다.
- [확인] AWS KMS 복제 키 태그: 태그 수정은 키 로테이션 전까지 기존 복제본에 반영되지 않습니다(v18.11.9).
- [확인] MCP 서버 연결 환경: tool-list 필드 누락 수정은 v18.11.10에 있으므로 이 버전 이상을 기준으로 삼는 것이 좋습니다.
- [권장] 대규모 클러스터: 에이전트가 많은 클러스터는 v18.11.8 이상에서 Auth Service CPU 사용량이 줄어드는지 업그레이드 후 확인하는 것이 좋습니다.
- [확인] LTS v17: v17.7.33은 빌드 파이프라인 문제로 건너뛰었으므로 v17.7.32 다음 릴리즈는 v17.7.34입니다. v17.7.31은 Go 툴체인 1.26.10, v17.7.32는 Electron 수정, v17.7.34는 위 17.7.34 수정을 담고 있습니다.
- 노드 업그레이드 순서 준수: Auth Service, Proxy, Node 순서로 업그레이드를 진행하는 것이 좋습니다.
- 업그레이드 전 백업 수행: 업그레이드 전 데이터베이스와 설정 파일 백업을 수행하는 것이 좋습니다.

---

## 참조 링크 및 버전 정보

이번 업데이트의 상세 정보는 아래 공식 릴리즈 노트에서 확인할 수 있습니다.

### 릴리즈 버전별 상세 정보

| 버전             | 릴리즈 날짜     | 유형         | 비고                                                                                                            |
| -------------- | ---------- | ---------- | ------------------------------------------------------------------------------------------------------------- |
| v18.11.4       | 2026-10-14 | 수정         | v18.11.3 비공개 보안 릴리즈의 후속, Linux 데스크톱 Web UI 표시 수정                                                              |
| v18.11.5       | -          | 비공개 보안 릴리즈 | 상세 내역은 후속 공개 릴리즈에서 발표, `human_private_key_policy`, 대규모 클러스터 성능 개선                                             |
| v18.11.6       | 2026-10-20 | 수정         | v18.11.5의 후속, Go 1.26.10                                                                                      |
| v18.11.7       | 2026-10-21 | 보안         | Teleport Connect Electron 43.8.1(CVE-2026-111943)                                                             |
| v18.11.8       | 2026-10-29 | 기능·수정      | MCP OAuth 파라미터·Beams VNet, tbot·스코프 조인 확장, Terraform·Operator, `tctl detections` Breaking Change              |
| v18.11.9       | 2026-11-06 | 기능·수정      | `tsh` 멀티플렉싱, PostgreSQL·Redshift, EC2 자동 검색 진단, tbot 갱신 지터                                                    |
| v18.11.10      | 2026-11-10 | 수정         | MCP tool-list 필드 누락, Beam 감사 이벤트 재생                                                                           |
| v17.7.31 (LTS) | 2026-10-20 | 수정         | v17.7.30의 후속, Go 1.26.10                                                                                      |
| v17.7.32 (LTS) | 2026-10-20 | 비공개 보안 릴리즈 | Electron 43.8.1(CVE-2026-111943), 상세 내역은 후속 공개 릴리즈에서 발표                                                       |
| v17.7.34 (LTS) | 2026-11-06 | 보안·수정      | v17.7.33 건너뜀(빌드 파이프라인 문제), brotli GHSA-c9gr-gmg4-2vqv, Auth Service CA 파싱 크래시, Windows 인증·Desktop 감사 로그 압축 수정 |

- 공식 체인지로그 (18.x): [Teleport Changelog](https://goteleport.com/docs/changelog/)
- 공식 체인지로그 (17.x LTS): [Teleport 17.x Changelog](https://goteleport.com/docs/ver/17.x/changelog/)
- 비공개 릴리즈 정책: [SECURITY.md#private-releases](https://github.com/gravitational/teleport/blob/master/SECURITY.md#private-releases)
- 다운로드: [goteleport.com/download](https://goteleport.com/download)

::faq::

- q: 이번 기간 Teleport 릴리즈에서 운영자가 먼저 확인할 변경은 무엇인가요?

a: v18.11.5와 v18.11.8에서 세션별 MFA 없이 사람 사용자에게 Hardware Keys를 강제하는 `human_private_key_policy`가 추가되었고, Machine ID 봇은 영향을 받지 않습니다. 원본에 Enterprise 전용으로 표기된 기능입니다. v18.11.8에서는 MCP 서버 앱에 OAuth 파라미터를 지정할 수 있게 되었고, `terraform_cloud`, `spacelift`, `bitbucket`, `env0` 조인 방식이 스코프 토큰을 지원합니다.

- q: 비공개 보안 릴리즈와 Electron CVE 때문에 어떤 버전으로 올려야 하나요?

a: 비공개 보안 릴리즈 v18.11.5와 v17.7.32의 변경 내역은 후속 공개 릴리즈에서 발표됩니다. v18 사용자는 v18.11.5 이상(이번 노트 기준 최신 v18.11.10), LTS v17 사용자는 v17.7.32 이상(이번 노트 기준 최신 v17.7.34)으로 업그레이드하는 것이 권장됩니다. Teleport Connect를 쓴다면 CVE-2026-111943 관련 Electron 수정이 v18.11.7과 v17.7.32에 들어 있으므로 데스크톱 클라이언트 배포본을 이 버전 이상으로 올려야 합니다.

- q: 업그레이드할 때 대비해야 할 Breaking Change가 있나요?

a: v18.11.8에 2건이 있습니다. `tctl detections`의 `--format`, `--from`, `--to`는 `ls`와 `get` 하위 명령 뒤에 넣어야 하므로 `tctl detections ls --format json`처럼 스크립트와 자동화를 수정해야 합니다. `teleportmwi_kubernetes` 데이터 소스는 deprecate되어 같은 이름의 ephemeral 리소스를 쓰도록 안내하므로, 데이터 소스를 쓰는 Terraform 구성을 점검해야 합니다.

::faq-end::

본 콘텐츠는 Teleport Release Note의 [영문 원본](https://github.com/gravitational/teleport/releases)을 한국어로 번역하고 재구성한 것으로 인포그랩은 Teleport의 한국 공식 파트너사입니다.

::button::[비공개 보안 릴리즈와 Breaking Change가 함께 있는 노트입니다. Teleport 공식 파트너 인포그랩과 상담하세요](https://insight.infograb.net/contact/)::

---
