Azure Static Web Apps에서의 API 지원 개요

프런트 엔드 웹 애플리케이션은 종종 데이터 및 서비스에 대한 백 엔드 API를 호출합니다. Azure Static Web Apps는 Azure 서비스와의 통합을 통해 기본 제공 서버리스 API 엔드포인트를 제공합니다.

Azure Static Web Apps API의 주요 기능은 다음과 같습니다.

  • 사용자 인증 및 역할 기반 권한 부여 데이터에 직접 액세스하는 통합 보안

  • 사용자 지정 CORS 규칙 없이 프런트 엔드 웹앱에서 /api 경로를 사용할 수 있도록 하는 원활한 라우팅.

API 옵션

다음 Azure 서비스는 Azure Static Web Apps으로 통합할 수 있습니다.

서비스 관리형 자체 환경 사용
Azure Functions
Azure API Management
Azure App Service
Azure Container Apps
  • 관리되는 API: 기본적으로 Azure Static Web Apps는 Azure Functions를 사용해 API 백 엔드로 자동으로 통합됩니다. 별도의 Azure Functions 리소스를 관리하지 않고 정적 웹앱으로 API를 배포합니다.
  • 사용자 고유의 API 가져오기: 정적 웹앱을 Azure Functions, API Management, App Service 또는 Container Apps에서 호스트되는 기존 API와 통합할 수 있습니다. API 리소스를 직접 관리하고 배포합니다.

참고 항목

사용자 API 가져오기는 Azure Static Web Apps 표준 플랜에서만 사용할 수 있습니다. 기본 제공 관리형 Azure Functions API는 모든 Azure Static Web Apps 플랜에서 사용할 수 있습니다.

API 제약 조건

다음 제약 조건은 모든 API 백 엔드에 적용됩니다.

  • 각 정적 웹앱 환경은 한 번에 하나의 유형의 백 엔드 API로만 구성할 수 있습니다.
  • API 경로 접두사는 .이어야 /api합니다.
  • API에 대한 경로 규칙은 리디렉션역할을 사용한 경로 보안만 지원합니다.
  • API의 경우 HTTP 요청만 지원됩니다. 예를 들어 WebSocket은 지원되지 않습니다.
  • 각 API 요청의 최대 기간은 45초입니다.
  • 네트워크 격리 백 엔드는 지원되지 않습니다.

사용자 고유의 API 백 엔드 가져오기에는 다음 제약 조건이 적용됩니다.

  • 경로에 대한 요청을 확인하려면 먼저 애플리케이션을 정적 웹앱에 /api 배포해야 합니다.
  • 사용자 고유의 API 백 엔드 가져오기는 Static Web Apps 끌어오기 요청 환경에 연결할 수 없습니다.

다음 단계