Keycloak 토큰 교환으로 인증 시스템 구축

핵심 내용

• Keycloak의 토큰 교환 기능을 활용해 MSA 환경에서 서비스 간 권한 위임과 토큰 재발급 구조를 설명
• 외부 파트너가 원본 토큰을 공유할 수 없는 제약 때문에, 유저 고유 ID만으로 발급 가능한 구형 V1 대행 메커니즘과 보안 프록시 구조를 선택
• 요청자/수신자 클라이언트 간 신뢰 관계 설정, token-exchange 활성화, 정책 매핑을 통해 내부 토큰을 발급하는 구성 정리

주의할 점

• 최신 문서 기준 엔드포인트에서 /auth 경로가 빠졌는지 확인 필요
• invalid_client, 403 not_allowed는 클라이언트 설정과 정책 매핑 누락에서 자주 발생
• 구형 규격 사용 시 브라우저 노출 토큰의 짧은 유효 기간과 망 분리로 위험 완화 필요

적용해볼 점

• 외부 연동 제약이 있더라도 프록시와 Keycloak 정책 설정으로 심리스한 인증 흐름 구성 가능
• 토큰 교환은 서비스 간 신뢰 관계와 권한 범위 제어가 필요한 B2B 인증에 유용