OpenFGA
v1.12.1Security2026년 3월 20일
v1.12.1은 OTLP 엔드포인트 URI 파싱 버그를 수정하고, ListObjects 파이프라인 내부를 Go 네이티브 채널로 교체한 유지보수 릴리스입니다.
breakinghttps:// 스킴 설정 시 TLS 강제 활성화 — 설정 점검 필요
OTEL_EXPORTER_OTLP_ENDPOINT에 https:// 스킴을 사용하면 trace.otlp.tls.enabled 값과 무관하게 TLS가 활성화됩니다. 업그레이드 전에 옵저버빌리티 설정을 점검하세요. https:// 엔드포인트를 쓰면서 TLS를 명시적으로 비활성화해뒀던 환경이라면, 이제 TLS가 켜지므로 콜렉터 쪽도 TLS 연결을 받을 수 있는지 확인해야 합니다.
enhancementOTLP URI 스킴 문제 해결 — 우회 설정 정리 가능
기존에는 http://host:4317 형태의 URI를 그대로 넣으면 gRPC 익스포터에 스킴이 그대로 전달돼 오류가 발생했습니다. 스킴을 생략하는 식으로 우회하고 있었다면, 이제 표준 URI 형식을 그대로 써도 됩니다. 배포 설정에서 우회 로직을 제거하고 표준 형식으로 정리하세요.
enhancementListObjects 성능 개선 — 별도 조치 없이 업그레이드만으로 효과
커스텀 Pipe를 Go 네이티브 채널로 대체하면서 ListObjects의 동시 처리 성능이 개선됐습니다. API나 설정 변경은 없습니다. 튜플 검증 로직 리팩터링 효과까지 더해져, ListObjects를 대량으로 호출하는 환경이라면 이번 패치를 적용할 이유가 충분합니다.
주요 변경 (4)
- ListObjects 파이프라인, 커스텀 Pipe 구현 대신 Go 네이티브 채널로 교체 — 동시성 처리가 더 단순하고 디버깅하기 쉬워짐
- 튜플 검증 및 조작 함수 리팩터링으로 부하 상황에서 성능 개선
- grpc-go v1.79.3, grpc-health-probe v0.4.47로 의존성 업그레이드
- OTEL_EXPORTER_OTLP_ENDPOINT에 http:// / https:// 스킴이 포함된 URI를 정상적으로 처리하도록 수정