Azure App Service ile Azure Static Web Apps'te API desteği

Azure App Service , sunucularda kod yürüten web uygulamalarını barındırmaya yönelik yönetilen bir platformdur. Azure App Service Node.js, ASP.NET Core, PHP, Java ve Python gibi birçok çalışma zamanını ve çerçeveyi destekler.

Azure App Service web uygulamanızı statik web uygulamanıza bağladığınızda, ile başlayan /api bir yol ile statik web uygulamanıza yapılan tüm istekler Azure App Service uygulamasında aynı yola bağlanır.

Varsayılan olarak, bir App Service uygulaması statik bir web uygulamasına bağlandığında, App Service uygulaması yalnızca bağlı statik web uygulaması aracılığıyla proksid istekleri kabul eder. Azure App Service uygulaması aynı anda yalnızca tek bir statik web uygulamasına bağlanabilir.

Tüm Azure App Service barındırma planları Azure Static Web Apps ile kullanılabilir.

Statik Web Uygulamaları için API seçenekleri aşağıdaki Azure hizmetlerini içerir:

Daha fazla bilgi için API'lere genel bakış bölümüne bakın.

Uyarı

Azure App Service ile tümleştirme için Statik Web Apps Standart planı gerekir.

Arka uç tümleştirmesi Statik Web Apps çekme isteği ortamlarında desteklenmez.

Önkoşullar

App Service'i statik web uygulamanıza bağlamak için mevcut bir App Service kaynağına ve statik bir web uygulamasına sahip olmanız gerekir.

Kaynak Açıklama
Azure App Service Henüz bir uygulamanız yoksa Azure'da web uygulaması oluşturma kılavuzundaki adımları izleyin.
Mevcut statik web uygulaması Henüz bir uygulamanız yoksa, Başlangıç kılavuzundaki adımları izleyerek No Framework statik web uygulaması oluşturun.

Example

Aşağıdaki konum aracılığıyla bir uç noktayı kullanıma sunan mevcut bir Azure App Service örneğini düşünün.

https://my-web-app.azurewebsites.net/api/getProducts

Bağlandıktan sonra, bu örnek URL'de gösterildiği gibi statik web uygulamanızın yolu üzerinden api aynı uç noktaya erişebilirsiniz.

https://red-sea-123.azurestaticapps.net/api/getProducts

Her iki URL de aynı API uç noktasına işaret eder. App Service'teki uç nokta, Statik Web Uygulamaları yapılan isteklerle /api eşleştiğinden ve bağlı kaynağın yolunun tamamını /api ara sunucu üzerinden yönlendirdiğinden, ön ekine sahip olmalıdır.

Bir web uygulamasını statik bir web uygulamasının API arka ucu olarak bağlamak için şu adımları izleyin:

  1. Azure portalında statik web uygulamasına gidin.

  2. Gezinti menüsünden API'ler'i seçin.

  3. API Management örneğini bağlamak istediğiniz ortamı bulun. Bağlantı'yı seçin.

  4. Arka uç kaynak türü'ndeWeb Uygulaması'yı seçin.

  5. Abonelik'te, bağlamak istediğiniz Azure App Service uygulamasını içeren aboneliği seçin.

  6. Kaynak adı bölümünde Azure App Service uygulamasını seçin.

  7. Bağlantı'yı seçin.

Bağlama işlemi tamamlandığında, ile /api başlayan yollara yönelik istekler bağlı App Service uygulamasına bağlanır.

Azure App Service'e erişimi yönetme

App Service uygulamanız, yalnızca statik web uygulamasından geçen trafiğe izin veren adlı Azure Static Web Apps (Linked) bir kimlik sağlayıcısıyla yapılandırılır. App Service uygulamanızı diğer uygulamalar için erişilebilir hale getirmek için, kimlik doğrulama yapılandırmasını güncelleştirerek başka bir kimlik sağlayıcısı ekleyin veya güvenlik ayarlarını kimliği doğrulanmamış erişime izin verecek şekilde değiştirin.

Bir web uygulamasının statik web uygulamasından bağlantısını kaldırmak için şu adımları izleyin:

  1. Azure portalında statik web uygulamasına gidin.

  2. Gezinti menüsünden API'ler'i seçin.

  3. Bağlantısını açmak istediğiniz ortamı bulun ve web uygulaması adını seçin.

  4. Bağlantıyı Kaldır'ı seçin.

Bağlantıyı kaldırma işlemi tamamlandığında, /api ile başlayan yollara yönelik istekler artık App Service uygulamanıza yönlendirilmez.

Uyarı

App Service uygulamanızın yanlışlıkla anonim trafiğe açıklanmasını önlemek için, bağlama işlemi tarafından oluşturulan kimlik sağlayıcısı otomatik olarak silinmez. Azure Static Web Apps (Bağlı) adlı kimlik sağlayıcısını App Service uygulamasının kimlik doğrulama ayarlarından silebilirsiniz.

App Service kaynağından kimlik doğrulamasını kaldırma

App Service kaynağınızın anonim trafik almasını sağlamak için kimlik sağlayıcısını kaldırmak için şu adımları izleyin:

  1. Azure portalında App Service kaynağına gidin.

  2. Gezinti menüsünden Kimlik Doğrulaması'nı seçin.

  3. Kimlik sağlayıcıları listesinden Statik Web Apps kaynağıyla ilgili kimlik sağlayıcısını silin.

  4. Kimlik doğrulamasını kaldırmak ve App Service kaynağınıza anonim trafiğe izin vermek için Kimlik doğrulamasını kaldır'ı seçin.

App Service kaynağınız artık anonim trafik alabilir.

Sonraki Adımlar