مشاركة موصل مخصص
الآن بعد أن قمت بإنشاء موصل مخصص لواجهة برمجة تطبيقات Printer Framer، تريد جعل الموصل متاحاً لجميع المستخدمين في مؤسستك. وبهذه الطريقة، يمكنهم استدعاء واجهة برمجة التطبيقات هذه من مهام سير عمل Azure Logic Apps الخاصة بهم. تعرف أيضًا أن العديد من عملائك يستخدمون Azure Logic Apps. إذا كان يمكنك نشر موصل جديد لهم، فإنه يمكنهم إجراء استدعاءات لواجهة برمجة التطبيقات API الخاص بك بسهولة.
مشاركة موصل مع المؤسسة
إذا قمت بإنشاء موصل مخصص واستخدامه في سير عمل تطبيق منطقي، بشكل افتراضي، يتوفر هذا الموصل لمستخدمي Azure Logic Apps الآخرين في مؤسستك. يمكنهم إضافة الموصل إلى مهام سير العمل في مناطق تطبيق المنطق إذا كانت تفي بالمعايير التالية:
- إنهم يشاركونك نفس مستأجر Microsoft Entra.
- ويشتركون معك في نفس اشتراك Azure.
تشارك Azure Logic Apps الموصلات المخصصة تلقائيًا، والتي يمكن للمستخدمين الآخرين رؤيتها عند تحديد الموصلات لمهام سير العمل الخاصة بهم. ومع ذلك، قد ترغب في إعلامهم بالموصل الجديد والغرض منه وكيفية استخدامه وما إلى ذلك.
مشاركة رابط مع المجتمع
إذا كان بإمكان المستخدمين الخارجيين الاتصال بواجهة برمجة التطبيقات (API) الخاصة بك، ففكر في نشر الموصل المخصص الخاص بك إلى مجتمع Azure. يجعل النشر إنشاء مهام سير العمل باستخدام Azure Logic Apps والوصول إلى بياناتك من خلال واجهة برمجة التطبيقات أسهل بكثير. كما يساعد إتاحة الموصل المخصص على نطاق أوسع على تعزيز واجهة برمجة التطبيقات الخاصة بك ودفع اعتماد المجتمع.
تعد واجهة برمجة تطبيقات Print Framer مثالاً جيداً. يمكن لأي شخص لديه اشتراك ويمكنه كتابة تعليمة برمجية تقوم بإجراء استدعاءات واجهة برمجة تطبيقات REST الوصول إلى واجهة برمجة التطبيقات لديك. ومع ذلك، إذا قمت بنشر الموصل الجديد، يمكن لهؤلاء الأشخاص الذين يستخدمون Azure Logic Apps استدعاء واجهة برمجة التطبيقات من مهام سير العمل الخاصة بهم دون كتابة أي تعليمة برمجية. قد لا يعرف بعض الأشخاص عن واجهة برمجة التطبيقات الخاصة بك، لذلك إذا وجدوا الموصل الخاص بك من خلال معرض موصل Azure Logic Apps، فقد يقررون تجربة واجهة برمجة التطبيقات وحتى شراء اشتراك.
لنشر الموصل الخاص بك في معرض موصل Azure Logic Apps، يجب عليك إرسال الموصل إلى Microsoft للحصول على الشهادة. إذا كان الموصل يفي بمعايير الشهادة، فسوف تنشر Microsoft الموصل لجميع مستخدمي Azure Logic Apps للبحث عنه واستخدامه.
معايير التصديق
تعتمد Microsoft الموصلات التي تفي بالمعايير التالية فقط:
| الميزة | مطلوب أو مُوصى به | الوصف |
|---|---|---|
| خدمة تأجير البرامج | المطلوب | يجب أن تمتلك مؤسستك واجهة برمجة التطبيقات التي يوفر الموصل الوصول إليها. |
| المصادقة | المطلوب | يجب أن تدعم واجهة برمجة التطبيقات API الخاصة بك OAuth2 أو مفتاح واجهة برمجة التطبيقات API أو المصادقة الأساسية. |
| يدعم | المطلوب | تحتاج إلى توفير عقد دعم للمستخدمين حتى يتمكن العملاء من طلب المساعدة في المشكلات الفنية. |
| التوافر | مستحسن | ضمان وقت تشغيل بنسبة 99.9% على الأقل في اتفاقية مستوى الخدمة (SLA) لديك. |
قائمة التحقق قبل إرسال موصل
اختبر الموصل بالكامل قبل إرساله للمصادقة. تأكد من أنك واثق من عدم وجود أخطاء أو مشكلات أخرى. تغطي القائمة التالية المشاكل الشائعة التي يجب التحقق منها وحلها:
- الأخطاء في تعريف OpenAPI: قم بإزالة أي تعليمة JSON برمجية غير صالحة في ملف تعريف واجهة برمجة التطبيقات. تأكد من أن تعريف واجهة برمجة التطبيقات يتوافق مع مخطط OpenAPI.
- المعلومات الكاملة في التعريف: تأكد من أن كل عملية ومعلمة إدخال وسمة استجابة في مواصفات OpenAPI التي ترسلها تحتوي على ملخص ووصف ومعلومات الرؤية.
إرسال موصل للحصول على الاعتماد
تستغرق عملية الاعتماد حوالي أسبوعين، لكن هذا المخطط الزمني يعتمد على مدى استيفاء الموصل للمعايير السابقة. تعمل العملية بشكل مشابه للخطوات التالية:
الترشيح: تفضل بزيارة نموذج الترشيح لإرسال الموصل الخاص بك. سترسل Microsoft اتفاقية شريك.
المراجعة: بعد توقيع الاتفاقيات، يقوم أحد موظفي Microsoft بمراجعة الموصل. قد تحتاج إلى تقديم معرف الموصل، وتعريف OpenAPI، وملف رمز، وحساب اختبار، وعنوان بريد إلكتروني للدعم، ومعلومات أخرى.
النشر: تقوم Microsoft بالتقسيم المرحلي والنشر للموصل باستخدام علامة "معاينة".
الدعم والتحديثات: بعد نشر Microsoft للموصل وبدء الأشخاص في استخدامه، راقب منتديات المنتجات ذات الصلة لمعرفة ما إذا كان العملاء يواجهون أي مشاكل. إذا كنت بحاجة إلى إرسال نسخة جديدة، فاستخدم نفس نموذج الترشيح. بعد أن يكون الموصل متاحًا لبعض الوقت، يمكنك أن تطلب من جهة اتصال الترشيح إزالة علامة "معاينة".
لمزيد من المعلومات، راجع إرسال الموصل لشهادة Microsoft.