Obsługa interfejsu API w usłudze Azure Static Web Apps za pomocą usługi aplikacja systemu Azure Service
aplikacja systemu Azure Service to zarządzana platforma do hostowania aplikacji internetowych, które wykonują kod na serwerach. usługa aplikacja systemu Azure obsługuje wiele środowisk uruchomieniowych i struktur, w tym Node.js, ASP.NET Core, PHP, Java i Python.
Po połączeniu aplikacji internetowej usługi aplikacja systemu Azure Service ze statyczną aplikacją internetową wszystkie żądania do statycznej aplikacji internetowej z trasą rozpoczynającą się od /api są kierowane do tej samej trasy w aplikacji usługi aplikacja systemu Azure Service.
Domyślnie gdy aplikacja usługi App Service jest połączona ze statyczną aplikacją internetową, aplikacja usługi App Service akceptuje tylko żądania, które są kierowane za pośrednictwem połączonej statycznej aplikacji internetowej. Aplikacja usługi aplikacja systemu Azure Service może być połączona tylko z pojedynczą statyczną aplikacją internetową jednocześnie.
Wszystkie plany hostingu usługi aplikacja systemu Azure są dostępne do użycia z usługą Azure Static Web Apps.
Opcje interfejsu API dla usługi Static Web Apps obejmują następujące usługi platformy Azure:
Aby uzyskać więcej informacji, zobacz omówienie interfejsów API.
Uwaga
Integracja z usługą aplikacja systemu Azure Wymaga planu Static Web Apps Standard.
Integracja zaplecza nie jest obsługiwana w środowiskach żądań ściągnięcia usługi Static Web Apps.
Wymagania wstępne
Aby połączyć usługę App Service ze statyczną aplikacją internetową, musisz mieć istniejący zasób usługi App Service i statyczną aplikację internetową.
| Zasób | opis |
|---|---|
| Azure App Service | Jeśli jeszcze go nie masz, wykonaj kroki opisane w przewodniku Tworzenie aplikacji internetowej na platformie Azure . |
| Istniejąca statyczna aplikacja internetowa | Jeśli jeszcze go nie masz, wykonaj kroki opisane w przewodniku wprowadzającym , aby utworzyć statyczną aplikację internetową No Framework . |
Przykład
Rozważ istniejące wystąpienie usługi aplikacja systemu Azure, które uwidacznia punkt końcowy za pośrednictwem następującej lokalizacji.
https://my-web-app.azurewebsites.net/api/getProducts
Po połączeniu możesz uzyskać dostęp do tego samego punktu końcowego za pośrednictwem api ścieżki ze statycznej aplikacji internetowej, jak pokazano w tym przykładowym adresie URL.
https://red-sea-123.azurestaticapps.net/api/getProducts
Oba adresy URL wskazują ten sam punkt końcowy interfejsu API. Punkt końcowy w usłudze App Service musi mieć /api prefiks, ponieważ usługa Static Web Apps pasuje do żądań wysyłanych do /api i proxy całej ścieżki do połączonego zasobu.
Łączenie aplikacji internetowej usługi aplikacja systemu Azure Service
Aby połączyć aplikację internetową jako zaplecze interfejsu API dla statycznej aplikacji internetowej, wykonaj następujące kroki:
W witrynie Azure Portal przejdź do statycznej aplikacji internetowej.
Wybierz pozycję Interfejsy API z menu nawigacji.
Znajdź środowisko, z którym chcesz połączyć wystąpienie usługi API Management. Wybierz Łącze.
W polu Typ zasobu zaplecza wybierz pozycję Aplikacja internetowa.
W obszarze Subskrypcja wybierz subskrypcję zawierającą aplikację usługi aplikacja systemu Azure, którą chcesz połączyć.
W polu Nazwa zasobu wybierz aplikację usługi aplikacja systemu Azure Service.
Wybierz Łącze.
Po zakończeniu procesu łączenia żądania do tras rozpoczynających się od /api są kierowane do połączonej aplikacji usługi App Service.
Zarządzanie dostępem do usługi aplikacja systemu Azure
Aplikacja usługi App Service jest skonfigurowana przy użyciu dostawcy tożsamości o nazwie Azure Static Web Apps (Linked) , który zezwala na ruch kierowany przez statyczną aplikację internetową. Aby aplikacja usługi App Service była dostępna dla innych aplikacji, zaktualizuj konfigurację uwierzytelniania, aby dodać innego dostawcę tożsamości lub zmienić ustawienia zabezpieczeń, aby zezwolić na nieuwierzytelniony dostęp.
Odłączanie aplikacji usługi aplikacja systemu Azure Service
Odłącz usługę App Service od usługi Static Web Apps
Aby odłączyć aplikację internetową ze statycznej aplikacji internetowej, wykonaj następujące kroki:
W witrynie Azure Portal przejdź do statycznej aplikacji internetowej.
Wybierz pozycję Interfejsy API z menu nawigacji.
Znajdź środowisko, które chcesz odłączyć, i wybierz nazwę aplikacji internetowej.
Wybierz pozycję Odłącz.
Po zakończeniu procesu odłączania żądania do tras rozpoczynających się od /api nie są już kierowane do aplikacji usługi App Service.
Uwaga
Aby zapobiec przypadkowemu ujawnieniu aplikacji usługi App Service do ruchu anonimowego, dostawca tożsamości utworzony przez proces łączenia nie zostanie automatycznie usunięty. Możesz usunąć dostawcę tożsamości o nazwie Azure Static Web Apps (połączone) z ustawień uwierzytelniania aplikacji usługi App Service.
Usuwanie uwierzytelniania z zasobu usługi App Service
Aby umożliwić zasobowi usługi App Service odbieranie ruchu anonimowego, wykonaj następujące kroki, aby usunąć dostawcę tożsamości:
W witrynie Azure Portal przejdź do zasobu usługi App Service.
Wybierz pozycję Uwierzytelnianie z menu nawigacji.
Z listy dostawców tożsamości usuń dostawcę tożsamości powiązanego z zasobem Static Web Apps.
Wybierz pozycję Usuń uwierzytelnianie, aby usunąć uwierzytelnianie i zezwolić na ruch anonimowy do zasobu usługi App Service.
Zasób usługi App Service może teraz odbierać ruch anonimowy.