애플리케이션 프로그래밍 인터페이스, 즉 API가 큰 인기를 끌고 있습니다.

API는 새로운 개념이 아니지만, 코로나19 기간 중 가속화된 디지털 전환, 소프트웨어 통합 강화, 레거시 앱을 클라우드 플랫폼으로 이전하려는 노력과 같은 최근의 현상으로 인해 API의 무분별한 확산이 지속되고 있으며, 이는 현대 디지털 경제에서 성공하기 위해 조직이 내리는 관리, 보안, 심지어 아키텍처 관련 선택에도 영향을 미치고 있습니다.
본질적으로 API는 기계의 부상을 상징한다고 볼 수 있습니다. 다행히도 아직은 인간이 API의 구축, 관리 및 보안을 통제하고 있습니다.

기본적으로, 이른바 ‘API 용어’로 말하자면, 소비자는 일반적으로 다양한 표준, 스키마 및 사양으로 구성된 통합 인터페이스를 통해 생산자에게 쿼리나 요청을 보냅니다.
예를 들어, 미국 국립기상청(생산자)은 일일 기상 데이터를 보유하고 있습니다. 휴대폰의 날씨 앱(소비자)은 WeatherKit REST API를 통해 이 시스템을 호출하거나, 더 정확히 말하면 쿼리한 다음 날씨 앱의 사용자 인터페이스에 데이터를 표시합니다. 이는 수백만 명의 사용자가 이용하는 인기 앱의 간단한 예이지만, 최신 디지털 경험에서 발생하는 트래픽의 대부분은 기기 간 통신이 차지하며, 이러한 통신은 API를 기반으로 한다는 점에 주목할 필요가 있습니다.

API가 제공하는 기술적 이점 중 비즈니스 가치로 이어지는 요소는 다음과 같습니다:
기술적 이점 | 비즈니스 가치 |
웹 앱의 기본 구현을 추상화합니다. | 조직은 모바일 앱과 마이크로서비스 기반 아키텍처를 신속하게 배포할 수 있습니다. |
개발자가 도구를 활용해 API 소비자를 구현할 수 있도록 타입을 지정합니다. | 리더는 개발 프로세스를 최적화하여 출시 기간을 단축할 수 있습니다. |
일관되고 예측 가능한 정보 교환을 모델링하기 위한 의미 체계와 동작을 정의합니다. | 파트너는 서드파티 통합 기능을 개발하고 이를 통해 수익을 창출할 수 있습니다. |
API 구현에는 여러 가지 고려 사항이 있습니다. 특히 모델링, 버전 관리, 계약 테스트는 설계, 구축 및 유지 관리 과정에서 종속성을 분리하고 상호 운용성을 보장하는 데 도움이 됩니다.
고려 사항 | 설명 | 혜택 |
모델링 | 정보 교환을 표현하고 구조화하기 위한 의미 체계 또는 동작. | 분산 아키텍처 관리 간소화. |
버전 관리 | API 수명 주기 전반의 릴리스 및 유지 관리를 위한 거버넌스 전략. | 최대한의 사용성과 이전 버전과의 호환성. |
계약 테스트 | 소비자와 생산자 간에 정의된 상호작용 및 예상 응답. | 서드 파티 비즈니스 통합과의 예측 가능한 상호작용. |
API를 구축하고 관리하며 보호하는 데 정답이나 오답은 없습니다. 실제로 API가 급증하기 시작하면서 대규모로 활용할 수 있도록 API의 형식과 구조를 표준화할 필요가 생겼습니다. 그렇게 등장한 것이 OpenAPI 이니셔티브와 그 결과물인 OpenAPI 사양(OAS)입니다. Swagger는 OpenAPI 사양의 최초 참조 구현이었으며, 이제 대부분의 도구가 OpenAPI를 사용하도록 통합되었습니다. OpenAPI는 여전히 그 멋진 위용(swagger)을 유지하고 있죠(하하!).
실제로 API는 다양한 표준, 스키마 및 사양을 사용하여 구축할 수 있습니다. 예를 들어 RESTful 방식이나 gRPC 서비스, 또는 GraphQL 스키마와의 연결을 사용할 수 있습니다.
구현

개요
REpresentation State Transfer(REST)는 통합 인터페이스를 설명하기 위한 경량 아키텍처 모델을 제공하며, 기본 전송 프로토콜로 HTTP를 사용하여 가장 일반적으로 적용됩니다.
REST는 API 기반 아키텍처 구현 방식 중 단연 가장 널리 사용되고 있습니다.
혜택
- REST는 몇 가지 매우 기본적인 규칙만 따르며, 진입 장벽이 낮고 도메인 모델이 탄탄하여 비교적 쉽게 구현할 수 있습니다.
- 계층형 시스템이므로 REST 인터페이스 뒤에 있는 시스템의 복잡성은 추상화됩니다. 예를 들어, 소비자는 웹 서비스 뒤의 데이터베이스 시스템과 상호 작용하고 있다는 사실을 알지 못합니다.
- REST는 JSON 및 YAML을 비롯한 다양한 콘텐츠 유형을 유연하게 지원합니다.
사용 시기
- OpenAPI 사양만으로 API의 형태와 구조를 소비자와 공유하기에 충분한 경우.
- 프로듀서에서 컨슈머로 보내는 요청은 기본적으로 상태 비저장 방식이므로, HTTP 헤더를 기반으로 캐싱 여부를 동적으로 결정해야 하는 경우.
- 프로듀서가 제공하는 단일 API의 리소스 모델을 확장하거나 API 게이트웨이를 사용하여 동일한 기본 URL에서 여러 API를 제공하는 경우.

