ID 브로커링을 위한 Keycloak 아웃바운드 프록시 구성

서버의 아웃바운드 프록시 환경을 설정하고 토큰 교환을 진단할 때 Keycloak 자체의 변수 우선순위를 적용합니다.

브라우저가 ID 공급자의 로그인 페이지에 도달하고 Keycloak 서버가 반환된 코드를 교환합니다. 이후 교환이 연결되지 않으면 시작 전에 프록시 경로를 Keycloak 프로세스나 컨테이너 환경에 넣으세요:

HTTPS_PROXY=http://proxy.example:8080
NO_PROXY=localhost,internal.example

공용 HTTP 경로의 경우 HTTP 프록시 목록 에서 가져온 주소를 HTTPS_PROXY에 넣습니다. 의도한 우회 대상은 그대로 유지하세요. 토큰 URL은 ID 공급자의 엔드포인트로 남으며 프록시 주소가 아닙니다.

Keycloak의 우선순위는 대상 스킴별 매핑과 다릅니다:

  • HTTP_PROXY 과 HTTPS_PROXY 이 모두 정의되어 있으면 HTTPS_PROXY 이 이깁니다.
  • 소문자 형식이 대문자 형식보다 우선합니다.
  • NO_PROXY 는 쉼표로 구분되며, 이름이 지정된 호스트는 해당 하위 도메인도 제외합니다.

서버가 예상치 못한 경로를 선택하면 이러한 입력을 모두 확인하세요. 브라우저 프록시 설정은 이 환경을 제공하지 않습니다.

연결이 작동한 후 TLS 검증 실패는 Keycloak의 truststore 인터페이스를 통한 신뢰 구성에 속합니다. 경로를 바꾸어도 누락된 인증서 신뢰를 설정할 수 없습니다.

관련 글