Compartilhar via

Suporte de API nos Aplicativos Web Estáticos do Azure com o Serviço de Aplicativo do Azure

  • Artigo

O Serviço de Aplicativo do Azure é uma plataforma gerenciada para hospedar aplicativos Web que executam código em servidores. O Serviço de Aplicativo do Azure dá suporte a muitos runtimes e estruturas, incluindo Node.js, ASP.NET Core, PHP, Java e Python.

Ao vincular o aplicativo Web do Serviço de Aplicativo do Azure ao aplicativo Web estático, todas as solicitações para o aplicativo Web estático com uma rota que começa com /api são enviadas por proxy para a mesma rota no aplicativo do Serviço de Aplicativo do Azure.

Por padrão, quando um aplicativo do Serviço de Aplicativo está vinculado a um aplicativo Web estático, o aplicativo do Serviço de Aplicativo aceita apenas solicitações que são enviadas por proxy por meio do aplicativo Web estático vinculado. Um aplicativo do Serviço de Aplicativo do Azure só pode ser vinculado a um único aplicativo Web estático por vez.

Todos os planos de hospedagem do Serviço de Aplicativo do Azure estão disponíveis para uso com os Aplicativos Web Estáticos do Azure.

As opções de API para Aplicativos Web Estáticos incluem os seguintes serviços do Azure:

Confira a Visão geral das APIs para obter mais informações.

Observação

A integração com o Serviço de Aplicativo do Azure requer o plano Static Web Apps Standard.

Não há suporte para a integração de back-end em ambientes de solicitação pull de Aplicativos Web Estáticos.

Pré-requisitos

Para vincular um Serviço de Aplicativo ao seu aplicativo Web estático, você precisa ter um recurso do Serviço de Aplicativo existente e um aplicativo Web estático.

Recurso Descrição
Serviço de Aplicativo do Azure Se você ainda não tiver um, siga as etapas no guia Criar um aplicativo Web no Azure .
Aplicativo Web estático existente Se você ainda não tiver um aplicativo Web estático, siga as etapas no guia de introdução para criar um sem estrutura.

Exemplo

Considere uma instância existente do Serviço de Aplicativo do Azure que exponha um ponto de extremidade por meio do seguinte local.

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

Depois de vinculado, você pode acessar esse mesmo ponto de extremidade por meio do caminho api do seu aplicativo Web estático, conforme mostrado nesta URL de exemplo.

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

Ambas as URLs apontam para o mesmo ponto de extremidade da API. O ponto de extremidade no Serviço de Aplicativo deve ter o prefixo, já que os Aplicativos Web Estáticos correspondem às solicitações feitas e /api fazem proxy de todo o caminho para o /api recurso vinculado.

Para vincular um aplicativo Web como o back-end da API para um aplicativo Web estático, siga estas etapas:

  1. No portal do Azure, navegue até o aplicativo Web estático.

  2. Selecione APIs no menu de navegação.

  3. Localize o ambiente ao qual você deseja vincular a instância de Gerenciamento de API. Selecione Vincular.

  4. No tipo de recurso back-end, selecione Aplicativo Web.

  5. Na Assinatura, selecione a assinatura que contém o aplicativo do Serviço de Aplicativo do Azure que você deseja vincular.

  6. No Nome do recurso, selecione o aplicativo Serviço de Aplicativo do Azure.

  7. Selecione Vincular.

Quando o processo de vinculação for concluído, as solicitações para rotas que começam com /api são enviadas por proxy para o aplicativo do Serviço de Aplicativo vinculado.

Gerenciar o acesso ao Serviço de Aplicativo do Azure

Seu aplicativo do Serviço de Aplicativo é configurado com um provedor de identidade nomeado Azure Static Web Apps (Linked) que permite apenas o tráfego com proxy por meio do aplicativo Web estático. Para tornar seu aplicativo do Serviço de Aplicativo acessível a outros aplicativos, atualize sua configuração de autenticação para adicionar outro provedor de identidade ou altere as configurações de segurança para permitir o acesso não autenticado.

Para desvincular um aplicativo Web de um aplicativo Web estático, siga estas etapas:

  1. No portal do Azure, navegue até o aplicativo Web estático.

  2. Selecione APIs no menu de navegação.

  3. Localize o ambiente que você deseja desvincular e selecione o nome do aplicativo Web.

  4. Selecione Desvincular.

Quando o processo de desvinculação for concluído, as solicitações para rotas que começam com /api não são mais enviadas por proxy para seu aplicativo do Serviço de Aplicativo.

Observação

Para evitar expor acidentalmente seu aplicativo do Serviço de Aplicativo ao tráfego anônimo, o provedor de identidade criado pelo processo de vinculação não é excluído automaticamente. Você pode excluir o provedor de identidade chamado Aplicativos Web Estáticos do Azure (Vinculado) das configurações de autenticação do aplicativo do Serviço de Aplicativo.

Remover autenticação do recurso do Serviço de Aplicativo

Para habilitar seu recurso do Serviço de Aplicativo para receber tráfego anônimo, siga estas etapas para remover o provedor de identidade:

  1. No portal do Azure, navegue até o recurso Serviço de Aplicativo.

  2. Selecione Autenticação no menu de navegação.

  3. Na lista de provedores de identidade, exclua o provedor de identidade relacionado ao recurso Aplicativos Web estáticos.

  4. Selecione Remover autenticação para remover a autenticação e permitir tráfego anônimo para seu recurso do Serviço de Aplicativo.

Seu recurso do Serviço de Aplicativo agora pode receber tráfego anônimo.

Próximas etapas

Visão geral da API