Supporto api in App Web statiche di Azure con il servizio app Azure
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.
Collegare un'app Web del servizio app Azure
Per collegare un'app Web come back-end api per un'app Web statica, seguire questa procedura:
Nella portale di Azure passare all'app Web statica.
Selezionare API dal menu di spostamento.
Individuare l'ambiente a cui si vuole collegare l'istanza di Gestione API. Seleziona Collegamento.
In Tipo di risorsa back-end selezionare App Web.
In Sottoscrizione selezionare la sottoscrizione contenente l'app del servizio app Azure da collegare.
In Nome risorsa selezionare l'app del servizio app Azure.
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.
Scollegare un'app del servizio app Azure
Scollegare servizio app da App Web statiche
Per scollegare un'app Web da un'app Web statica, seguire questa procedura:
Nella portale di Azure passare all'app Web statica.
Selezionare API dal menu di spostamento.
Individuare l'ambiente da scollegare e selezionare il nome dell'app Web.
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à:
Nella portale di Azure passare alla risorsa servizio app.
Selezionare Autenticazione dal menu di spostamento.
Nell'elenco dei provider di identità eliminare il provider di identità correlato alla risorsa App Web statiche.
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.