تمكين نهج CORS للموصل المخصص لإدارة واجهة برمجة التطبيقات
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
مشاركة الموارد عبر المنشأ (CORS) هي آلية تستند إلى عنوان HTTP تسمح للخادم بالإشارة إلى أي أصول (مجال أو مخطط أو منفذ) غير أصوله التي يجب أن يسمح المستعرض بتحميل الموارد منها. يمكن للعملاء إضافة نهج CORS إلى واجهات برمجة تطبيقات الويب الخاصة بهم في Azure API Management، والتي تضيف دعم مشاركة الموارد عبر المنشأ إلى عملية أو واجهة برمجة تطبيقات للسماح باستدعاءات عبر المجالات من العملاء المستندين إلى المستعرض.
إذا قمت بتصدير واجهة برمجة تطبيقات من APIM كموصل مخصص في Power Platform وتريد استخدام العملاء المستندين إلى المستعرض بما في ذلك Power Apps أو Power Automate للاتصال بواجهة برمجة التطبيقات، فأنت بحاجة إلى تكوين واجهة برمجة التطبيقات الخاصة بك لتمكين الطلبات عبر المنشأ بشكل صريح من تطبيقات Power Platform. توضح لك هذه المقالة كيفية تكوين إعدادي النهج الضروريين التاليين:
إضافة نهج CORS إلى واجهة برمجة التطبيقات الخاصة بك
إضافة نهج إلى الموصل المخصص الذي يعين رأس الأصل على طلبات HTTP
المتطلبات الأساسية
- إتمام التشغيل السريع التالي: إنشاء مثيل في Azure APIM
- تصدير واجهة برمجة تطبيقات من مثيل إدارة واجهة برمجة التطبيقات إلى بيئة Power Platform كموصل مخصص
إضافة نهج CORS إلى واجهة برمجة التطبيقات في APIM
اتبع هذه الخطوات لتكوين نهج CORS في APIM.
- سجل الدخول إلى مدخل Microsoft Azure وانتقل إلى مثيل APIM.
- في القائمة اليسرى، حدد واجهات برمجة التطبيقات وحدد واجهة برمجة التطبيقات التي قمت بتصديرها كموصل مخصص. إذا كنت ترغب في ذلك، فحدد عملية API فقط لتطبيق النهج عليها.
- في قسم Policies ، في قسم Inbound processing ، حدد + Add policy.
- حدد Allow cross-origin resource sharing (CORS).
- أضف الأصل المسموح به التالي:
https://make.powerapps.com
. - حدد حفظ.
- لمزيد من المعلومات حول تكوين نهج، راجع تعيين النهج أو تحريرها.
- للحصول على تفاصيل حول نهج CORS، راجع مرجع نهج cors .
إشعار
إذا كان لديك بالفعل نهج CORS موجود على مستوى الخدمة (جميع واجهات برمجة التطبيقات) لتمكين وحدة تحكم الاختبار لمدخل المطور، يمكنك إضافة https://make.powerapps.com
الأصل إلى هذا النهج بدلا من تكوين نهج منفصل لواجهة برمجة التطبيقات أو العملية.
إشعار
اعتمادا على كيفية استخدام الموصل المخصص في تطبيقات Power Platform، قد تحتاج إلى تكوين أصول إضافية في نهج CORS. إذا واجهت مشكلات CORS عند تشغيل تطبيقات Power Platform، فاستخدم أدوات المطور في المستعرض الخاص بك، أو التتبع في APIM، أو Application Insights للتحقيق في المشكلات.
إضافة نهج إلى موصل مخصص لتعيين رأس الأصل
أضف النهج التالي إلى الموصل المخصص في بيئة Power Platform. يعين النهج رأس الأصل لمطابقة أصل CORS الذي سمحت به في APIM.
للحصول على تفاصيل حول تحرير إعدادات موصل مخصص، راجع إنشاء موصل مخصص من البداية.
سجل دخولك إلى Power Apps أو Power Automate.
في الجزء الأيمن، حدد Data>Custom الاتصال ors.
حدد الموصل من قائمة الموصلات المخصصة.
حدد أيقونة القلم الرصاص (تحرير) لتحرير الموصل المخصص.
حدد 3. التعريف.
في Policies، حدد + New policy. حدد تفاصيل النهج التالية أو أدخلها.
الإعداد القيمة الاسم اسم من اختيارك، مثل set-origin-header Template تعيين رأس HTTP اسم الرأس المنشا قيمة العنوان https://make.powerapps.com
(نفس عنوان URL الذي قمت بتكوينه في APIM)الإجراء إذا كان الرأس موجودا تجاوز تشغيل السياسة عند Request حدد تحديث الموصل.
بعد تعيين النهج، انتقل إلى 5. صفحة الاختبار لاختبار الموصل المخصص.