Podpora rozhraní API ve službě Azure Static Web Apps se službou Aplikace Azure
Aplikace Azure Service je spravovaná platforma pro hostování webových aplikací, které spouštějí kód na serverech. Aplikace Azure Service podporuje mnoho modulů runtime a architektur, včetně Node.js, ASP.NET Core, PHP, Java a Pythonu.
Když webovou aplikaci Aplikace Azure Service propojíte se statickou webovou aplikací, všechny požadavky na statickou webovou aplikaci se trasou začínající /api
na stejnou trasu v aplikaci Aplikace Azure Service.
Když je aplikace app Service ve výchozím nastavení propojená se statickou webovou aplikací, aplikace App Service přijímá jenom požadavky, které jsou přes propojenou statickou webovou aplikaci přesxidované. Aplikace Aplikace Azure Service může být současně propojená pouze s jednou statickou webovou aplikací.
Všechny plány hostování služeb Aplikace Azure jsou k dispozici pro použití se službou Azure Static Web Apps.
Mezi možnosti rozhraní API pro Static Web Apps patří následující služby Azure:
Další informace najdete v přehledu rozhraní API.
Poznámka:
Integrace se službou Aplikace Azure Vyžaduje plán Static Web Apps Standard.
Integrace back-endu není podporována v prostředích statických žádostí o přijetí změn Web Apps.
Předpoklady
Pokud chcete propojit službu App Service se statickou webovou aplikací, musíte mít existující prostředek služby App Service a statickou webovou aplikaci.
Prostředek | Popis |
---|---|
Azure App Service | Pokud ho ještě nemáte, postupujte podle pokynů v průvodci vytvořením webové aplikace v Azure . |
Existující statická webová aplikace | Pokud ho ještě nemáte, vytvořte statickou webovou aplikaci No Framework podle pokynů v úvodní příručce. |
Příklad
Zvažte existující instanci služby Aplikace Azure, která zveřejňuje koncový bod prostřednictvím následujícího umístění.
https://my-web-app.azurewebsites.net/api/getProducts
Po propojení můžete ke stejnému api
koncovému bodu přistupovat přes cestu z vaší statické webové aplikace, jak je znázorněno v této ukázkové adrese URL.
https://red-sea-123.azurestaticapps.net/api/getProducts
Obě adresy URL odkazují na stejný koncový bod rozhraní API. Koncový bod ve službě App Service musí mít předponu /api
, protože Static Web Apps odpovídá žádostem provedeným na /api
proxy serverech a poskytuje celou cestu k propojenému prostředku.
Propojení webové aplikace služby Aplikace Azure
Pokud chcete propojit webovou aplikaci jako back-end rozhraní API pro statickou webovou aplikaci, postupujte takto:
Na webu Azure Portal přejděte do statické webové aplikace.
V navigační nabídce vyberte rozhraní API .
Vyhledejte prostředí, na které chcete propojit instanci služby API Management. Vyberte odkaz.
V back-endovém typu prostředku vyberte webovou aplikaci.
V části Předplatné vyberte předplatné obsahující aplikaci Aplikace Azure Service, kterou chcete propojit.
V názvu prostředku vyberte aplikaci Aplikace Azure Service.
Vyberte odkaz.
Po dokončení procesu propojení se požadavky na trasy začínající /api
na trasu přepojí do propojené aplikace App Service.
Správa přístupu ke službě Aplikace Azure Service
Vaše aplikace App Service je nakonfigurovaná s názvem Azure Static Web Apps (Linked)
zprostředkovatele identity, který umožňuje pouze provoz, který se přesměruje přes statickou webovou aplikaci. Pokud chcete aplikaci App Service zpřístupnit pro jiné aplikace, aktualizujte její konfiguraci ověřování a přidejte dalšího zprostředkovatele identity nebo změňte nastavení zabezpečení tak, aby povolovala neověřený přístup.
Zrušení propojení aplikace Aplikace Azure Service
Zrušení propojení služby App Service se statickými webovými aplikacemi
Pokud chcete zrušit propojení webové aplikace se statickou webovou aplikací, postupujte takto:
Na webu Azure Portal přejděte do statické webové aplikace.
V navigační nabídce vyberte rozhraní API .
Vyhledejte prostředí, které chcete odpojit, a vyberte název webové aplikace.
Vyberte Zrušit propojení.
Po dokončení procesu zrušení propojení se požadavky na trasy začínající na /api
vaši aplikaci App Service už nepřesouvají.
Poznámka:
Aby se zabránilo náhodnému zveřejnění aplikace App Service anonymnímu provozu, zprostředkovatel identity vytvořený procesem propojení se automaticky neodstraní. Z nastavení ověřování aplikace App Service můžete odstranit zprostředkovatele identity s názvem Azure Static Web Apps (propojené ).
Odebrání ověřování z prostředku služby App Service
Pokud chcete prostředku služby App Service povolit příjem anonymního provozu, odeberte zprostředkovatele identity následujícím postupem:
Na webu Azure Portal přejděte k prostředku služby App Service.
V navigační nabídce vyberte Ověřování .
Ze seznamu zprostředkovatelů identity odstraňte zprostředkovatele identity související s prostředkem Static Web Apps.
Výběrem možnosti Odebrat ověřování odeberete ověřování a povolíte anonymní provoz do vašeho prostředku služby App Service.
Váš prostředek služby App Service teď může přijímat anonymní provoz.