API Gateway · API Management

API 앞에서 인증과 한도, 기록을 한곳에서

내부 서비스를 외부 기관과 앱에 API로 열 때 그 앞에 서는 게이트웨이와 관리 콘솔입니다. 키 확인, 호출 한도, 데이터 형식 변환을 게이트웨이 정책으로 처리하고, 이용 기관은 포털에서 활용신청을 해 키를 받습니다. 모든 호출은 거래 로그로 남습니다.

거래 로그예시 화면
  1. 항공 정보 앱기관 플랜GET /flights200 · 182ms
  2. 지자체 포털기본 플랜GET /exhibitions200 · 210ms
  3. 익명—GET /flights401 · 3ms
  4. 지자체 포털기본 플랜GET /exhibitions429 · 4ms
서비스는 그대로
인증 · 한도 · 변환을 게이트웨이 정책으로, 백엔드 수정 없이
신청부터 키 발급까지 포털에서
활용신청 · 승인 · 키 발급, 공공데이터포털 연동
GS 인증 1등급
한국정보통신기술협회 소프트웨어 품질인증(2024)
AI 에이전트로 운영
API 등록 · 배포 · 오류 원인 찾기를 대화로

도입 배경

서비스마다 API를 직접 열면
인증과 한도, 기록이 흩어집니다

직접 공개인증 · 한도 · 로그를 서비스마다 따로
항공 정보 앱지자체 포털내부 업무 시스템운항 정보공연 · 전시회원 정보
MegaAPIM정책은 게이트웨이 한곳에, 서비스는 그대로
항공 정보 앱지자체 포털내부 업무 시스템MegaAPIM운항 정보공연 · 전시회원 정보
직접 공개MegaAPIM
인증서비스마다 자기 방식으로 키나 토큰을 검사합니다.게이트웨이가 API Key · OAuth2 · JWT 정책으로 확인하고, 통과한 요청만 서비스에 넘깁니다.
사용 한도한도를 서비스마다 구현하거나 아예 두지 않습니다.플랜이나 API에 호출 한도(quota)를 걸고, 넘는 요청은 서비스에 닿기 전에 막습니다.
이용 기관키를 담당자가 따로 만들어 전달합니다.이용 기관이 포털에서 활용신청을 하고, 승인되면 키가 발급됩니다.
호출 기록서비스마다 로그 형식과 위치가 다릅니다.모든 호출이 같은 형식의 거래 로그로 한곳에 남습니다.

호출 처리

요청 하나가 게이트웨이에서
처리되는 순서

모든 요청은 다섯 단계를 거치고, 거절된 요청까지 같은 형식의 거래 로그로 남습니다. 상황을 골라 보세요.

요청

항공 정보 앱이 기관 플랜으로 항공편 운항 조회 API를 호출

  1. 호출자 확인키 · 토큰

    승인된 키 · 기관 플랜

  2. 접근 제한IP · 메소드

    허용된 IP · GET

  3. 호출 한도플랜 · API별 한도

    플랜 한도 안

  4. 백엔드 호출상태 좋은 서버로

    서버 2대에 나눠 전달 · XML 응답을 JSON으로

  5. 기록거래 로그

    응답 시간 · 결과 기록

정상 응답앱은 JSON 응답을 받습니다. 운항 정보 시스템은 고치지 않았습니다.
이 호출의 거래 로그
일시
09:12:04
플랜 · 앱
기관 플랜 · 항공 정보 앱
메소드 · 패스
GET /flights
엔드포인트
flight-api-2
응답 시간
182ms
지연 시간
12ms
상태
200

응답 시간은 전체, 지연 시간은 그중 게이트웨이가 쓴 시간입니다. 응답 시간은 긴데 지연 시간이 짧으면 백엔드가 느린 것이라, 원인이 어느 쪽인지 바로 알 수 있습니다. 거래 로그는 검색하고 엑셀로 내려받을 수 있고, 헤더와 본문은 상세 기록을 켠 API만 남기며 민감한 값은 가리거나 암호화해 저장합니다. 설정을 바꾸고 배포할 때도 누가 언제 무엇을 바꿨는지 변경 이력으로 남습니다.

핵심 기능 1 · 정책

보안, 한도, 변환을
API마다 정책으로 붙입니다

41종의 정책 가운데 필요한 것을 골라 순서대로 붙이면 게이트웨이가 요청과 응답에 차례로 적용합니다. 백엔드 서비스 코드는 고치지 않고, 배포할 때마다 버전이 남아 이전 버전으로 되돌릴 수 있습니다.

요청항공 정보 앱
  1. API Key
  2. IP 허용
  3. 호출 한도
백엔드운항 정보 시스템XML 응답
  1. XML → JSON
  2. 헤더 정리
응답JSON
항공편 운항 조회 API · 예시

12호출자 확인

  • API Key
  • Keyless
  • 공공데이터포털 인증
  • OAuth2
  • JWT
  • JWS
  • HMAC
  • Basic
  • JWT 발급
  • JWT 세션
  • 로그아웃 토큰 차단
  • 리프레시 토큰 확인

