Share via

استيراد تطبيق وظائف Azure كواجهة برمجة تطبيقات في Azure APIM

  • مقالة

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

تدعم Azure APIM استيراد تطبيقات وظائف Azure كواجهات برمجة تطبيقات جديدة أو إلحاقها بواجهات برمجة التطبيقات الموجودة. تنشئ العملية تلقائيًا مفتاح مضيف في تطبيق وظائف Azure، والذي يتم تعيينه بعد ذلك إلى قيمة محددة في Azure APIM.

تتناول هذه المقالة استيراد واختبار تطبيق Azure Function كواجهة برمجة تطبيقات في Azure API Management.

ستتعرف على كيفية...

  • استيراد تطبيق Azure Function كواجهة برمجة تطبيقات
  • بإلحاق تطبيق Azure Function بواجهة برمجة تطبيقات
  • عرض مفتاح مضيف تطبيق Azure Function الجديد والقيمة المسماة Azure API Management
  • حدد التطبيق في مدخل Microsoft Azure

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

  • أكمل التشغيل السريعلمثيل Azure APIM.
  • تأكد من أن لديك تطبيق Azure Functions في اشتراكك. لمزيد من المعلومات، راجع إنشاء تطبيق Azure Function. يجب أن تحتوي الدالات على مشغل HTTP ومستوى تخويل معين على مجهول أو دالة.

إشعار

يمكنك استخدام ملحق API Management لـ Visual Studio Code لاستيراد واجهات برمجة التطبيقات وإدارتها. اتبع البرنامج التعليمي لملحق API Management للتثبيت وبدء التشغيل.

الانتقال إلى مثيل إدارة واجهة برمجة التطبيقات لديك

  1. في مدخل Microsoft Azure، ابحث عن خدمات APIM وحددها.

    تحديد خدمات إدارة واجهة برمجة التطبيقات

  2. في صفحة خدمات إدارة واجهة برمجة التطبيقات، حدد مثيل إدارة واجهة برمجة التطبيقات.

    حدد مثيل خدمات إدارة واجهة برمجة التطبيقات لديك

استيراد تطبيق Azure Function كواجهة برمجة تطبيقات جديدة

اتبع الخطوات أدناه لإنشاء واجهة برمجة تطبيقات جديدة من تطبيق Azure Function.

  1. انتقل إلى خدمة إدارة API في بوابة Azure وحدد واجهات برمجة التطبيقات من القائمة.

  2. في القائمة Add a new API، حدد Function App.

    لقطة شاشة تعرض إطار Function App.

  3. انقر فوق Browse لتحديد Functions للاستيراد.

    لقطة شاشة تبرز الزر

  4. انقر فوق قسم Function App للاختيار من قائمة Function Apps المتاحة.

    لقطة شاشة تبرز قسم Function App.

  5. ابحث عن Function App الذي تريد استيراد Functions منه، وانقر فوقه ثم اضغط على Select.

    لقطة شاشة تبرز Function App الذي تريد استيراد Functions منه والزر

  6. حدد Functions التي ترغب في استيرادها وانقر فوق Select.

    • يمكنك فقط استيراد Functions المستندة إلى مشغل HTTP بمستويات تخويل مجهول أو دالة.

    لقطة شاشة تبرز Functions المراد استيرادها والزر

  7. قم بالتبديل إلى طريقة العرض Full وتعيين Product إلى واجهة برمجة التطبيقات الجديدة.

  8. إذا لزم الأمر، حدد الحقول الأخرى أثناء الإنشاء أو قم بتكوينها لاحقاً عبر علامة التبويب إعدادات.

    إشعار

    المنتجات عبارة عن اقترانات لواحدة أو أكثر من واجهات برمجة التطبيقات المقدمة للمطورين من خلال مدخل المطور. أولاً، يجب على المطورين الاشتراك في أحد المنتجات للوصول إلى واجهة برمجة التطبيقات. بمجرد الاشتراك، يحصلون على مفتاح اشتراك لأي واجهة برمجة تطبيقات في هذا المنتج. بصفتك منشئ مثيل API Management، فأنت مسؤول ومشترك في كل منتج افتراضيًا.

    يأتي كل مثيل API Management مع منتجين نموذجيين افتراضيين:

    • Starter
    • غير محدود

  9. انقر فوق Create.

إلحاق Azure Function App بواجهة برمجة تطبيقات موجودة