GraphQL은 API를 위한 오픈 소스 데이터 쿼리 및 조작 언어이자, 기존 데이터로 이러한 쿼리를 처리하는 런타임입니다(Facebook에서 개발했으며 현재는 Linux Foundation의 일부입니다).
- 여러 소스에 걸쳐 쿼리할 수 있는 쿼리 언어를 제공합니다.
- 클라이언트가 여러 API에 걸친 필드를 포함해 필요한 필드만 정확히 요청할 수 있으므로, 최초 로딩 시간이 단축됩니다.
- 스키마 언어는 개별 API의 타입과 API가 결합되는 방식을 정의하며, 모든 API에 단일 버전을 적용할 수 있게 해 버전 관리를 간소화합니다.
- 기존 레거시 시스템 위에 적용하여 복잡성을 추상화하는 보완 기술로 활용할 때.
- API 소비자가 광범위하게 상호 연결된 서비스 전반에 걸쳐 일관된 액세스, 필터링 및 쿼리 기능을 필요로 하는 경우.
- 화면 크기와 네트워크 가용성에 제약이 있는 모바일 기기에서.

gRPC는 Linux Foundation의 관리하에 있는 현대적인 오픈 소스 고성능 원격 프로시저 호출(RPC) 프레임워크입니다.
- HTTP/2, 경량 프로토콜 버퍼, 직렬화된 페이로드 및 상태 유지형 구현을 사용하여 뛰어난 성능과 안정성을 제공합니다.
- 로드 밸런싱, 추적, 상태 확인 및 인증을 위한 플러그형 지원.
- 모든 언어를 위한 풍부한 도구 지원을 통해 뛰어난 인터페이스 기능과 메시지 상호 운용성을 제공합니다.
- 분산 컴퓨팅의 라스트 마일에서 디바이스, 모바일 앱 및 브라우저를 백엔드 마이크로서비스에 연결하고, 모바일과 데스크톱/IoT 간 상호작용이 필요한 크로스 플랫폼 앱을 지원합니다.
- 컨테이너 간 트래픽("동서" 트래픽)에 사용됩니다.
- 스트리밍이 필요한 외부 인터페이스("North-South")와 채팅, 금융, 뉴스 등의 스트리밍 앱에 사용됩니다.
이렇게 API의 기본 개념을 살펴본 데 이어, 다음 게시물에서는 API 아키텍처를 구축하고 관리하며 보호하는 방법을 알아본 후, 이 모든 내용을 종합해 레거시 앱을 클라우드 환경에 맞게 리플랫폼하는 과정을 살펴보겠습니다.

한발 앞서 나가고 싶으신가요? 지금 eBook을 다운로드하세요:
API 아키텍처 마스터하기 | O'Reilly eBook
작성자 소개

관련 블로그 게시물
성평등을 향한 여정: 사이버 보안 분야에서 성공적인 커리어를 개척하는 방법에 관한 Jenn Gile과의 Q&A
F5의 ‘성평등을 향한 여정’ 시리즈 네 번째 Q&A에서는 Rachael Shah와 NGINX 제품 마케팅 책임자 Jenn Gile이 사이버 보안 직종에 대한 오해를 바로잡고, 사이버 보안 분야의 성별 격차를 해소하기 위한 조언과 그 이점에 대해 이야기합니다.
TLS 검사에서 피터 파커 원칙 다루기
“큰 힘에는 큰 책임이 따른다.” 볼테르와 처칠도 이와 비슷한 말을 남겼지만, 이 문구는 스파이더맨 코믹스에서 벤 삼촌의 말로 가장 널리 알려져 있습니다. 물론 이 문구가 문화적으로 널리 통용되는 이유 중 하나는 TLS 검사를 비롯해 수많은 상황과 주제에 적용할 수 있기 때문입니다.
Venafi와 F5를 통한 머신 아이덴티티 보호
‘머신 아이덴티티’란 간단히 말해 자동화된 프로세스가 자신의 신원을 식별할 수 있도록 하고, 다른 자동화 시스템과 프로세스가 관련 리소스에 적절한 수준의 접근 권한을 부여하도록 하는 방법을 의미합니다. 이 개념 자체는 새로운 것이 아닙니다. 비교적 새로운 점은 이를 구현해야 하는 규모입니다.
마이너와 미니언: 데이터 유출만이 비용을 초래하는 것은 아닙니다
물론 데이터 유출은 더 큰 비용을 초래할 수 있고(적어도 지금은), 실패 사실을 세상에 드러낼 수밖에 없게 합니다(통지 의무가 있으니까요). 하지만 보안을 단순히 데이터 노출 문제로만 봐서는 안 됩니다. 요즘은 데이터가...
내 클라우드에서 나가!
F5의 Jay Kelley가 전하는 최신 소식에는 Microsoft Office 365용 신규 ID 및 액세스 솔루션을 배포할 때 고려해야 할 사항이 정리되어 있습니다.
Shift(웹 앱) 보안 레터
웹 앱 보안을 개발 초기 단계로 앞당기세요. F5 블로그에서 DevOps 파이프라인 초기에 보안을 통합하여 취약점을 예방하고 시간을 절약하는 방법을 알아보세요.