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 작업 등의 다양한 범위에서 정책을 적용할 수 있습니다.