개요
Apigee 프록시 환경은 복사와 붙여 넣기로 늘어납니다. 같은 인증, 로깅, 오류 처리 정책이 각기 따로 관리되는 수백 개의 번들에 존재하게 되면, 보안 변경 하나가 수백 건의 풀 리퀘스트를 처리해야 하는 프로젝트가 됩니다.
과제
토큰 검증에 필수 변경 사항이 생겼지만 프록시마다 개별적으로 적용해야 했고, 팀은 변경이 일관되게 적용되었는지 확인할 수 없었습니다. 오류 응답도 프록시마다 달라서, 클라이언트 팀은 어떤 API를 호출하느냐에 따라 실패를 다르게 처리해야 했습니다. 공유 흐름 전략도, 명명 및 버전 관리 규칙도 없었습니다.
환경
여러 제품 팀이 소유한 프록시로 구성된 Apigee X 환경으로, 금융 서비스 보안 요건하에서 내부 서비스와 파트너용 API 앞단을 담당하고 있었습니다.
접근 방식
AceMQ는 프록시 번들을 소스 코드로 분석해 거의 동일한 정책 블록을 군집화함으로써 중복 규모를 정량화하고, 자연스러운 공유 흐름 경계를 도출했습니다. 결과물은 목표 공유 흐름 아키텍처와 함께, 변경 동결 없이 점진적으로 실행할 수 있는 리팩터링 순서였습니다.
해결책
- 모든 프록시 번들을 정적 분석해 중복된 정책 로직을 군집화하고 중복 규모를 정량화
- 인증, 로깅, 오류 처리, CORS를 아우르는 공유 흐름 아키텍처 정의
- 환경 전반의 오류 응답 형식과 장애 처리 방식 표준화
- 검토 체크리스트와 함께 프록시 명명, 버전 관리, 배포 규칙 수립
- 변경 동결 없이 프록시가 공유 흐름을 도입할 수 있도록 점진적 리팩터링 순서 수립
- 공유 흐름에 둘 정책 결정과 프록시별로 남겨야 할 정책 결정의 기준 정의
성과
보안 관련 정책 변경은 프록시별로 일일이 진행하는 작업에서 공유 흐름 한 곳만 업데이트하면 되는 작업으로 바뀌었고, 클라이언트 팀은 API 전반에서 일관된 오류 의미 체계를 갖게 되었습니다.