Azure Spring Apps Enterprise 계획을 사용하여 API Portal을 Azure API Management로 마이그레이션
참고 항목
기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.
표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container Apps로 마이그레이션을 참조 하세요.
이 문서는 기본/표준 ✅ 엔터프라이즈에 ❎ 적용됩니다.
이 문서에서는 API Portal을 Azure API Management로 마이그레이션하는 방법을 설명합니다.
Azure API Management는 API 정의를 보고 브라우저에서 직접 특정 API 경로를 테스트하기 위한 중앙 집중식 인터페이스를 제공합니다. 또한 향상된 보안 및 원활한 액세스를 위해 SSO(Single Sign-On)를 지원합니다. Azure Spring Apps를 사용하여 API Portal에서 Azure API Management로 마이그레이션하면 확장성, 보안 및 다른 Azure 서비스와의 통합이 향상됩니다.
필수 조건
- API Portal을 사용하도록 설정된 기존 Azure Spring Apps Enterprise 계획 인스턴스입니다.
- 기존 Azure 컨테이너 앱입니다. 자세한 내용은 빠른 시작: Azure Portal을 사용하여 첫 번째 컨테이너 앱 배포를 참조하세요.
API Management 인스턴스 만들기
다음 단계를 사용하여 API Management 인스턴스를 만듭니다.
Azure Portal의 검색 창에서 API Management 를 검색합니다.
결과에서 API Management 서비스를 선택한 다음 만들기를 선택합니다.
다음과 같은 필수 정보를 제공합니다.
- 구독: 서비스에 대한 Azure 구독을 선택합니다.
- 리소스 그룹: 기존 리소스 그룹을 선택하거나 새로 만들기를 선택하여 새 리소스 그룹을 만듭니다.
- 지역: API Management 인스턴스의 위치 또는 지역을 선택합니다.
- 리소스 이름: API Management 인스턴스에 대한 전역적으로 고유한 이름을 제공합니다.
- 조직 이름: 조직의 이름을 지정합니다.
- 관리자 이메일: API Management 인스턴스와 관련된 알림에 사용되는 이메일 주소를 제공합니다.
사용 사례에 따라 가격 책정 계층을 선택합니다. 언제든지 나중에 가격 책정 계층을 업그레이드하거나 변경할 수 있습니다.
모니터링 및 가상 네트워크 설정과 같은 선택적 설정을 구성합니다.
검토 + 만들기를 선택하여 설정을 검토하고 구성의 유효성을 검사합니다.
유효성 검사가 완료되면 만들기를 선택합니다. 배포하는 데 30~40분이 걸릴 수 있습니다.
배포가 완료되면 API Management 서비스 페이지로 이동하여 새로 만든 서비스를 봅니다.
API Management에서 노출된 API 가져오기
API Management에는 API를 수동으로 추가하거나 API 사양 파일을 가져오는 두 가지 옵션이 있습니다.
수동으로 API 추가
다음 단계를 사용하여 수동으로 API를 추가합니다.
Azure Portal에서 API Management 인스턴스로 이동합니다. API 섹션에서 API 추가를 선택합니다.
새 API 정의 창에서 HTTP 옵션을 선택하여 HTTP API를 수동으로 정의합니다.
다음 API 기본값을 입력한 다음, 만들기를 선택하여 저장합니다.
- 표시 이름: API의 이름을 제공합니다.
- 이름: API에 대한 고유 식별자를 입력합니다.
- 웹 서비스 URL: Container Apps 백 엔드 API의 기본 URL을 지정합니다.
- API URL 접미사: 이 API에 대한 접미사(예 : /api/customers-service)를 정의합니다.
새 API 엔드포인트를 만들려면 작업 추가를 선택한 다음, 다음 단계를 사용합니다.
- 일반 정보를 제공합니다. 입력 표시 이름 및 이름입니다.
- URL, 쿼리 매개 변수,
POST요청 및 응답 등과GET- 같은 작업에 대한 세부 정보를 제공합니다. - 모든 작업을 추가한 후 API를 저장합니다.
추가된 API의 이름을 선택합니다. 디자인 탭에서 추가된 모든 작업을 볼 수 있습니다.
API 사양 파일 가져오기
API의 OpenAPI 사양(Swagger 정의)이 있는 경우 다음 단계를 사용하여 API Management로 직접 가져올 수 있습니다.
Azure Portal에서 API Management 인스턴스로 이동합니다.
API에서 API 섹션을 엽니다.
API 추가를 선택합니다.
정의에서 만들기의 경우 REST API에 대한 표준 언어 독립적 인터페이스를 만드는 OpenAPI 옵션을 선택합니다.
다음 단계를 사용하여 OpenAPI 사양에서 API를 만듭니다.
- 로컬 API 사양 파일이 있는 경우 파일을 업로드할 파일 선택을 선택합니다. 또는 OpenAPI 사양에 공개적으로 액세스할 수 있는 URL 을 제공합니다.
- API에 대한 표시 이름, 이름 및 API URL 접미사 값을 제공하여 API 설정을 더 구체화할 수 있습니다.
- 구성을 저장하려면 만들기를 선택합니다.
추가된 API의 이름을 선택합니다. 디자인 탭에서 추가된 모든 작업을 볼 수 있습니다.
API Management에서 API 사용해 보기
Azure API Management는 Azure Portal 내에서 기본 제공 테스트 콘솔 을 제공하므로 외부 도구 없이도 API와 쉽게 상호 작용할 수 있습니다. 다음 단계를 사용하여 API를 테스트합니다.
Azure Portal에서 API Management 인스턴스로 이동합니다.
API 섹션 아래에서 목록에서 테스트할 API를 선택합니다.
작업을 선택합니다. API의 개요 페이지 내에서 사용 가능한 작업(엔드포인트) 목록을 볼 수 있습니다. 테스트할 작업을 선택합니다.
테스트 탭을 선택하여 Azure Portal 내에서 엽니다.
요청 매개 변수를 구성합니다. API 메서드에 따라 경로 매개 변수, 쿼리 매개 변수, 헤더 또는 본문과 같은 요청에 필요한 매개 변수를 입력합니다. API에
Authorization Token필요한 경우 헤더에 포함해야 합니다.요청을 보냅니다. 요청 세부 정보를 제공한 후 보내기를 선택합니다. API의 응답은 응답 코드, 응답 본문 및 헤더를 포함하여 Azure Portal에 직접 표시됩니다.
응답을 검사합니다. 응답 데이터, 상태 코드 및 API 또는 요청에 대한 문제를 나타낼 수 있는 오류 메시지를 검토합니다.
API Management로 Single Sign-On 마이그레이션
API Portal에서 SSO(Single Sign-On)를 사용하도록 설정하고 API Management에 대한 요청을 인증하려는 경우 다음 단계를 사용하여 API Management에서 ID를 구성합니다.
Azure Portal에서 API Management 인스턴스로 이동합니다.
개발자 포털>ID로 이동합니다.
추가를 선택한 다음, Azure Active Directory를 선택합니다.
필수 필드를 입력합니다.
- 클라이언트 ID: 등록된 Microsoft Entra ID 애플리케이션의 애플리케이션 또는 클라이언트 ID입니다.
- 클라이언트 암호: Microsoft Entra ID 애플리케이션의 비밀입니다.
-
로그인 테넌트: Microsoft Entra ID 테넌트 도메인 이름(예: )
yourcompany.onmicrosoft.com -
리디렉션 URL: 일반적으로
https://{your-apim-instance}.developer.azure-api.net/signin.
추가를 선택하여 ID 공급자를 저장합니다.
새로 추가된 ID 공급자를 저장하기 전에 Microsoft Entra ID 클라이언트 앱의 허용된 리디렉션 URL 목록에 리디렉션 URL을 추가해야 합니다.
API Management에 대한 자세한 구성은 API Management 설명서를 참조 하세요.