Condividi tramite

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

  • Articolo

app Azure Service è una piattaforma gestita per l'hosting di applicazioni Web che eseguono codice nei server. app Azure Service 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 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 Azure.

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

Tutti i piani di hosting del servizio di app 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.

Nota

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

L'integrazione back-end non è supportata in App Web statiche ambienti di richiesta pull.

Prerequisiti

Per collegare un servizio app all'app Web statica, è necessario avere una risorsa servizio app esistente e 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 è già disponibile, seguire la procedura descritta nella guida introduttiva per creare un'app Web statica No Framework .

Esempio

Si consideri un'istanza del servizio app Azure esistente che espone un endpoint tramite il percorso 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 nel servizio app deve avere il /api prefisso , poiché App Web statiche corrisponde alle richieste effettuate a /api e proxy l'intero percorso della risorsa collegata.

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

  1. Nella portale di Azure passare 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 Azure da collegare.

  6. In Nome risorsa selezionare l'app del servizio app Azure.

  7. Seleziona Collegamento.

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

Gestire l'accesso al servizio app Azure

L'app servizio app è configurata con un provider di identità denominato Azure Static Web Apps (Linked) che consente solo il traffico proxied tramite l'app Web statica. Per rendere l'app 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. Nella portale di Azure passare 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 tramite proxy all'app servizio app.

Nota

Per impedire l'esposizione accidentale dell'app servizio app al traffico anonimo, il provider di identità creato dal processo di collegamento non viene eliminato automaticamente. È possibile eliminare il provider di identità denominato App Web statiche di Azure (collegato) dalle impostazioni di autenticazione dell'app servizio app.

Rimuovere l'autenticazione dalla risorsa servizio app

Per abilitare la risorsa servizio app per ricevere traffico anonimo, seguire questa procedura per rimuovere il provider di identità:

  1. Nella portale di Azure passare alla risorsa 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 statiche.

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

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

Passaggi successivi

Panoramica delle API