API Management 서비스 살펴보기

  • 3분

API Management는 개발자 참여, 비즈니스 통찰력, 분석, 보안과 보호 등을 통해 성공적인 API 프로그램을 보장하는 핵심 기능을 제공합니다. 각 API는 하나 이상의 작업으로 구성되며, 각 API는 하나 이상의 제품에 추가할 수 있습니다. 개발자는 API를 사용하기 위해 해당 API가 포함된 제품을 구독한 다음 유효할 수 있는 사용 정책에 따라 API의 작업을 호출할 수 있습니다.

API Management 구성 요소

Azure API Management는 API 게이트웨이, 관리 평면, 개발자 포털로 구성됩니다. 이러한 구성 요소는 기본적으로 Azure에서 호스트되고 완전히 관리됩니다. API Management는 용량과 기능이 다른 다양한 계층에서 사용할 수 있습니다.

  • API 게이트웨이 는 다음 작업을 수행하는 엔드포인트입니다.

    • API 호출 수락 후 적절한 백 엔드로 라우팅합니다.
    • 요청과 함께 제공되는 API 키 및 기타 자격 증명을 확인합니다.
    • 사용 할당량 및 속도 제한을 적용합니다.
    • 정책 문에 지정된 요청 및 응답을 변환합니다.
    • 응답을 캐시하여 응답 대기 시간을 개선하고 백 엔드 서비스의 부하를 최소화합니다.
    • 모니터링, 보고 및 문제 해결을 위한 로그, 메트릭 및 추적 내보내기

  • 관리 평면은 API 프로그램이 설치되는 관리 인터페이스입니다. 다음 작업을 수행하는 데 사용합니다.

    • API Management 서비스 설정 프로비저닝 및 구성
    • API 스키마 정의 또는 가져오기
    • 제품에 API 패키징
    • API에서 할당량 또는 변환 등의 정책 설정
    • 분석에서 인사이트 얻기
    • 사용자 관리

  • 개발자 포털은 API 설명서를 사용하여 원하는 대로 사용자 지정 가능한 자동 생성 웹 사이트입니다. 개발자 포털을 사용하여 개발자는 다음을 수행할 수 있습니다.

    • API 설명서를 읽습니다.
    • 대화형 콘솔을 통해 API를 호출합니다.
    • 계정을 만들고 구독하여 API 키를 받습니다.
    • 자신의 사용량에 대한 분석에 액세스합니다.
    • API 정의를 다운로드합니다.
    • API 키를 관리합니다.

제품

제품은 API가 개발자에게 표시되는 방식입니다. API Management에서 제품은 하나 이상의 API를 가지며 제목, 설명, 사용 약관 등으로 구성됩니다. 제품은 개방형 또는 보호된 제품일 수 있습니다. 보호된 제품은 사용하기 전에 구독해야 하는 반면, 개방형 제품은 구독하지 않고 사용할 수 있습니다. 구독 승인은 제품 수준에서 구성되며 관리자 승인을 요구하거나 자동 승인될 수 있습니다.

그룹

그룹은 제품을 개발자에게 표시하는 옵션을 관리하는 데 사용됩니다. API Management에는 다음과 같은 변경할 수 없는 시스템 그룹이 있습니다.

  • 관리자 - API Management 서비스 인스턴스를 관리하며 개발자가 사용하는 API, 작업 및 제품을 만듭니다. Azure 구독 관리자가 이 그룹의 구성원입니다.
  • 개발자 - API를 사용하여 애플리케이션을 빌드하는 인증된 개발자 포털 사용자입니다. 개발자는 개발자 포털에 액세스할 수 있는 권한을 받으며 API의 작업을 호출하는 애플리케이션을 빌드합니다.
  • 게스트 - 인증되지 않은 개발자 포털 사용자입니다. 예를 들어 API를 볼 수 있지만 호출할 수는 없는 기능과 같이 특정 읽기 전용 액세스 권한을 받을 수 있습니다.

관리자는 이러한 시스템 그룹 외에도 사용자 지정 그룹을 만들거나 연결된 Microsoft Entra 테넌트에서 외부 그룹을 사용할 수 있습니다.

개발자

개발자는 API Management 서비스 인스턴스의 사용자 계정을 나타냅니다. 개발자는 개발자(administrator)가 만들거나 참여하도록 초대할 수 있으며 개발자 포털에서 등록할 수도 있습니다. 각 개발자는 하나 이상의 그룹의 구성원이며 해당 그룹에 대한 가시성을 부여하는 제품을 구독할 수 있습니다.

정책

정책은 API의 요청이나 응답에 따라 순차적으로 실행되는 명령문의 컬렉션입니다. 많이 사용되는 명령문에는 XML에서 JSON으로 형식 변환, 개발자로부터 들어오는 호출 수를 제한하는 호출 속도 한도 등이 포함되며 다양한 다른 정책도 사용할 수 있습니다.

정책이 다르게 지정하지 않는 한 정책 식은 어떤 API Management 정책에서든 특성 값 또는 텍스트 값으로 사용될 수 있습니다. 제어 흐름 및 변수 설정 정책 등의 일부 정책은 정책 식을 기반으로 합니다.

사용자의 요구에 따라 전역(모든 API), 제품, 특정 API 또는 API 작업 등의 다양한 범위에서 정책을 적용할 수 있습니다.