# Keycloak 26.4.7

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

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

## 업그레이드 전 확인

### 업그레이드 안내

- **업그레이드 전 변경 사항을 다루는 마이그레이션 가이드**
  > Before upgrading refer to the migration guide for a complete list of changes.

## 중요 수정 (2)

### IDP 그룹 매퍼의 멤버십 충돌 해결

- 영향 대상: 한 요청에서 여러 IDP 그룹 매퍼가 같은 그룹의 멤버십을 변경하는 경우

한 매퍼는 그룹에 추가하고 다른 매퍼는 그룹에서 제거하려는 경우, 항상 추가가 우선됩니다.

> #44480 Wrong persistent group permissions when multiple group membership changes happen in the same request core

### SAML 동시 초기화 실패 수정

- 영향 대상: SAML 인증 (추정)

여러 요청이 SAML 관련 초기화를 동시에 촉발하면, 특히 ThreadLocal `DocumentBuilder` 인스턴스를 생성하는 동안 SAML 모듈에서 `ConcurrentModificationException`이 발생할 수 있었습니다. 이로 인해 시작에 실패할 수 있었고, 인증을 시도하는 클라이언트는 HTTP 400 응답을 받을 수 있었습니다.

> #44438 Intermittent ConcurrentModificationException during SAML initialization causing status code 400 for clients saml

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `#43643 Upgrade to Quarkus 3.27.1 dist/quarkus`

## 기타 (1)

- HTTP 액세스 로그 헤더 로깅 문서 업데이트

---

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