Compartir a través de

Compatibilidad con API en Azure Static Web Apps con Azure App Service

Azure App Service es una plataforma administrada para hospedar aplicaciones web que ejecutan código en servidores. Azure App Service admite muchos entornos de ejecución y marcos, como Node.js, ASP.NET Core, PHP, Java y Python.

Al vincular la aplicación web de Azure App Service a la aplicación web estática, las solicitudes a la aplicación web estática con una ruta que comienza por /api se envían a la misma ruta en la aplicación de Azure App Service.

De forma predeterminada, cuando una aplicación de App Service está vinculada a una aplicación web estática, la aplicación de App Service solo acepta solicitudes que se proxy a través de la aplicación web estática vinculada. Una aplicación de Azure App Service solo se puede vincular a una sola aplicación web estática a la vez.

Todos los planes de hospedaje de Azure App Service están disponibles para su uso con Azure Static Web Apps.

Las opciones de API para Static Web Apps incluyen los siguientes servicios de Azure:

Para más información, consulte la Información general de APIs.

Nota:

La integración con Azure App Service requiere el plan Estándar de Static Web Apps.

No se admite la integración de backend en entornos de pull request de Static Web Apps.

Prerrequisitos

Para vincular una instancia de App Service a la aplicación web estática, debe tener un recurso de App Service existente y una aplicación web estática.

Recurso Descripción
Azure App Service Si aún no tiene una, siga los pasos descritos en la guía Creación de una aplicación web en Azure .
Aplicación web estática existente Si aún no tiene una, siga los pasos descritos en la guía de introducción para crear una aplicación web estática Sin Framework .

Ejemplo

Considere una instancia de Azure App Service existente que expone un punto de conexión a través de la siguiente ubicación.

https://my-web-app.azurewebsites.net/api/getProducts

Una vez vinculado, puede acceder a ese mismo punto de conexión a través de la ruta de acceso api desde la aplicación web estática, como se indica en esta dirección URL de ejemplo.

https://red-sea-123.azurestaticapps.net/api/getProducts

Ambas direcciones URL apuntan al mismo punto de conexión de API. El punto de conexión de App Service debe tener el prefijo /api, ya que Static Web Apps maneja las solicitudes dirigidas a /api y redirige toda la ruta de acceso al recurso vinculado.

Para vincular una aplicación web como back-end de API para una aplicación web estática, siga estos pasos:

  1. En Azure Portal, vaya a la aplicación web estática.

  2. Seleccione APIs en el menú de navegación.

  3. Busque el entorno al que desea vincular la instancia de API Management. Seleccione Vínculo.

  4. En Tipo de recurso back-end, seleccione Aplicación web.

  5. En Suscripción, seleccione la suscripción que contiene la aplicación de Azure App Service que desea vincular.

  6. En Nombre del recurso, seleccione la aplicación azure App Service.

  7. Seleccione Vínculo.

Cuando se completa el proceso de vinculación, las solicitudes a las rutas que comienzan por /api se envían a la aplicación de App Service vinculada.

Administración del acceso a Azure App Service

La aplicación de App Service se configura con un proveedor de identidades denominado Azure Static Web Apps (Linked) que solo permite el tráfico que se realiza mediante proxy a través de la aplicación web estática. Para que la aplicación de App Service sea accesible para otras aplicaciones, actualice su configuración de autenticación para agregar otro proveedor de identidades o cambie la configuración de seguridad para permitir el acceso no autenticado.

Para desvincular una aplicación web de una aplicación web estática, siga estos pasos:

  1. En Azure Portal, vaya a la aplicación web estática.

  2. Seleccione APIs en el menú de navegación.

  3. Busque el entorno que desea desvincular y seleccione el nombre de la aplicación web.

  4. Seleccione Unlink (Desvincular).

Cuando se completa el proceso de desvinculación, las solicitudes a las rutas que comienzan por /api ya no se envían a la aplicación de App Service.

Nota:

Para evitar exponer accidentalmente la aplicación de App Service al tráfico anónimo, el proveedor de identidades creado por el proceso de vinculación no se elimina automáticamente. Puede eliminar el proveedor de identidades denominado Azure Static Web Apps (vinculado) de la configuración de autenticación de la aplicación de App Service.

Eliminación de la autenticación del recurso de App Service

Para permitir que el recurso de App Service reciba tráfico anónimo, siga estos pasos para quitar el proveedor de identidades:

  1. En Azure Portal, vaya al recurso de App Service.

  2. Seleccione Autenticación en el menú de navegación.

  3. En la lista de Proveedores de identidades, elimine el proveedor de identidades relacionado con el recurso de Static Web Apps.

  4. Seleccione Quitar autenticación para quitar la autenticación y permitir el tráfico anónimo al recurso de App Service.

El recurso de App Service ahora puede recibir tráfico anónimo.

Pasos siguientes

Información general acerca de la API

  • Last updated on