Sdílet prostřednictvím

Podpora rozhraní API ve službě Azure Static Web Apps se službou Azure App Service

Azure App Service je spravovaná platforma pro hostování webových aplikací, které spouštějí kód na serverech. Azure App Service podporuje mnoho modulů runtime a architektur, včetně Node.js, ASP.NET Core, PHP, Javy a Pythonu.

Když webovou aplikaci Azure App Service propojíte se statickou webovou aplikací, všechny požadavky na vaši statickou webovou aplikaci s trasou začínající na /api jsou proxy na stejnou trasu v aplikaci Azure App Service.

Ve výchozím nastavení, když je aplikace App Service propojena se statickou webovou aplikací, aplikace App Service přijímá jen požadavky, které jsou proxyované přes propojenou statickou webovou aplikaci. Aplikaci Azure App Service je možné propojit jenom s jednou statickou webovou aplikací najednou.

Všechny plány hostování služby Azure App Service 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 Azure App Service vyžaduje plán Static Web Apps Standard.

Integrace back-endu není podporována v prostředích pull requestů statických webových aplikací.

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.

zdroj Description
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 Azure App Service, 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.

Pokud chcete propojit webovou aplikaci jako back-end rozhraní API pro statickou webovou aplikaci, postupujte takto:

  1. Na webu Azure Portal přejděte do statické webové aplikace.

  2. V navigační nabídce vyberte rozhraní API .

  3. Vyhledejte prostředí, na které chcete propojit instanci služby API Management. Vyberte Odkaz.

  4. V backendovém typu prostředku vyberte Web App.

  5. V předplatném vyberte předplatné obsahující aplikaci Azure App Service, kterou chcete propojit.

  6. V názvu prostředku vyberte aplikaci Azure App Service.

  7. Vyberte Odkaz.

Po dokončení procesu propojení se požadavky na trasy začínající /api přepojí do propojené aplikace App Service.

Správa přístupu ke službě Azure App Service

Vaše aplikace App Service je nakonfigurována se zprostředkovatelem identity Azure Static Web Apps (Linked), který povoluje pouze provoz procházející prostřednictvím statické webové aplikace. 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.

Pokud chcete zrušit propojení webové aplikace se statickou webovou aplikací, postupujte takto:

  1. Na webu Azure Portal přejděte do statické webové aplikace.

  2. V navigační nabídce vyberte rozhraní API .

  3. Vyhledejte prostředí, které chcete odpojit, a vyberte název webové aplikace.

  4. Vyberte Zrušit propojení.

Po dokončení procesu zrušení propojení se požadavky na trasy začínající na /api již nepřesměrovávají na vaši aplikaci App Service.

Poznámka:

Aby se zabránilo náhodnému zveřejnění vaší 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:

  1. Na webu Azure Portal přejděte k prostředku služby App Service.

  2. V navigační nabídce vyberte Ověřování .

  3. Ze seznamu zprostředkovatelů identity odstraňte zprostředkovatele identity související s prostředkem Static Web Apps.

  4. Zvolte Odebrat ověřování , abyste odebrali ověřování a povolili anonymní provoz do svého prostředku App Service.

Váš prostředek služby App Service teď může přijímat anonymní provoz.

Další kroky

Přehled rozhraní API

  • Last updated on