Azure Static Web Apps'e kendi işlevlerinizi getirin

  • Makale

Azure Static Web Apps, veri ve hizmetler için arka uç API'lerine bağımlı ön uç web uygulamaları oluşturmanıza olanak sağlayan API tümleştirmesi sağlar. İki API tümleştirme seçeneği şunlardır: yönetilen işlevler ve kendi arka uçlarınızı getirin. Bu seçenekler arasındaki farklar hakkında daha fazla bilgi için genel bakışa bakın.

Bu makalede, mevcut bir Azure İşlevleri uygulamasının Azure Static Web Apps kaynağına nasıl bağlanacakları gösterilmektedir.

Dekont

Azure İşlevleri ile tümleştirme için Static Web Apps Standart planı gerekir.

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

Ön koşullar

Bir işlev uygulamasını statik web uygulamanıza bağlamak için mevcut bir Azure İşlevleri kaynağınız ve statik bir web uygulamanız olması gerekir.

Kaynak Tanım
Azure Functions Henüz yoksa, Azure İşlevleri kullanmaya başlama kılavuzundaki adımları izleyin.
Mevcut statik web uygulaması Henüz bir uygulamanız yoksa, Başlangıç kılavuzundaki adımları izleyerek Çerçeve Yok statik web uygulaması oluşturun.

Örnek

Aşağıdaki konum aracılığıyla bir uç noktayı kullanıma sunan mevcut bir Azure İşlevleri uygulamasını göz önünde bulundurun.

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

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

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

Her iki uç nokta URL'si de aynı işlevi gösterir. Statik Web Uygulamaları, bağlı kaynağın yolunun /api tamamını ara sunucuya /api ekleyip isteklerle eşleştiğinden, işlev uygulamasındaki uç nokta ön eke sahip olmalıdır.

Statik Web Apps kaynağınızdan yönetilen işlevleri kaldırma (varsa)

Mevcut bir İşlevler uygulamasını ilişkilendirmeden önce, varsa yönetilen işlevleri kaldırmak için statik web uygulamanızın yapılandırmasını ayarlamanız gerekir.

  1. İş akışı yapılandırma dosyasında değeri boş bir dizeye ("") ayarlayınapi_location.

  1. Statik Web Apps örneğinizi Azure portalında açın.

  2. Ayarlar menüsünde API'ler'i seçin.

  3. Üretim satırında Bağlantı'yı seçerek Yeni Arka uç bağla penceresini açın.

    Aşağıdaki ayarları girin.

    Ayar Değer
    Arka uç kaynak türü İşlev Uygulaması'ı seçin.
    Abonelik Azure aboneliğinizin adını seçin.
    Kaynak adı Azure İşlevleri uygulama adını seçin.
    Arka uç yuvası Azure İşlevi için yuva adını seçin.

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

Azure İşlevleri uygulaması artık statik web uygulamanızın /api rotasına eşlenir.

Önemli

Mevcut bir İşlevler uygulamasını bağlamadan önce, değeri iş akışı yapılandırma dosyasında boş bir dizeye ("") ayarladığınızdan api_location emin olun. Ayrıca, çağrılar dış işlev uygulamasının varsayılan api yol ön ekini koruduğunu varsayar. Birçok uygulama host.json dosyasında bu ön eki kaldırır. Ön ekin yapılandırmada olduğundan emin olun, aksi takdirde çağrı başarısız olur.

Dağıtım

Azure İşlevleri uygulamanız için bir dağıtım iş akışı ayarlamak sizin sorumluluğunuzdadır.

bir işlev 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 işlev uygulaması adını seçin.

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

Bağlantıyı kaldırma işlemi tamamlandığında, ile /api başlayan yollara yönelik istekler artık Azure İşlevleri uygulamanıza yakın olmaz.

Dekont

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

Azure İşlevleri kaynağından kimlik doğrulamasını kaldırma

Azure İşlevleri uygulamanı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 Azure İşlevleri 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 Azure İşlevleri kaynağınıza anonim trafiğe izin vermek için Kimlik doğrulamasını kaldır'ı seçin.

İşlev uygulamanız artık anonim trafik alabilir.

Güvenlik kısıtlamaları

  • Kimlik doğrulaması ve yetkilendirme: Mevcut İşlevler uygulamanızda kimlik doğrulaması ve yetkilendirme ilkeleri önceden ayarlanmamışsa, statik web uygulamasının API'ye özel erişimi vardır. İşlevler uygulamanızı diğer uygulamalar için erişilebilir hale getirmek için 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.

    Dekont

    Bağlı İşlevler uygulamanızda kimlik doğrulamasını ve yetkilendirmeyi etkinleştirirseniz, Azure Uygulaması Hizmet Kimlik Doğrulaması ve yetkilendirme sağlayıcısı sürüm 2'yi kullanmalıdır.

  • Gerekli genel erişilebilirlik: Mevcut bir İşlevler uygulamasının aşağıdaki güvenlik yapılandırmalarını uygulamaması gerekir.

    • İşlevler uygulamasının IP adresini kısıtlama.
    • Özel bağlantı veya hizmet uç noktaları üzerinden trafiği kısıtlama.

  • İşlev erişim anahtarları: İşleviniz bir erişim anahtarı gerektiriyorsa, anahtarı statik uygulamadan API'ye çağrılarla birlikte sağlamanız gerekir.

Kısıtlamalar

  • Tek bir statik web uygulaması için yalnızca bir Azure İşlevleri uygulaması kullanılabilir.
  • api_location İş akışı yapılandırmasındaki değer boş bir dizeye ayarlanmalıdır.
  • Statik Web Apps çekme isteği ortamlarında desteklenmez.
  • Azure İşlevleri uygulamanız çeşitli tetikleyicilere yanıt verebilir ancak statik web uygulaması işlevlere yalnızca Http uç noktaları üzerinden erişebilir.

Sonraki adımlar

API ekleme