API-támogatás az Azure Static Web Appsben Azure-alkalmazás Szolgáltatással
A Azure-alkalmazás szolgáltatás egy felügyelt platform a kiszolgálókon kódot végrehajtó webalkalmazások üzemeltetéséhez. Azure-alkalmazás szolgáltatás számos futtatókörnyezetet és keretrendszert támogat, beleértve a Node.js-t, a ASP.NET Core-t, a PHP-t, a Java-t és a Pythont.
Amikor a Azure-alkalmazás Service-webalkalmazást a statikus webalkalmazáshoz csatolja, a statikus webalkalmazáshoz érkező kérések egy olyan útvonallal /api
kezdődnek, amely a Azure-alkalmazás Service-alkalmazás ugyanazon útvonalára van kiképezve.
Alapértelmezés szerint, ha egy App Service-alkalmazás statikus webalkalmazáshoz van csatolva, az App Service-alkalmazás csak a csatolt statikus webalkalmazáson keresztüli kérelmeket fogadja el. A Azure-alkalmazás Service-alkalmazások egyszerre csak egyetlen statikus webalkalmazáshoz csatolhatók.
Minden Azure-alkalmazás szolgáltatás üzemeltetési csomagja elérhető az Azure Static Web Appshez.
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:
A Azure-alkalmazás szolgáltatással való integráció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
Az App Service statikus webalkalmazáshoz való csatolásához rendelkeznie kell egy meglévő App Service-erőforrással és egy statikus webalkalmazással.
Resource | Leírás |
---|---|
Azure App Service | Ha még nincs ilyenje, kövesse a webalkalmazás létrehozása az Azure-ban című ú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-alkalmazás szolgáltatáspéldányt, amely az alábbi helyen teszi elérhetővé a végpontot.
https://my-web-app.azurewebsites.net/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. Az App Service-végpontnak rendelkeznie kell az /api
előtaggal, mivel a Static Web Apps megfelel a hivatkozott erőforrás teljes elérési útjának, és a statikus webalkalmazások egyeznek a kérésekkel /api
, és ki vannak állítva.
Azure-alkalmazás Service Web App csatolása
Ha egy webalkalmazást statikus webalkalmazás API-háttérrendszereként szeretne összekapcsolni, 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 Web App lehetőséget.
Az Előfizetésben válassza ki a csatolni kívánt Azure-alkalmazás Service-alkalmazást tartalmazó előfizetést.
Az Erőforrásnév mezőben válassza ki a Azure-alkalmazás Service alkalmazást.
Válassza a Hivatkozás lehetőséget.
Ha a csatolási folyamat befejeződött, a rendszer a hivatkozott App Service-alkalmazáshoz kapcsolódó /api
útvonalakra irányuló kérelmeket kezdeményezi.
A Azure-alkalmazás Szolgáltatáshoz való hozzáférés kezelése
Az App Service-alkalmazás olyan 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 az App Service-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.
Azure-alkalmazás Service-alkalmazás leválasztva
Az App Service leválasztva a Statikus Web Apps szolgáltatásról
Ha egy webalkalmazást statikus webalkalmazásból szeretne leválasztani, 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 webalkalmazá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 az App Service-alkalmazásba.
Megjegyzés:
Ha meg szeretné akadályozni, hogy az App Service-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. Az Azure Static Web Apps (Csatolt) nevű identitásszolgáltatót törölheti az App Service-alkalmazás hitelesítési beállításai közül.
Hitelesítés eltávolítása az App Service-erőforrásból
Ha engedélyezni szeretné, hogy az App Service-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 az App Service-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 az App Service-erőforrás névtelen forgalmának engedélyezéséhez.
Az App Service-erőforrás mostantól képes névtelen forgalmat fogadni.