125. API 게이트웨이 주요 기능 (API Gateway Functions) - 관문의 역할을 정의하는 핵심 매커니즘

핵심 인사이트 (3줄 요약)

인증 및 인가 (AuthN/AuthZ): 모든 마이크로서비스의 진입점에서 보안 토큰(JWT 등)을 검증하여 허가된 사용자만 접근을 허용한다.
트래픽 제어 (Traffic Control): 로드 밸런싱, 속도 제한(Rate Limiting), 서킷 브레이킹을 통해 백엔드 서비스의 과부하와 장애 확산을 방지한다.
응답 합성 및 변환: 여러 서비스의 데이터를 하나로 합치거나(Aggregation), 프로토콜(HTTP to gRPC) 및 데이터 형식을 변환하여 클라이언트에 최적화된 응답을 제공한다.

Ⅰ. 개요 (Context & Background)

정의: API 게이트웨이가 마이크로서비스 아키텍처에서 수행하는 구체적인 기술적 책임과 서비스들을 의미한다.
배경: 단순한 프록시를 넘어, 클라우드 환경의 복잡한 요청 처리 요구사항을 해결하기 위해 게이트웨이의 기능은 점차 지능화되고 고도화되고 있다.

Ⅱ. 아키텍처 및 핵심 원리 (Deep Dive)

[ API Gateway Functional Components ]
+------------------------------------------+
|            API Gateway Layer             |
+------------------------------------------+
| [Security]     | [Traffic]    | [Utility]|
| - OAuth/JWT    | - Load Bal.  | - Log/Mon|
| - IP Filtering | - Throttling | - Caching|
| - SSL Term.    | - Circuit Br.| - Transform|
+-------+------------+------------+--------+
        |            |            |
  +-----------+ +-----------+ +-----------+
  | Service A | | Service B | | Service C |
  +-----------+ +-----------+ +-----------+

주요 기능 상세:
1. 라우팅 (Routing): 호스트 이름, 경로, 헤더 정보를 기반으로 요청을 목적지 서비스로 전달한다.
2. 프로토콜 변환 (Protocol Mediation): 외부의 REST/JSON 요청을 내부의 gRPC나 AMQP 메시지로 변환한다.
3. 속도 제한 (Rate Limiting/Throttling): 특정 클라이언트가 너무 많은 요청을 보내 시스템을 마비시키지 않도록 임계치를 설정한다.
4. 오프로딩 (Offloading): SSL 인증서 처리, 압축, 캐싱 등 공통 작업을 대신 처리하여 백엔드 부하를 줄인다.

Ⅲ. 융합 비교 및 다각도 분석 (Comparison & Synergy)

기능 유형	주요 상세 설명	기대 효과
보안 기능	인증/인가, SSL 종단, CORS 관리, 웹 방화벽(WAF) 연동	보안 일원화 및 규제 준수
운영 기능	로깅, 지표 수집(Metrics), 분산 추적(Tracing) ID 주입	가시성 확보 및 장애 원인 파악 용이
성능 기능	응답 캐싱, 정적 콘텐츠 서빙, 요청 압축	레이턴시 감소 및 대역폭 절약
복원력 기능	재시도(Retry) 로직, 서킷 브레이커, 타임아웃 관리	시스템 전체의 가용성 향상

Ⅳ. 실무 적용 및 기술사적 판단 (Strategy & Decision)

기술사적 판단: 게이트웨이에 너무 많은 비즈니스 로직을 넣는 것은 '안티 패턴'이다. 게이트웨이가 무거워지면 그 자체가 병목이 되고 변경이 어려워지므로, 철저히 **'인프라적 공통 관심사'**에만 집중하도록 설계해야 한다.
실무 전략: 최근에는 '사이드카(Sidecar)' 방식의 서비스 메시와 기능을 나누어 가진다. 외부 트래픽은 API 게이트웨이가, 내부 서비스 간 통신은 서비스 메시(Istio 등)가 담당하는 '계층적 방어 체계'를 구축하는 것이 표준이다.

Ⅴ. 기대효과 및 결론 (Future & Standard)

기대효과: 전체 시스템의 안정성이 강화되고 관리 포인트가 단일화된다. 클라이언트 환경(모바일, 웹)에 맞춰 응답을 다르게 생성하는 등 유연한 서비스 제공이 가능하다.
결론: API 게이트웨이의 기능을 얼마나 정교하게 활용하느냐가 MSA 시스템의 완성도를 결정짓는 척도이다.

📌 관련 개념 맵 (Knowledge Graph)

상위 개념: API 매니지먼트 (APIM), 보안 아키텍처
동급 개념: 서비스 메시(Service Mesh), 인그레스 컨트롤러(Ingress Controller)
연관 기술: JWT, OAuth 2.0, Redis (캐싱/제한용), Prometheus (모니터링)

👶 어린이를 위한 3줄 비유 설명

백화점 정문에서 표를 검사하고(인증), 너무 많은 사람이 들어오면 줄을 세워요(속도 제한).
또, 여러 가게의 전단지를 모아서 한꺼번에 손님에게 나눠주기도 하죠(응답 합성).
이렇게 입구에서 많은 일을 해주니 백화점 안의 가게들이 장사에만 집중할 수 있답니다!