4접근 제한

  • 역할 기반 접근
  • IP 허용 · 차단
  • 메소드 차단
  • 시간대 제한

10호출 한도 · 트래픽

  • 호출 한도
  • 중복 요청 차단
  • 응답 캐시
  • 재시도
  • 서킷 브레이커
  • 경로 기반 라우팅
  • HTTP 콜아웃
  • Redis 콜아웃
  • 메소드 재정의
  • 지연 주입(시험용)

10백엔드 전달 · 변환

  • XML → JSON
  • JSON → XML
  • JSON → JSON
  • HTML → JSON
  • REST 요청 → SOAP
  • 헤더 변환
  • 쿼리 변환
  • 속성 지정
  • 본문 지정
  • Groovy 스크립트

5검증 · 응답 · 기록

  • JSON Schema 검증
  • 요청 검증
  • 목(mock) 응답
  • 응답 템플릿
  • 본문 기록

핵심 기능 2 · 이용 기관

이용 기관은 포털에서 신청하고
승인되면 키를 받습니다

이용 기관 개발자는 개발자 포털에서 API 문서를 보고 활용신청을 하고, API 담당자는 관리 콘솔에서 승인합니다. 같은 API라도 플랜마다 인증 방식과 한도를 다르게 줄 수 있고, 포털 문서에서 호출 예시와 언어별 클라이언트 코드를 바로 받을 수 있습니다.

플랜 · 예시

기본 플랜

인증
API Key
승인
자동 승인
플랜 정책
호출 한도 낮게
플랜 · 예시

기관 플랜

인증
API Key
승인
담당자 승인
플랜 정책
호출 한도 높게
플랜 · 예시

내부 연계 플랜

인증
게이트웨이가 발급한 토큰
승인
신청 없이
플랜 정책
호출 한도 · 메소드 제한
플랜 · 예시

공공데이터포털 플랜

인증
포털이 보낸 요청인지 확인
승인
포털에서
플랜 정책
호출 한도

호출 한도(quota)는 플랜에 붙이면 구독한 앱마다 API 전체 호출을 세고, API 경로에 붙이면 그 경로의 호출만 셉니다. 두 곳에 나눠 두면 초당 한도와 하루 한도를 함께 걸 수 있습니다.

핵심 기능 3 · AI 에이전트

API 운영을
AI 에이전트에게 맡깁니다

MegaAPIM은 MCP 서버를 함께 제공합니다. API 담당자가 쓰는 AI 에이전트에 연결하면 API 등록과 배포, 시험 호출, 오류 원인 찾기를 대화로 맡길 수 있습니다. 에이전트는 그 담당자가 콘솔에서 할 수 있는 일만 합니다.

새 API 공개

“주문 조회 API를 새로 등록하고 배포해 줘”

API를 등록하고 OpenAPI 문서를 붙인 뒤 게이트웨이에 배포하고, 시험 호출로 응답과 거래 ID를 보여 줍니다.

장애 분석

“어제 오류 난 호출을 찾아서 원인을 알려 줘”

게이트웨이 정책에서 거절됐는지 백엔드가 오류를 냈는지 구분하고, 그 무렵 바뀐 설정이나 배포를 변경 이력에서 찾습니다.

배포 점검

“방금 배포한 API가 모든 게이트웨이에 반영됐는지 확인해 줘”

게이트웨이 노드마다 그 API가 실렸는지 대조하고, 응답이 끊긴 노드나 버전이 다른 노드를 알려 줍니다.

  • 기본으로 꺼져 있습니다플랫폼 설정에서 켜고, 에이전트가 다룰 API를 API마다 고릅니다.
  • 회사망에서만 받습니다사설 IP 대역과 지정한 회사 주소에서 온 요청만 받습니다.
  • 비밀값은 내보내지 않습니다비밀번호, 토큰, API 키는 가려서 보내고, 라이선스 키와 인증서 개인키는 결과에 넣지 않습니다.

설치

고객의 Kubernetes나
서버에 설치합니다

관리 서버를 업데이트하거나 재시작해도 API 서비스는 멈추지 않습니다. 운영자가 바꾼 설정은 관리 저장소에 저장되고, 게이트웨이는 관리 서버를 거치지 않고 저장소에서 직접 읽어 반영합니다.

운영 측API 담당자관리 콘솔에서 설정 · 승인
이용 기관개발자개발자 포털에서 문서 · 활용신청
이용 기관앱 · 시스템API 호출
고객 Kubernetes 클러스터 · 서버MegaAPIM
관리설정 · 배포 · 포털
관리 서버관리 콘솔
포털 서버개발자 포털
관리 저장소MongoDB · PostgreSQL · MySQL · MariaDB · Oracle
게이트웨이API 호출 처리
Gateway대외용
Gateway내부용
+ 확장

호출자 확인접근 제한호출 한도변환상태 확인

