Keycloak

항목	내용
Java	OpenJDK 21 이상. 공식 시작 가이드는 OpenJDK 25 기준이고, 컨테이너 이미지는 FIPS 지원 때문에 아직 21 을 쓴다^[2]
데이터베이스	운영은 외부 DB 필수 — `postgres` · `mariadb` · `mysql` · `mssql` · `oracle` · `tidb`^[3]. 기본 `dev-file` 은 개발용
TLS	운영은 HTTPS 필수. PEM 인증서 · 키 또는 keystore^[4]
호스트명	운영은 `hostname` 을 고정하고 `hostname-strict=true` 로 둔다^[5]
포트	8080(HTTP) · 8443(HTTPS) · 9000(관리 인터페이스 — health · metrics)
자원	소규모 기준 2 vCPU · 2 GB 이상. 세션이 메모리 캐시에 있으므로 힙을 넉넉히 준다

구성	역할
Realm	사용자 · 클라이언트 · 설정의 격리 단위. `master` realm 은 관리자용이고 서비스는 별도 realm 에 만든다
Client	Keycloak 에 로그인을 위임하는 애플리케이션. OIDC 또는 SAML
User Federation	LDAP · Kerberos 등 외부 사용자 저장소 연동
Identity Provider	다른 OIDC · SAML · 소셜 제공자로 로그인 위임(브로커링)
Authentication Flow	로그인 절차(비밀번호 → OTP 등)를 단계로 조립
`conf/keycloak.conf`	서버 설정 파일. 명령줄 옵션 · 환경변수(`KC_*`)로도 같은 항목을 준다
`kc.sh build` / `start`	빌드 시점 옵션(DB 종류 · 기능 플래그)을 굳힌 뒤 `start --optimized` 로 띄운다

¶ Keycloak