اتبع الخطوات أدناه لإلحاق تطبيق Azure Function بواجهة برمجة تطبيقات موجودة.

  1. في مثيل خدمة Azure API Management، حدد APIs من القائمة الموجودة على اليسار.

  2. اختر واجهة برمجة تطبيقات تريد استيراد تطبيق Azure Function إليها. انقر فوق ... وحدد Import من قائمة السياق.

    لقطة شاشة تبرز خيار قائمة الاستيراد.

  3. انقر فوق إطار Function App.

    لقطة شاشة تبرز إطار Function App.

  4. في النافذة المنبثقة، انقر فوق Browse.

    لقطة شاشة تعرض الزر

  5. انقر فوق قسم Function App للاختيار من قائمة Function Apps المتاحة.

    لقطة شاشة تبرز قائمة Function Apps.

  6. ابحث عن Function App الذي تريد استيراد Functions منه، وانقر فوقه ثم اضغط على Select.

    لقطة شاشة تبرز Function App الذي تريد استيراد الوظائف منه.

  7. حدد Functions التي ترغب في استيرادها وانقر فوق Select.

    لقطة شاشة تبرز الوظائف التي ترغب في استيرادها.

  8. انقر فوق استيراد.

    إلحاق من Function App

التصريح

ينشئ استيراد تطبيق Azure Function تلقائياً:

  • مفتاح المضيف داخل Function App باسم apim-{اسم مثيل خدمة Azure API Management}،
  • القيمة المسماة داخل مثيل Azure API Management بالاسم {اسم مثيل تطبيق Azure Function}-المفتاح، والذي يحتوي على مفتاح المضيف الذي تم إنشاؤه.

بالنسبة إلى واجهات برمجة التطبيقات التي تم إنشاؤها بعد 4 أبريل 2019، يتم تمرير مفتاح المضيف في طلبات HTTP من API Management إلى Function App في العنوان. تقوم واجهات برمجة التطبيقات القديمة بتمرير مفتاح المضيف باعتباره معلمة استعلام. يمكنك تغيير هذا السلوك من خلال PATCH Backendاستدعاء واجهة برمجة تطبيقات REST في كيان الخلفية Backend المرتبط بـ Function App.

تحذير

ستؤدي إزالة أو تغيير قيمة مفتاح مضيف تطبيق Azure Function أو القيمة المسماة Azure API Management إلى قطع الاتصال بين الخدمات. لا تتم مزامنة القيم تلقائيا.

إذا كنت بحاجة إلى تدوير مفتاح المضيف، فتأكد أيضاً من تعديل القيمة المسماة في Azure API Management.

الوصول إلى مفتاح مضيف Azure Function App

  1. انتقل إلى مثيل Azure Function App.

    لقطة شاشة تبرز تحديد مثيل تطبيق Function.

  2. في قسم Functions بقائمة التنقل الجانبية، حدد App keys.

    لقطة شاشة تبرز خيار إعدادات Function Apps.

  3. ابحث عن المفاتيح ضمن قسم مفاتيح المضيف.

    لقطة شاشة تبرز قسم مفاتيح المضيف.

الوصول إلى القيمة المسماة في Azure API Management

انتقل إلى مثيل Azure API Management وحدد Named values من القائمة الموجودة على اليسار. يتم تخزين مفتاح Azure Function App هناك.

إضافة من Function App

اختبار API الجديد في مدخل Microsoft Azure

يمكنك استدعاء العمليات مباشرة من مدخل Azure. يعد استخدام مدخل Azure طريقة مناسبة لعرض عمليات واجهة برمجة التطبيقات واختبارها.

لقطة شاشة توضح إجراء الاختبار.

  1. حدد واجهة برمجة التطبيقات التي قمت بإنشائها في القسم السابق.

  2. حدد علامة التبويب الاختبار.

  3. حدد العملية التي تريد اختبارها.

    • تعرض الصفحة حقولاً لمعلمات وعناوين الاستعلام.
    • أحد العناوين هو "Ocp-Apim-Subscription-Key"، لمفتاح اشتراك المنتج المرتبط بواجهة برمجة التطبيقات هذه.
    • بصفتك منشئ مثيل API Management، فأنت مسؤول بالفعل، لذلك يتم ملء المفتاح تلقائياً.

  4. حدد إرسال.

    • عندما ينجح الاختبار، تستجيب النهاية الخلفية بـ 200 OK وبعض البيانات.

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

تحويل واجهة برمجة تطبيقات منشورة وحمايتها