Supporto delle API in App Web statiche di Azure con App Azure Container
App Azure Container è una piattaforma gestita per l'hosting di contenitori serverless e microservizi.
Quando si collega l'app contenitore 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 contenitore.
Per impostazione predefinita, quando un'app contenitore è collegata a un'app Web statica, l'app contenitore accetta solo le richieste proxy tramite l'app Web statica collegata. Un'app contenitore può essere collegata a una singola app Web statica alla volta.
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 Container 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'app contenitore all'app Web statica, è necessario avere una risorsa App contenitore esistente e un'app Web statica.
| Risorsa | Descrizione |
|---|---|
| App contenitore di Azure | Se non è già disponibile, seguire la procedura descritta nella guida Distribuire la prima app contenitore. |
| 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 esistente dell'app Contenitore di Azure che espone un endpoint tramite il percorso seguente.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/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 nell'app contenitore deve avere il /api prefisso, poiché App Web statiche corrisponde alle richieste effettuate e /api esegue il proxy dell'intero percorso della risorsa collegata.
Collegare un'app contenitore
Per collegare un'app contenitore 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 contenitore.
In Sottoscrizione selezionare la sottoscrizione contenente l'app contenitore da collegare.
In Nome risorsa selezionare l'app contenitore.
Seleziona Collegamento.
Al termine del processo di collegamento, le richieste alle route che iniziano con /api vengono inviate tramite proxy all'app contenitore collegato.
Gestire l'accesso all'app contenitore
L'app contenitore è 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 contenitore 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 contenitore
Per scollegare un'app contenitore 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 contenitore.
Selezionare Scollega.
Al termine del processo di scollegamento, le richieste alle route che iniziano con /api non vengono più inviate tramite proxy all'app contenitore.
Nota
Per evitare l'esposizione accidentale dell'app contenitore 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 contenitore.
Rimuovere l'autenticazione dalla risorsa App contenitore
Per abilitare la risorsa App contenitore per ricevere traffico anonimo, seguire questa procedura per rimuovere il provider di identità:
Nella portale di Azure passare alla risorsa App contenitore.
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 App contenitore.
La risorsa App contenitore è ora in grado di ricevere traffico anonimo.