مشاركة عبر

دعم واجهة برمجة التطبيقات في Azure Static Web Apps مع Azure App Service

  • مقالة

Azure App Service هي نظام أساسي مدار لاستضافة تطبيقات الويب التي تنفذ التعليمات البرمجية على الخوادم. تدعم Azure App Service العديد من أوقات التشغيل وأطر العمل بما في ذلك Node.js و ASP.NET Core و PHP و Java و Python.

عند ربط تطبيق ويب Azure App Service بتطبيق الويب الثابت، يتم توصيل أي طلبات لتطبيق الويب الثابت الخاص بك بمسار يبدأ بنفس /api المسار على تطبيق Azure App Service.

بشكل افتراضي، عندما يتم ربط تطبيق App Service بتطبيق ويب ثابت، لا يقبل تطبيق App Service سوى الطلبات التي يتم نقلها من خلال تطبيق الويب الثابت المرتبط. يمكن ربط تطبيق Azure App Service بتطبيق ويب ثابت واحد فقط في كل مرة.

تتوفر جميع خطط استضافة Azure App Service للاستخدام مع Azure Static Web Apps.

تتضمن خيارات واجهة برمجة التطبيقات لتطبيقات الويب الثابتة خدمات Azure التالية:

راجع نظرة عامة على واجهات برمجة التطبيقات لمزيد من المعلومات.

إشعار

يتطلب التكامل مع Azure App Service خطة Static Web Apps Standard.

تكامل الواجهة الخلفية غير مدعوم في بيئات طلب سحب Static Web Apps.

المتطلبات الأساسية

لربط App Service بتطبيق الويب الثابت، تحتاج إلى مورد App Service موجود وتطبيق ويب ثابت.

مورد ‏‏الوصف
Azure App Service إذا لم يكن لديك واحد بالفعل، فاتبع الخطوات الواردة في دليل إنشاء تطبيق ويب في Azure .
تطبيق ويب ثابت موجود إذا لم يكن لديك واحد بالفعل، فاتبع الخطوات الواردة في دليل البدء لإنشاء تطبيق ويب ثابت No Framework .

مثال

ضع في اعتبارك مثيل Azure App Service الحالي الذي يعرض نقطة نهاية عبر الموقع التالي.

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

بمجرد الربط، يمكنك الوصول إلى نفس نقطة النهاية هذه من خلال api المسار من تطبيق الويب الثابت، كما هو موضح في عنوان URL هذا المثال.

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

يشير كلا عنواني URL إلى نفس نقطة نهاية واجهة برمجة التطبيقات. يجب أن تحتوي نقطة النهاية على App Service على البادئة /api ، نظرا لأن Static Web Apps تطابق الطلبات المقدمة إلى /api المورد المرتبط وتوكله.

لربط تطبيق ويب كواجهة خلفية لواجهة برمجة التطبيقات لتطبيق ويب ثابت، اتبع الخطوات التالية:

  1. في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.

  2. حدد واجهات برمجة التطبيقات من قائمة التنقل.

  3. حدد موقع البيئة التي تريد ربط مثيل APIM بها. حدد ارتباط.

  4. في Backend resource type، حدد Web App.

  5. في Subscription، حدد الاشتراك الذي يحتوي على تطبيق Azure App Service الذي تريد ربطه.

  6. في Resource name، حدد تطبيق Azure App Service.

  7. حدد ارتباط.

عند اكتمال عملية الربط، يتم نقل الطلبات إلى المسارات التي تبدأ بتطبيق /api App Service المرتبط.

إدارة الوصول إلى Azure App Service

يتم تكوين تطبيق App Service الخاص بك مع موفر هوية يسمى Azure Static Web Apps (Linked) يسمح فقط بنسبة استخدام الشبكة التي يتم نقلها من خلال تطبيق الويب الثابت. لجعل تطبيق App Service الخاص بك متاحا للتطبيقات الأخرى، قم بتحديث تكوين المصادقة الخاص به لإضافة موفر هوية آخر أو تغيير إعدادات الأمان للسماح بالوصول غير المصادق عليه.

لإلغاء ربط تطبيق ويب بتطبيق ويب ثابت، اتبع الخطوات التالية:

  1. في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.

  2. حدد واجهات برمجة التطبيقات من قائمة التنقل.

  3. حدد موقع البيئة التي تريد إلغاء ارتباطها وحدد اسم تطبيق الويب.

  4. حدد إلغاء الارتباط.

عند اكتمال عملية إلغاء الارتباط، لم تعد الطلبات إلى المسارات التي تبدأ بها /api موصولة بتطبيق App Service.

إشعار

لمنع تعريض تطبيق App Service عن طريق الخطأ لنسبة استخدام الشبكة المجهولة، لا يتم حذف موفر الهوية الذي تم إنشاؤه بواسطة عملية الربط تلقائيا. يمكنك حذف موفر الهوية المسمى Azure Static Web Apps (Linked) من إعدادات مصادقة تطبيق App Service.

إزالة المصادقة من مورد App Service

لتمكين مورد App Service من تلقي نسبة استخدام الشبكة المجهولة، اتبع الخطوات التالية لإزالة موفر الهوية:

  1. في مدخل Microsoft Azure، انتقل إلى مورد App Service.

  2. حدد Authentication من قائمة التنقل.

  3. من قائمة موفري الهوية، احذف موفر الهوية المرتبط بمورد Static Web Apps.

  4. حدد إزالة المصادقة لإزالة المصادقة والسماح بحركة مرور مجهولة إلى مورد App Service.

أصبح مورد App Service الخاص بك قادرا الآن على تلقي نسبة استخدام الشبكة المجهولة.

الخطوات التالية

نظرة عامة على واجهة برمجة التطبيقات