Exchange رسائل AS2 باستخدام مهام سير العمل في تطبيقات Azure المنطقية

  • مقالة
  • قراءة خلال 7 دقائق

لإرسال رسائل AS2 وتلقيها في مهام سير العمل التي تقوم بإنشائها باستخدام Azure Logic Apps، استخدم موصل AS2، الذي يوفر المشغلات والإجراءات التي تدعم اتصال AS2 (الإصدار 1.2) وتدديره.

  • إذا كنت تعمل مع نوع مورد تطبيق المنطق (الاستهلاك) ولا تحتاج إلى إمكانات تعقب، فاستخدم موصل AS2 (v2)، بدلا من موصل AS2 الأصلي، الذي يتم إهماله.

    باستثناء التعقب، يوفر AS2 (v2) أداء أفضل، ونفس إمكانات الإصدار الأصلي، وهو أصلي في وقت تشغيل Azure Logic Apps، ولديه تحسينات كبيرة في الأداء في حجم الرسالة والإنتاجية والكمون. أيضا ، لا يتطلب موصل v2 إنشاء اتصال بحساب التكامل الخاص بك. بدلا من ذلك، كما هو موضح في المتطلبات الأساسية، تأكد من ربط حساب التكامل الخاص بك بمورد التطبيق المنطقي حيث تخطط لاستخدام الموصل.

  • إذا كنت تعمل مع نوع مورد Logic App (قياسي)، فلن يتوفر حاليا سوى موصل AS2 الأصلي.

    للحصول على معلومات تقنية حول إصدار موصل AS2 الأصلي، راجع الصفحة المرجعية للموصل، والتي تصف المشغلات والإجراءات والحدود كما هو موثق بواسطة ملف Swagger الخاص بالموصل.

تصف القوائم التالية الإجراءات التي يوفرها موصل AS2 (v2) لإنشاء الأمان والموثوقية عند إرسال الرسائل:

  • إجراء AS2 Encode لتوفير التشفير والتوقيع الرقمي والإقرارات من خلال إعلامات التصرف في الرسائل (MDN)، والتي تساعد على دعم عدم التنصل منها. على سبيل المثال، يطبق هذا الإجراء رؤوس AS2/HTTP وينفذ هذه المهام عند تكوينها:

    • يوقع الرسائل الصادرة.
    • تشفير الرسائل الصادرة.
    • يضغط الرسالة.
    • ينقل اسم الملف في رأس MIME.

  • إجراء فك تشفير AS2 لتوفير فك التشفير والتوقيع الرقمي والإقرارات من خلال إعلامات التصرف في الرسائل (MDN). على سبيل المثال، ينفذ هذا الإجراء المهام التالية:

    • يعالج رؤوس AS2/HTTP.
    • يوفق بين MDNs المستلمة والرسائل الصادرة الأصلية.
    • تحديث وربط السجلات في قاعدة بيانات عدم التنصل منها.
    • يكتب سجلات لتقارير حالة AS2.
    • إخراج محتويات الحمولة الصافية على أنها base64-مشفرة.
    • يحدد ما إذا كانت MDNs مطلوبة أم لا. استنادا إلى اتفاقية AS2 ، يحدد ما إذا كان يجب أن تكون MDNs متزامنة أو غير متزامنة.
    • يقوم بإنشاء MDNs متزامنة أو غير متزامنة استنادا إلى اتفاقية AS2.
    • يضبط الرموز المميزة للارتباط وخصائصه على MDNs.

    يقوم هذا الإجراء أيضا بتنفيذ هذه المهام عند تكوينه:

    • يتحقق من التوقيع.
    • فك تشفير الرسائل.
    • فك ضغط الرسالة.
    • تحقق من تكرارات معرف الرسالة وارفضها.

توضح هذه المقالة كيفية إضافة إجراءات ترميز AS2 وفك تشفيرها إلى سير عمل تطبيق منطقي موجود. على الرغم من أنه يمكنك استخدام أي مشغل لبدء سير العمل، إلا أن الأمثلة تستخدم مشغل الطلب .

الحدود

