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 끌어오기 요청 환경에 연결할 수 없습니다.