إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
إدارة API في Azure هي خدمة تتيح لك إنشاء بوابة واجهة برمجة تطبيقات حديثة لخدمات الواجهة الخلفية الحالية.
عندما تربط خدمة إدارة واجهة برمجة تطبيقات Azure بتطبيق الويب الثابت، فإن أي طلبات إلى تطبيق الويب الثابت الذي يبدأ ب /api يتم تحويلها إلى نفس المسار في خدمة إدارة واجهة برمجة تطبيقات Azure.
يمكن ربط خدمة إدارة API في Azure بعدة تطبيقات ويب ثابتة في نفس الوقت. يتم إنشاء منتج إدارة واجهة برمجة التطبيقات لكل تطبيق ويب ثابت مرتبط. أي واجهات برمجة تطبيقات مضافة إلى المنتج متاحة لتطبيق الويب الثابت المرتبط.
جميع مستويات تسعير إدارة واجهة برمجة تطبيقات Azure متاحة للاستخدام مع تطبيقات الويب الثابتة في Azure.
تتضمن خيارات واجهة برمجة التطبيقات لتطبيقات الويب الثابتة خدمات Azure التالية:
- دالات Azure
- إدارة واجهة برمجة تطبيقات Azure
- خدمة تطبيقات Azure
- Azure Container Apps
راجع نظرة عامة على واجهات برمجة التطبيقات لمزيد من المعلومات.
ملاحظة
يتطلب التكامل مع Azure API Management خطة Static Web Apps Standard.
تكامل الواجهة الخلفية غير مدعوم في بيئات طلب سحب Static Web Apps.
المتطلبات المسبقه
لربط مثيل إدارة API بتطبيق الويب الثابت الخاص بك، تحتاج إلى وجود مورد إدارة API موجود في Azure وتطبيق ويب ثابت.
| مورد | وصف |
|---|---|
| إدارة واجهة برمجة تطبيقات Azure | إذا لم يكن لديك واحد بالفعل، اتبع الخطوات في دليل إنشاء نسخة جديدة لخدمة إدارة API في Azure . |
| تطبيق ويب ثابت موجود | إذا لم يكن لديك واحد بالفعل، فاتبع الخطوات الواردة في دليل البدء لإنشاء تطبيق ويب ثابت No Framework . |
مثال
فكر في مثيل إدارة API موجود في Azure يعرض نقطة نهاية عبر الموقع التالي.
https://my-api-management-instance.azure-api.net/api/getProducts
بمجرد الربط، يمكنك الوصول إلى نفس نقطة النهاية هذه من خلال api المسار من تطبيق الويب الثابت، كما هو موضح في عنوان URL هذا المثال.
https://red-sea-123.azurestaticapps.net/api/getProducts
يشير كلا عنواني URL إلى نفس نقطة نهاية واجهة برمجة التطبيقات. يجب أن تحتوي نقطة النهاية في مثيل إدارة واجهة برمجة التطبيقات على بادئة /api (prefix)، لأن تطبيقات الويب الثابتة تطابق الطلبات الموجهة إلى /api المورد المرتبط وتقوم بالبروكسية على المسار بأكمله.
Link an Azure API Management Service
ربط مثيل إدارة API بتطبيقات الويب الثابتة
لربط خدمة إدارة API في Azure كواجهة خلفية لتطبيق ويب ثابت، اتبع الخطوات التالية:
في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.
حدد واجهات برمجة التطبيقات من قائمة التنقل.
حدد البيئة التي تريد ربط خدمة إدارة API بها. حدد ارتباط.
في نوع الموارد الخلفية، اختر إدارة واجهة برمجة التطبيقات (API).
في قسم الاشتراك، اختر الاشتراك الذي يحتوي على خدمة إدارة واجهة برمجة تطبيقات Azure التي تريد ربطها.
في اسم المصدر، اختر خدمة إدارة API في Azure.
حدد ارتباط.
مهم
عند اكتمال عملية الربط، يتم إرسال الطلبات إلى المسارات التي تبدأ ب /api إلى خدمة إدارة واجهة برمجة التطبيقات Azure الخاصة بك. ومع ذلك، لا يتم كشف أي واجهات برمجة تطبيقات بشكل افتراضي. انظر "تكوين واجهات برمجة التطبيقات لاستقبال طلبات تكوين منتج إدارة واجهة برمجة التطبيقات للسماح بواجهات برمجة التطبيقات التي ترغب في استخدامها".
تكوين واجهات برمجة التطبيقات لاستقبال الطلبات
يحتوي Azure API Management على ميزة منتج تحدد كيفية ظهور واجهات برمجة التطبيقات (APIs). كجزء من عملية الربط، يتم تكوين خدمة إدارة واجهة برمجة التطبيقات الخاصة بك بمنتج باسم Azure Static Web Apps - <STATIC_WEB_APP_AUTO_GENERATED_HOSTNAME> (Linked).
لجعل واجهات برمجة التطبيقات متاحة لتطبيق الويب الثابت المرتبط، أضفها إلى المنتج.
داخل مثيل إدارة واجهة برمجة التطبيقات في البوابة، اختر تبويب المنتجات .
اختر المنتج
Azure Static Web Apps - <STATIC_WEB_APP_AUTO_GENERATED_HOSTNAME> (Linked).حدد + Add API.
اختر واجهات برمجة التطبيقات التي تريد عرضها من تطبيقات الويب الثابتة، ثم اختر رابط الاختيار .
تقوم عملية الربط أيضا تلقائيا بتطبيق التكوين التالي على خدمة إدارة واجهة برمجة التطبيقات الخاصة بك:
- المنتج المرتبط بتطبيق الويب الثابت المرتبط تم تكوينه ليتطلب اشتراكا.
- يتم إنشاء اشتراك إدارة واجهة برمجة التطبيقات (
Generated for Static Web Apps resource with default hostname: <STATIC_WEB_APP_AUTO_GENERATED_HOSTNAME>API Management Management) وتحديد النطاق للمنتج الذي يحمل نفس الاسم. - تضاف سياسة التحقق من JWT الواردة إلى المنتج للسماح فقط بالطلبات التي تحتوي على رمز وصول صالح من تطبيق الويب الثابت المرتبط.
- يتم تكوين تطبيق الويب الثابت المرتبط ليشمل المفتاح الأساسي للاشتراك ورمز وصول صالح عند إرسال طلبات الوكالة إلى خدمة إدارة API.
مهم
تغيير سياسة التحقق من صحة JWT أو إعادة توليد المفتاح الأساسي للاشتراك يمنع تطبيق الويب الثابت من إرسال طلبات بروكسي إلى خدمة إدارة واجهات برمجة التطبيقات. لا تعدل أو تحذف الاشتراك أو المنتج المرتبط بتطبيق الويب الثابت الخاص بك أثناء ربطه.
Unlink an Azure API Management service
لفصل خدمة إدارة API في Azure عن تطبيق ويب ثابت، اتبع الخطوات التالية:
في مدخل Microsoft Azure، انتقل إلى تطبيق الويب الثابت.
حدد البيئة التي تريد فصلها واختر اسم خدمة إدارة API.
حدد إلغاء الارتباط.
عند اكتمال عملية فصل الربط، لا تعد الطلبات إلى المسارات التي تبدأ ب /api/ ترسل بروكسي إلى خدمة إدارة واجهة برمجة التطبيقات الخاصة بك.
ملاحظة
منتج إدارة واجهة برمجة التطبيقات والاشتراك المرتبط بتطبيق الويب الثابت المرتبط لا يتم حذفهما تلقائيا. يمكنك حذفها من خدمة إدارة واجهة برمجة التطبيقات.
استكشاف الأخطاء وإصلاحها
إذا لم تكن واجهات برمجة التطبيقات مرتبطة بمنتج إدارة واجهة برمجة التطبيقات الذي تم إنشاؤه لمورد تطبيقات الويب الثابتة، فإن الوصول إلى مسار /api في تطبيق الويب الثابت يعطي الخطأ التالي من إدارة واجهات برمجة التطبيقات.
{
"statusCode": 401,
"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
لحل هذا الخطأ، قم بتكوين واجهات برمجة التطبيقات التي تريد عرضها داخل تطبيقات الويب الثابتة الخاصة بك على المنتج الذي تم إنشاؤه له، كما هو موضح في قسم تكوين واجهات برمجة التطبيقات لاستقبال الطلبات .