للحصول على معلومات حول حدود موصل AS2 لمهام سير العمل التي تعمل في تطبيقات Azure Logic متعددة المستأجرين أو تطبيقات Azure Logic ذات المستأجر الواحد أو بيئة خدمة التكامل (ISE)، راجع حدود بروتوكول B2B لأحجام الرسائل.

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

  • حساب واشتراك Azure. إذا لم يكن لديك اشتراك بعد، فقم بالتسجيل للحصول على حساب Azure مجاني.

  • مورد حساب تكامل حيث تقوم بتعريف القطع الأثرية وتخزينها، مثل الشركاء التجاريين والاتفاقيات والشهادات وما إلى ذلك، لاستخدامها في تكامل المؤسسة ومهام سير عمل B2B. يجب أن يفي هذا المورد بالمتطلبات التالية:

    • مقترن بنفس اشتراك Azure مثل مورد التطبيق المنطقي.

    • موجود في نفس الموقع أو منطقة Azure مثل مورد التطبيق المنطقي.

    • عند استخدام نوع مورد تطبيق المنطق (الاستهلاك) وعمليات AS2 (v2)، لا يحتاج مورد التطبيق المنطقي إلى ارتباط إلى حساب التكامل الخاص بك. ومع ذلك، لا تزال بحاجة إلى هذا الحساب لتخزين القطع الأثرية، مثل الشركاء والاتفاقيات والشهادات، إلى جانب استخدام عمليات AS2 أو X12 أو EDIFACT . لا يزال يتعين على حساب التكامل الخاص بك تلبية المتطلبات الأخرى، مثل استخدام نفس اشتراك Azure والموجود في نفس الموقع مثل مورد التطبيق المنطقي.

    • عند استخدام نوع مورد Logic App (قياسي) وعمليات AS2 الأصلية، يتطلب سير العمل اتصالا بحساب التكامل الذي تقوم بإنشائه مباشرة من سير العمل عند إضافة عملية AS2.

  • شريكان تجاريان على الأقل في حساب التكامل الخاص بك. يجب أن تستخدم تعريفات كلا الشريكين نفس مؤهل هوية العمل ، وهو AS2Identity لهذا السيناريو.

  • اتفاقية AS2 في حساب التكامل الخاص بك بين الشركاء التجاريين الذين يشاركون في سير عملك. تتطلب كل اتفاقية شريكا مضيفا وشريكا ضيفا. يجب أن يتطابق المحتوى الموجود في الرسائل بينك وبين الشريك الآخر مع نوع الاتفاقية.

  • مورد التطبيق المنطقي وسير العمل حيث تريد استخدام عمليات AS2.

    ملاحظة

    يوفر موصل AS2 (v2) الإجراءات فقط، وليس المشغلات. في هذه المقالة، تستخدم أمثلة هذا الموصل مشغل الطلب . يتضمن موصل AS2 الأصلي المشغلات والإجراءات. لمزيد من المعلومات حول مشغلات موصل AS2 الأصلي وإجراءاته وإصداره الحدودي، راجع الصفحة المرجعية للموصل كما هو موثق بواسطة ملف Swagger الخاص بالموصل.

    إذا كنت جديدا على التطبيقات المنطقية، فراجع ما هي تطبيقات Azure Logicوالتشغيل السريع: أنشئ تطبيقك المنطقي الأول.

  • إذا كنت تستخدم Azure Key Vault لإدارة الشهادات، فتحقق من أن مفاتيح المخزن تسمح بعمليتي التشفيروفك التشفير. وإلا، تفشل إجراءات الترميز وفك التشفير.

    1. في مدخل Azure، افتح مخزن المفاتيح. في قائمة المخزن الرئيسي، ضمن الإعدادات، حدد المفاتيح.

    2. في جزء المفاتيح ، حدد مفتاحك. في جزء الإصدارات ، حدد الإصدار الأساسي الذي تستخدمه.

    3. في جزء إصدار المفاتيح ، ضمن العمليات المسموح بها، تأكد من تحديد عمليتي التشفيروفك التشفير ، على سبيل المثال:

      Screenshot showing the Azure portal with the key vault, key, and key version panes open, which has the

ترميز رسائل AS2

  1. في مدخل Azure، افتح مورد التطبيق المنطقي وسير العمل في المصمم.

  2. على المصمم، ضمن المشغل أو الإجراء الذي تريد إضافة الإجراء AS2 إليه، حدد خطوة جديدة.

  3. ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل as2 encode. حدد الإجراء المسمى AS2 ترميز.

    Screenshot showing the Azure portal, workflow designer, and

  4. بعد ظهور عملية AS2 على المصمم، قم بتوفير معلومات للخصائص التالية:

    الخاصية مطلوب الوصف
    رسالة للترميز نعم حمولة الرسالة
    AS2 من نعم معرف النشاط التجاري لمرسل الرسالة كما هو محدد في اتفاقية AS2 الخاصة بك
    AS2 إلى نعم معرف العمل لمستقبل الرسائل كما هو محدد في اتفاقية AS2 الخاصة بك

    على سبيل المثال، حمولة الرسالة هي إخراج محتوى النص الأساسي من مشغل الطلب:

    Screenshot showing the

    تلميح

    إذا واجهت مشكلات عند إرسال رسائل موقعة أو مشفرة، ففكر في تجربة تنسيقات خوارزمية SHA256 مختلفة. لا توفر مواصفات AS2 أي معلومات حول تنسيقات SHA256، لذلك يستخدم كل موفر التنفيذ أو التنسيق الخاص به.

فك تشفير رسائل AS2

  1. في مدخل Azure، افتح مورد التطبيق المنطقي وسير العمل في المصمم.

  2. على المصمم، ضمن المشغل أو الإجراء الذي تريد إضافة الإجراء AS2 إليه، حدد خطوة جديدة. يستخدم هذا المثال مشغل الطلب .

  3. ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل as2 decode. حدد الإجراء المسمى AS2 فك تشفير.

    Screenshot showing the Azure portal, workflow designer, and

  4. في شكل عملية AS2، حدد قيم الرسالة المراد ترميزها وخصائص رؤوس الرسائل من مخرجات المشغل أو الإجراء السابقة.

    في هذا المثال، يمكنك تحديد المخرجات من مشغل الطلب.

    Screenshot showing the Azure portal, workflow designer, and

العينة

لمحاولة نشر تطبيق منطقي يعمل بكامل طاقته ونموذج سيناريو AS2 (v2)، راجع قالب وسيناريو التطبيق المنطقي AS2 (v2).

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