Condividi tramite


Supporto api in App Web statiche di Azure con il servizio app di Azure

Servizio app di Azure è una piattaforma gestita per l'hosting di applicazioni Web che eseguono codice nei server. Servizio app di Azure supporta molti runtime e framework, tra cui Node.js, ASP.NET Core, PHP, Java e Python.

Quando si collega l'app Web del servizio app di Azure all'app Web statica, tutte le richieste all'app Web statica con una route che inizia con /api vengono indirizzate alla stessa route nell'app del servizio app di Azure.

Per impostazione predefinita, quando un'app del servizio app è collegata a un'app Web statica, l'app del servizio app accetta solo le richieste inviate tramite proxy tramite l'app Web statica collegata. Un'app del servizio app di Azure può essere collegata a una singola app Web statica alla volta.

Tutti i piani di hosting del servizio app di Azure sono disponibili per l'uso con App Web statiche di Azure.

Le opzioni API per App Web statiche includono i servizi di Azure seguenti:

Per altre informazioni, vedere la panoramica delle API.

Annotazioni

L'integrazione con il servizio app di Azure richiede il piano Standard di App Web statiche.

L'integrazione backend non è supportata negli ambienti di richiesta pull delle App Web statiche.

Prerequisiti

Per collegare un servizio app all'app Web statica, è necessario disporre di una risorsa del servizio app esistente e di un'app Web statica.

risorsa Descrizione
Servizio app di Azure Se non è già disponibile, seguire la procedura descritta nella guida Creare un'app Web in Azure .
App Web statica esistente Se non ne hai già uno, segui la procedura descritta nella guida introduttiva per creare un'app Web No Framework statica.

Esempio

Si consideri un'istanza del servizio app di Azure esistente che espone un endpoint tramite la posizione seguente.

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

Una volta collegato, è possibile accedere allo stesso endpoint tramite il api percorso dell'app Web statica, come illustrato in questo URL di esempio.

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

Entrambi gli URL puntano allo stesso endpoint API. L'endpoint sul servizio App deve avere il prefisso /api, poiché le richieste effettuate a /api vengono corrisposte dalle app Web statiche e l'intero percorso viene proxy alla risorsa collegata.

Per collegare un'app Web come back-end api per un'app Web statica, seguire questa procedura:

  1. Nel portale di Azure, vai all'app Web statica.

  2. Selezionare API dal menu di spostamento.

  3. Individuare l'ambiente a cui si vuole collegare l'istanza di Gestione API. Seleziona Collegamento.

  4. In Tipo di risorsa back-end selezionare App Web.

  5. In Sottoscrizione selezionare la sottoscrizione contenente l'app del servizio app di Azure da collegare.

  6. In Nome risorsa, selezionare l'app di Azure App Service.

  7. Seleziona Collegamento.

Al termine del processo di collegamento, le richieste alle route che iniziano con /api vengono inviate tramite proxy all'app del Servizio App collegata.

Gestire l'accesso al servizio app di Azure

L'app di App Service è configurata con un provider di identità denominato Azure Static Web Apps (Linked) che consente solo il traffico instradato tramite l'app Web statica. Per rendere l'app del servizio app accessibile ad altre applicazioni, aggiornare la configurazione di autenticazione per aggiungere un altro provider di identità o modificare le impostazioni di sicurezza per consentire l'accesso non autenticato.

Per scollegare un'app Web da un'app Web statica, seguire questa procedura:

  1. Nel portale di Azure, vai all'app Web statica.

  2. Selezionare API dal menu di spostamento.

  3. Individuare l'ambiente da scollegare e selezionare il nome dell'app Web.

  4. Selezionare Scollega.

Al termine del processo di scollegamento, le richieste alle route che iniziano con /api non vengono più inviate mediante proxy all'app del servizio App Service.

Annotazioni

Per evitare di esporre accidentalmente l'app del servizio App Service al traffico anonimo, il provider di identità creato dal processo di collegamento non viene eliminato automaticamente. È possibile eliminare il provider di identità denominato Azure Static Web Apps (collegato) dalle impostazioni di autenticazione dell'app del servizio app.

Rimuovere l'autenticazione dalla risorsa del servizio app

Per consentire alla risorsa App Service di ricevere traffico anonimo, segui questi passaggi per rimuovere il provider di identità:

  1. Nel portale di Azure passare alla risorsa del servizio app.

  2. Selezionare Autenticazione dal menu di spostamento.

  3. Nell'elenco dei provider di identità, eliminare il provider di identità correlato alla risorsa App Web statica.

  4. Selezionare Rimuovi autenticazione per rimuovere l'autenticazione e consentire il traffico anonimo verso la risorsa del servizio app.

La risorsa del servizio app è ora in grado di ricevere traffico anonimo.

Passaggi successivi