기록거래 로그 · 통계
OpenSearch거래 로그 · 대시보드 통계
Redis세션 · 중복 요청 키
기존 서비스백엔드 APIREST · SOAP
API 호출 경로설정 · 기록
설치
Kubernetes에는 Helm 차트로, 일반 Linux 서버에는 설치본으로 설치합니다.
폐쇄망
인터넷 연결 없이 설치하고 운영할 수 있습니다.
관리 저장소
MongoDB, PostgreSQL, MySQL, MariaDB, Oracle 중에서 고릅니다. 새로 설치해도 되고, 운영 중인 DB를 써도 됩니다.
게이트웨이 확장
2코어 게이트웨이 하나가 초당 1,000건을 처리합니다(4KB 요청 기준). 트래픽이 늘면 게이트웨이만 추가하고, 태그로 API를 나눠 대외용과 내부용을 따로 운영할 수 있습니다.
기록
거래 로그와 통계는 OpenSearch에 쌓이고, 보관 기간을 정해 오래된 기록을 정리합니다.
기관 전용 기능
기관에만 필요한 API는 제품 본체와 따로 만들어, 제품을 업그레이드해도 그대로 유지됩니다.
상세 사양
제품 구성
Gateway, Management(관리 콘솔 · 관리 API · MCP 서버), 개발자 포털, 관리 저장소, OpenSearch, Nginx, Redis(선택)
설치 형태
Standalone(Java 실행 환경), Docker, Docker Compose, Kubernetes(Helm 차트). 폐쇄망에 설치할 수 있습니다
지원 환경
Linux x86_64(Ubuntu 22.04 · 24.04 검증), Java 17 이상. 권장 최소 사양 CPU 4코어, 메모리 8GB, 디스크 설치용 10GB와 로그용 50GB 이상
저장소
관리 데이터 MongoDB(6.0 · 8.0) 또는 PostgreSQL, MySQL, MariaDB, Oracle. 호출 기록과 통계 OpenSearch 2.19. 웹 서버 Nginx 1.22
연동 표준
HTTP, HTTPS, HTTP/2, REST, SOAP(REST 요청을 SOAP로 변환), OpenAPI 3.x · Swagger 2.0, 서비스 디스커버리, MCP(HTTP · SSE)
API 인증
Keyless, API Key, OAuth 2.0(토큰 검증 · scope 확인), JWT, JWS, Basic, HMAC, 공공데이터포털 인증
보안
TLS 인증서 관리(JKS · PKCS#12 · PEM), 백엔드 mTLS, 설정 비밀값 ARIA 암호화, 로그 마스킹, 관리자 2차 인증(OTP), LDAP · Keycloak · 소셜 계정 로그인, 역할 기반 권한
가용성
게이트웨이 수평 확장, 백엔드 가중치 분산, 헬스 체크로 장애 서버 제외, 연결 실패 시 다른 서버로 재시도. 저장소 이중화는 별도 협의
운영과 감사
대시보드, API별 · 애플리케이션별 통계, 거래 로그, 포털 사용 로그, API 변경 이력, 노드 상태 확인, 로그 레벨 변경
라이선스 · 기술지원
별도 협의

2026년 11월 기준이며, 제품 개선에 따라 바뀔 수 있습니다.

구축사례

공공기관의 API를
게이트웨이로 열어 왔습니다

고객사사업기간
한국마사회차세대 경마 및 전자카드 시스템의 API 게이트웨이. Kubernetes 환경에서 운영합니다.2025 ~ 운영
한국공항공사통합데이터플랫폼의 API 게이트웨이. 기관 전용 API는 별도 모듈로 분리해 확장했습니다.2024 ~ 운영
한국문화정보원문화데이터 개방 API의 사용 신청, 서비스 키 발급, 사용 현황 관리.2020 ~ 운영
자동차손해배상진흥원경상환자 장기치료 분쟁조정 시스템의 API 게이트웨이. 보험사와 공제조합 등 외부 기관 연계를 맡습니다.2026.10 ~ 구축 중

GS 인증 1등급 · 한국정보통신기술협회(TTA) 소프트웨어 품질인증 · 2024년 10월 · 인증번호 24-0520

도입

운영 중인 API를 가져와 바로 시작할 수 있습니다

  1. 01

    기존 API 등록

    Swagger 명세, JSON, 엑셀로 가져오고, 명세가 없으면 실제 호출 한 건으로 초안을 만듭니다. 백엔드 서비스는 그대로 둡니다.

  2. 02

    정책과 플랜 정하기

    인증 방식과 호출 한도를 정해 플랜으로 묶고 게이트웨이에 배포할 수 있습니다.

  3. 03

    이용 기관 연결

    이용 기관에 키나 토큰을 발급해 API를 호출할 수 있게 합니다.

  4. 04

    운영하며 조정

    거래 로그와 대시보드로 사용량을 보고 플랜과 정책을 조정할 수 있습니다.

문의하실 때 함께 알려 주세요

  • 열 API와 형식(REST · SOAP)
  • API를 쓸 대상(외부 기관 · 내부 시스템)
  • 설치 환경(Kubernetes · VM)
  • DB(새로 설치 · 운영 중인 DB)
도입 문의