Azure API 게이트웨이 만들기

  • 5분

조직에서는 종종 파트너에게 데이터에 대한 액세스를 제공해야 합니다. 이 액세스는 제어되고 관리되어야 합니다.

신발 회사의 예에서 NorthWind Shoes를 비축하는 소매업체는 주문할 수 있는 재고량을 알아야 합니다. 또한 고객은 주문을 받을 시기를 정확히 알려고 합니다.

여기서는 Azure API Management가 작동하는 방법과 API 게이트웨이를 설정하는 방법에 대해 알아봅니다.

Azure API Management

Azure API Management 서비스는 Azure 클라우드에서 호스팅되며 API와 인터넷 사이에 위치합니다. API Management 인스턴스는 Azure API 게이트웨이 역할을 합니다.

API를 게시할 때 Azure Portal을 사용하여 특정 API가 소비자에게 공개되는 방법을 제어할 수 있습니다. 개발자가 일부 API를 데모용으로 자유롭게 사용할 수 있도록 하고, 다른 API에 대한 액세스를 엄격하게 제어하려고 할 수도 있습니다.

API Management를 사용하는 이유는?

API Management는 개발자에게 다양한 혜택을 제공합니다.

  • API 설명서. API를 문서화하면 호출 클라이언트에서 솔루션을 빠르게 통합할 수 있습니다. API Management를 사용하면 OpenAPI와 같은 최신 표준을 통해 API의 구조를 호출 클라이언트에 빠르게 공개할 수 있습니다. 둘 이상의 API 버전이 있을 수 있습니다. 여러 버전을 사용하면 사용하는 앱에서 새 버전을 바로 사용할 필요가 없으므로 앱 업데이트를 준비할 수 있습니다.
  • 속도 제한 액세스. API가 잠재적으로 대량의 데이터에 액세스할 수 있는 경우 클라이언트에서 데이터를 요청할 수 있는 속도를 제한하는 것이 좋습니다. 속도 제한은 모든 클라이언트에 대해 최적의 응답 시간을 유지하는 데 도움이 됩니다. API Management를 사용하면 전체적으로 또는 특정 개별 클라이언트에 대해 속도 제한을 설정할 수 있습니다.
  • 상태 모니터링. 원격 클라이언트가 여러분의 API를 사용하므로 잠재적인 문제 또는 오류를 식별하기 어려울 수 있습니다. API Management를 사용하면 오류 응답 및 로그 파일을 보고 응답 형식별로 필터링할 수 있습니다.
  • 최신 형식(예: JSON). API는 지난 수년간 XML에서 CSV 등에 이르기까지 다양한 데이터 교환 형식을 사용했습니다. API Management를 사용하면 JSON과 같은 최신 데이터 모델을 사용하여 이러한 형식을 공개할 수 있습니다.
  • 모든 API에 대한 연결. 많은 기업에서 API는 여러 국가/지역에 걸쳐 있으며 다양한 형식을 사용합니다. API Management를 사용하면 서로 다른 이러한 API를 모두 최신의 단일 인터페이스에 추가할 수 있습니다.
  • 분석. API를 개발할 때 API가 호출되는 빈도와 어떤 시스템 유형에서 호출하는지 확인하면 도움이 됩니다. API Management를 사용하면 Azure Portal 내에서 이 데이터를 시각화할 수 있습니다.
  • 보안. 시스템 데이터를 처리할 때는 보안이 가장 중요합니다. 무단 위반으로 인해 회사에서는 비용을 낭비하고, 코드를 다시 작성하는 데 시간을 소모하고, 평판을 잃을 수 있습니다. Azure API Management와 함께 사용할 수 있는 보안 도구에는 OAuth 2.0 사용자 권한 부여 및 Microsoft Entra ID와의 통합이 포함됩니다.
  • 가격 책정 계층 API Management는 요청 처리량, SLA, 네트워크 격리, 업그레이드 유연성 등에 필요한 다양한 기능을 갖춘 계층을 제공합니다. Azure API Management 게이트웨이를 만들 때 필요에 맞춰 계층을 선택합니다.

API Management 설정

API Management를 설정하려면 다음을 수행합니다.

  1. API Management 게이트웨이를 만듭니다. 게이트웨이에 사용하는 이름은 .azure-api.net 네임스페이스 내에서 전역적으로 고유해야 합니다.
  2. 기존 Web API를 게이트웨이에 등록합니다. API를 등록하면 소비자가 <gateway>.azure-api.net 엔드포인트에서 API를 사용할 수 있습니다.
  3. 게이트웨이를 통해 기존 API를 호출합니다. 이제 소비자가 엔드포인트 URL에서 API를 호출할 수 있습니다.