الانتقال إلى مدخل المطور الجديد
توضح هذه المقالة الخطوات التي تحتاج إلى اتخاذها للانتقال من المدخل القديم المهمل إلى مدخل المطور الجديد في API Management.
هام
تم الآن إهمال مدخل المطور القديم وسوف يتلقى تحديثات الأمان وحسب. يمكنك الاستمرار في استخدامه، كما جرت العادة، حتى انتهاء خدمته في أكتوبر 2023، عندما سيتم إزالته من جميع خدمات API Management.
التوفر
هام
تتوفر هذه الميزة في المستويات Premium، وStandard، وBasic، وDeveloper لــ API Management.
للحصول على توفر الميزة في مستويات v2 (معاينة)، راجع نظرة عامة على مستويات v2.
تحسينات في مدخل المطور الجديد
يعالج مدخل المطور الجديد العديد من القيود على المدخل المهمل. ويتميز بمحرر السحب والإفلات البصري لتحرير المحتوى ولوحة مخصصة للمصممين لنمط الموقع. يتم حفظ الصفحات والتخصيصات والتكوين كموارد Azure Resource Manager في خدمة API Management، والتي تتيح لك أتمتة عمليات توزيع المدخل. وأخيرًا، قاعدة التعليمات البرمجية للمدخل مفتوحة المصدر، بحيث يمكنك توسيعها باستخدام وظائف مخصصة.
كيفية الانتقال إلى مدخل المطور الجديد
لا يتوافق مدخل المطور الجديد مع المدخل المهمل ولا يمكن الانتقال التلقائي. تحتاج إلى إعادة إنشاء المحتوى يدويًا (الصفحات والنص وملفات الوسائط) وتخصيص مظهر المدخل الجديد. تختلف الخطوات الدقيقة وفقًا لتخصيصات المدخل وتعقيده. راجع البرنامج التعليمي لمدخل المطور للحصول على التوجيه. التكوين المتبقي، مثل قائمة API والمنتجات والمستخدمين ومزودي الهوية، تتم مشاركته تلقائيًا عبر كلا المدخلين.
هام
إذا كنت قد أطلقت بوابة المطور الجديدة من قبل، ولكنك لم تقم بأي تغييرات، فإعادة تعيين المحتوى الافتراضي لتحديثه إلى أحدث إصدار.
عند الانتقال من المدخل المهمل، ضع في اعتبارك التغييرات التالية:
إذا قمت بعرض مدخل المطور عبر مجال مخصص، قم بتعيين مجال إلى مدخل المطور الجديد. استخدم خيار مدخل المطور من القائمة المنسدلة في مدخل Microsoft Azure.
تطبيق نهج CORS على API الخاصة بك لتمكين وحدة التحكم الاختبار التفاعلية.
إذا قمت بحقن CSS مخصصة لتخصيص المدخل، تحتاج إلى نسخ التصميم باستخدام لوحة التصميم المضمنة. لا يسمح بحقن CSS في البوابة الجديدة.
يمكنك حقن JavaScript مخصص فقط في النسخة المستضافة ذاتيًا من المدخل الجديد.
إذا كانت API Management في شبكة اتصال ظاهرية وتم عرضها على الإنترنت عبر Application Gateway، راجع هذه المقالة التوثيقية للحصول على خطوات التكوين الدقيقة. تحتاج إلى:
- تمكين الاتصال بنقطة نهاية API Management.
- تمكين الاتصال بنقطة نهاية المدخل الجديدة.
- تعطيل قواعد جدار حماية تطبيق ويب المحددة.
إذا قمت بتغيير قوالب إعلام البريد الإلكتروني الافتراضية لتضمين محدد موقع معلومات مدخل مهمل معرف بشكل صريح، قم بتغييرها إما لاستخدام معلمة عنوان URL المدخل أو أشر إلى عنوان URL المدخل الجديد. إذا كانت القوالب تستخدم معلمة عنوان URL للمدخل المضمن بدلاً من ذلك، فلن تكون هناك حاجة للتغييرات.
لا يتم دعم المشكلاتوالتطبيقات في مدخل المطور الجديد.
لا يتم دعم التكامل المباشر مع Facebook وMicrosoft وTwitter وGoogle كموفري هوية في بوابة المطور الجديدة. يمكنك الاندماج مع هؤلاء المزودين عبر Azure AD B2C.
إذا كنت تستخدم التفويض، قم بتغيير URL الإرجاع في تطبيقاتك واستخدم نقطة نهاية APIلرمز مميز الوصول المتشارك بدلًا من نقطة نهاية إنشاء URL SSO.
إذا كنت تستخدم معرف Microsoft Entra كموفر هوية:
- قم بتغيير عنوان URL الإرجاع في التطبيق الخاص بك للإشارة إلى مجال المدخل المطور الجديد.
- تعديل لاحقة URL الإرجاع في التطبيق الخاص بك من
/signin-aadإلى/signin.
إذا كنت تستخدم Azure AD B2C كموفر هوية:
- قم بتغيير عنوان URL الإرجاع في التطبيق الخاص بك للإشارة إلى مجال المدخل المطور الجديد.
- تعديل لاحقة URL الإرجاع في التطبيق الخاص بك من
/signin-aadإلى/signin. - قم بتضمين الاسم المعطى، واللقب، ومعرف الكائن للمستخدم في مطالبات التطبيق.
إذا كنت تستخدم OAuth 2.0 في وحدة التحكم الاختبار التفاعلية، قم بتغيير URL الإرجاع في التطبيق الخاص بك للإشارة إلى مجال المدخل المطور الجديد وتعديل اللاحقة:
- من
/docs/services/[serverName]/console/oauth2/authorizationcode/callbackإلى/signin-oauth/code/callback/[serverName]لتدفق منح تعليم التفويض البرمجي. - من
/docs/services/[serverName]/console/oauth2/implicit/callbackإلى/signin-oauth/implicit/callbackلتدفق المنح الضمني.
- من
إذا كنت تستخدم OpenID Connect في وحدة التحكم الاختبار التفاعلية، قم بتغيير URL الإرجاع في التطبيق الخاص بك للإشارة إلى مجال المدخل المطور الجديد وتعديل اللاحقة:
- من
/docs/services/[serverName]/console/openidconnect/authorizationcode/callbackإلى/signin-oauth/code/callback/[serverName]لتدفق منح تعليم التفويض البرمجي. - من
/docs/services/[serverName]/console/openidconnect/implicit/callbackإلى/signin-oauth/implicit/callbackلتدفق المنح الضمني.
- من
الخطوات التالية
تعرف على المزيد حول مدخل المطور: