# etcd v3.4.40

2025-12-17 · [릴리스 노트 원문](https://github.com/etcd-io/etcd/releases/tag/v3.4.40) · [전체 정리](https://ratatosk.io/ko/releases/etcd/v3.4.40)

보안 2 · 중요 수정 2 · 의존성 갱신 1 · 기타 1

## 업그레이드 전 확인

### 업그레이드 안내

- **잠재적 호환성 파괴 변경 사항에 대한 업그레이드 가이드**
  > Please check out [CHANGELOG](https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.4.md) for a full list of changes. And make sure to read [upgrade guide](https://etcd.io/docs/v3.4/upgrades/upgrade_3_4/) before upgrading etcd (there may be breaking changes).

## 보안 (2)

### etcd 인증 로그의 토큰을 지문값으로 대체

- 영향 대상: etcd 서버 인증 (추정)

영향을 받는 로그 메시지에는 이전에 원래 토큰이 포함되어 있었습니다. 여기에는 유효하지 않거나 할당된 JWT, 인증, 유효하지 않은 인증 토큰, 이미 사용되었거나 삭제된 단순 토큰에 관한 메시지가 포함됩니다. 이제 로그에는 토큰의 SHA-256 해시를 16진수로 나타낸 앞 12자만 기록합니다. 단순 토큰 삭제 메시지에는 토큰을 기록하지 않습니다. 인증 응답에는 여전히 토큰을 반환합니다.

> - [Print token fingerprint instead of the original tokens in log messages](https://github.com/etcd-io/etcd/pull/20943)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.4.md

### `golang.org/x/crypto`의 SSH 서버와 에이전트 결함 수정

- 영향 대상: 새 ID 요청을 처리하는 SSH Agent 서버와 GSSAPI 인증 요청을 파싱하는 SSH 서버
- [CVE-2025-47914](https://www.cve.org/CVERecord?id=CVE-2025-47914), [CVE-2025-58181](https://www.cve.org/CVERecord?id=CVE-2025-58181)

잘못된 형식의 새 ID 요청으로 SSH Agent 서버가 패닉을 일으킬 수 있었고, GSSAPI 인증 요청으로 SSH 서버가 메모리를 제한 없이 소비할 수 있었습니다. 이번 릴리스에서는 두 문제를 해결하기 위해 `golang.org/x/crypto`를 v0.45.0으로 업데이트합니다. 릴리스 노트에는 etcd 자체가 두 SSH 기능 중 어느 하나라도 사용하는지 나와 있지 않습니다.

> - Bump [golang.org/x/crypto to 0.45.0 to address CVE-2025-47914, and CVE-2025-58181](https://github.com/etcd-io/etcd/pull/21022).

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.4.md

## 중요 수정 (2)

### `Scripts/build-binary.sh` 빌드에서 의사 버전 보고 방지

- 영향 대상: `Scripts/build-binary.sh`를 사용해 만든 빌드

이 변경 전에는 `buildvcs=false`를 설정하지 않고 스크립트로 빌드하면 `go version`이 의사 버전을 보고할 수 있었습니다.

> - [Scripts/build-binary.sh: use `buildvcs=false` to avoid having a pseudo-version reported by `go version`](https://github.com/etcd-io/etcd/pull/20950)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.4.md

### 릴리스 스크립트의 바이너리 버전 오표시 수정

- 영향 대상: `scripts/release.sh`를 사용해 수행하는 빌드

`scripts/release.sh`가 `./build`를 직접 호출하면 바이너리에 표시되는 버전이 잘못될 수 있었습니다. 이를 해결하기 위해 이제 빌드 호출 시 `GO_BUILD_FLAGS="-v -buildvcs=false"`를 설정합니다.

> - [Use buildvcs=false in release script](https://github.com/etcd-io/etcd/pull/21028)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.4.md

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `- Compile binaries using [go 1.24.11](https://github.com/etcd-io/etcd/pull/21000).`

## 기타 (1)

- 컨테이너 레지스트리 및 Docker 사용 세부 정보

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
