API-támogatás az Azure Static Web Appsben az Azure Container Apps használatával
Az Azure Container Apps egy felügyelt platform kiszolgáló nélküli tárolók és mikroszolgáltatások üzemeltetéséhez.
Amikor a tárolóalkalmazást a statikus webalkalmazáshoz csatolja, a statikus webalkalmazáshoz érkező kérések egy útvonallal /api kezdődnek, a rendszer ugyanarra az útvonalra van kiképezve a tárolóalkalmazáson.
Alapértelmezés szerint, ha egy tárolóalkalmazás statikus webalkalmazáshoz van csatolva, a tárolóalkalmazás csak a csatolt statikus webalkalmazáson keresztüli kérelmeket fogadja el. A tárolóalkalmazások egyszerre egyetlen statikus webalkalmazáshoz csatolhatók.
A Static Web Apps API-beállításai a következő Azure-szolgáltatásokat tartalmazzák:
További információkért tekintse meg az API-k áttekintését .
Megjegyzés:
Az Azure Container Apps integrációjához a Static Web Apps Standard csomag szükséges.
A háttérintegráció nem támogatott a Static Web Apps lekéréses kérelmek környezetében.
Előfeltételek
A tárolóalkalmazás statikus webalkalmazáshoz való csatolásához rendelkeznie kell egy meglévő Container Apps-erőforrással és egy statikus webalkalmazással.
| Resource | Leírás |
|---|---|
| Azure Container Apps | Ha még nincs ilyenje, kövesse az első tárolóalkalmazás üzembe helyezésére vonatkozó útmutató lépéseit. |
| Meglévő statikus webalkalmazás | Ha még nem rendelkezik ilyen webalkalmazással, kövesse az első lépések útmutatójának lépéseit a No Framework statikus webalkalmazás létrehozásához. |
Example
Fontolja meg egy meglévő Azure Container App-példányt, amely az alábbi helyen teszi elérhetővé a végpontot.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts
A csatolás után ugyanazt a végpontot a api statikus webalkalmazás elérési útján érheti el, ahogyan az ebben a példában látható URL-címen látható.
https://red-sea-123.azurestaticapps.net/api/getProducts
Mindkét URL ugyanarra az API-végpontra mutat. A tárolóalkalmazás végpontjának rendelkeznie kell az /api előtaggal, mivel a Static Web Apps egyezik a csatolt erőforrás teljes elérési útjának kérésével /api és proxyzva.
Tárolóalkalmazás csatolása
Ha statikus webalkalmazás API-háttérrendszereként szeretne összekapcsolni egy tárolóalkalmazást, kövesse az alábbi lépéseket:
Az Azure Portalon nyissa meg a statikus webalkalmazást.
Válassza ki az API-kat a navigációs menüből.
Keresse meg azt a környezetet, amelyhez az API Management-példányt hozzá szeretné kapcsolni. Válassza a Hivatkozás lehetőséget.
A háttérbeli erőforrástípusban válassza a Tárolóalkalmazás lehetőséget.
Az Előfizetésben válassza ki a csatolni kívánt tárolóalkalmazást tartalmazó előfizetést.
Az Erőforrás nevében válassza ki a tárolóalkalmazást.
Válassza a Hivatkozás lehetőséget.
Ha a csatolási folyamat befejeződött, a rendszer a csatolt tárolóalkalmazáshoz kapcsolódó /api útvonalakra irányuló kérelmeket kezdeményezi.
A tárolóalkalmazáshoz való hozzáférés kezelése
A tárolóalkalmazás egy identitásszolgáltatóval Azure Static Web Apps (Linked) van konfigurálva, amely csak a statikus webalkalmazáson keresztüli forgalmat engedélyezi. Ha elérhetővé szeretné tenni a tárolóalkalmazást más alkalmazások számára, frissítse annak hitelesítési konfigurációját egy másik identitásszolgáltató hozzáadásához, vagy módosítsa a biztonsági beállításokat a hitelesítés nélküli hozzáférés engedélyezéséhez.
Tárolóalkalmazás leválasztása
A tárolóalkalmazás statikus webalkalmazásból való leválasztásához kövesse az alábbi lépéseket:
Az Azure Portalon nyissa meg a statikus webalkalmazást.
Válassza ki az API-kat a navigációs menüből.
Keresse meg a leválasztani kívánt környezetet, és válassza ki a tárolóalkalmazás nevét.
Válassza a Kapcsolat megszüntetése lehetőséget.
Ha a leválasztási folyamat befejeződött, a rendszer a következővel kezdődő /api útvonalakra irányuló kérelmeket már nem irányítja át a tárolóalkalmazásba.
Megjegyzés:
Ha meg szeretné akadályozni, hogy a tárolóalkalmazás véletlenül névtelen adatforgalomba kerüljön, a csatolási folyamat által létrehozott identitásszolgáltató nem törlődik automatikusan. A tárolóalkalmazás hitelesítési beállításai közül törölheti az Azure Static Web Apps (Csatolt) nevű identitásszolgáltatót.
Hitelesítés eltávolítása a Container Apps-erőforrásból
Ha engedélyezni szeretné, hogy a Container Apps-erőforrás névtelen forgalmat fogadjon, kövesse az alábbi lépéseket az identitásszolgáltató eltávolításához:
Az Azure Portalon keresse meg a Container Apps erőforrást.
Válassza a Hitelesítés lehetőséget a navigációs menüben.
Az identitásszolgáltatók listájából törölje a Static Web Apps-erőforráshoz kapcsolódó identitásszolgáltatót.
Válassza a Hitelesítés eltávolítása lehetőséget a hitelesítés eltávolításához és a Container Apps-erőforrás névtelen forgalmának engedélyezéséhez.
A Container Apps-erőforrás mostantól képes névtelen forgalmat fogadni.