تبادل رسائل AS2 باستخدام مهام سير العمل في Azure Logic Apps

  • مقالة

ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)

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

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

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

مرجع تقني الاتصال أو

يحتوي موصل AS2 على إصدارات مختلفة، استنادا إلى نوع التطبيق المنطقي وبيئة المضيف.

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

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

- مرجع موصل AS2 المدار
- عمليات الموصل المدارة AS2 (v2)
- حدود رسائل AS2
قياسي تطبيقات Azure Logic للمستأجر الفردي وبيئة خدمة التطبيقات الإصدار 3 (خطط Windows فقط) موصل AS2 (v2) مضمن وموصل AS2 مدار. يختلف الإصدار المضمن بالطرق التالية:

- يوفر الإصدار المضمن إجراءات فقط، ولكن يمكنك استخدام أي مشغل يعمل مع السيناريو الخاص بك.

- يمكن للإصدار المضمن الوصول مباشرة إلى شبكات Azure الظاهرية. لا تحتاج إلى بوابة بيانات محلية.

لمزيد من المعلومات، راجع الوثائق التالية:

- مرجع موصل AS2 المدار
- عمليات الموصل المضمنة AS2 (v2)
- حدود رسائل AS2

عمليات AS2 (v2)

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

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

- تسجيل الرسائل الصادرة.
- تشفير الرسائل الصادرة.
- ضغط الرسالة.
- إرسال اسم الملف في رأس MIME.
إجراء فك ترميز AS2 توفير فك التشفير والتوقيع الرقمي والإقرارات من خلال إعلامات التخلص من الرسائل (MDN). على سبيل المثال، ينفذ هذا الإجراء المهام التالية عند تكوينه:

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

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

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

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

  • مورد حساب تكامل لتعريف البيانات الاصطناعية وتخزينها لاستخدامها في تكامل المؤسسة وسير عمل B2B.

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

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

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

  • استنادا إلى ما إذا كنت تعمل على سير عمل Consumption أو Standard logic app، قد يتطلب مورد تطبيق المنطق ارتباطا بحساب التكامل الخاص بك:

    سير عمل تطبيق المنطق هل الارتباط مطلوب؟
    الاستهلاك‬ - موصل AS2 (v2): مطلوب الاتصال، ولكن لا يلزم وجود ارتباط
    - موصل AS2 : الارتباط مطلوب، ولكن لا يوجد اتصال مطلوب
    قياسي - موصل AS2 (v2):الارتباط مطلوب، ولكن لا يلزم الاتصال
    - موصل AS2: مطلوب الاتصال، ولكن لا يوجد ارتباط مطلوب

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

    1. في مدخل Microsoft Azure، افتح key vault الخاص بك. في قائمة key vault، ضمن Settings، حدد Keys.

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

    3. في جزء Key Version، ضمن Permitted operations، تأكد من تحديد عمليات EncryptDecrypt، على سبيل المثال:

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

ترميز رسائل AS2

حدد علامة التبويب لسير عمل التطبيق المنطقي القياسي أو الاستهلاك:

موصل AS2 v2

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

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء AS2 (v2) المسمى AS2 Encode إلى سير العمل الخاص بك.

  3. في مربع معلومات الإجراء، قم بتوفير المعلومات التالية:

    الخاصية المطلوب ‏‏الوصف
    رسالة الترميز ‏‏نعم‬ حمولة الرسالة، على سبيل المثال، إخراج النص الأساسي من مشغل الطلب.

    1. ضع المؤشر في المربع رسالة لترميز بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد النص الأساسي.
    AS2 من ‏‏نعم‬ معرف العمل لمرسل الرسائل كما هو محدد في اتفاقية AS2، على سبيل المثال، Fabrikam.
    AS2 إلى ‏‏نعم‬ معرف العمل لجهاز استقبال الرسالة كما هو محدد في اتفاقية AS2، على سبيل المثال، Contoso.

    Screenshot showing the

موصل AS2

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

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء AS2 المسمى Encode إلى رسالة AS2 إلى سير العمل الخاص بك.

  3. عند مطالبتك بإنشاء اتصال بحساب التكامل خاصتك، قم بتوفير المعلومات التالية:

    الخاصية المطلوب ‏‏الوصف
    اسم الاتصال ‏‏نعم‬ اسم للاتصال
    حساب التكامل ‏‏نعم‬ من قائمة حسابات التكامل المتوفرة، حدد الحساب الذي تريد استخدامه.

    على سبيل المثال:

    Screenshot showing Consumption workflow and

  4. عند الانتهاء، حدد إنشاء.

  5. في مربع معلومات الإجراء، قم بتوفير المعلومات التالية.

    الخاصية المطلوب ‏‏الوصف
    AS2-From ‏‏نعم‬ معرف العمل لمرسل الرسائل كما هو محدد في اتفاقية AS2، على سبيل المثال، Fabrikam.
    AS2-To ‏‏نعم‬ معرف العمل لجهاز استقبال الرسالة كما هو محدد في اتفاقية AS2، على سبيل المثال، Contoso.
    النص الأساسي ‏‏نعم‬ حمولة الرسالة لترميز، على سبيل المثال، إخراج النص الأساسي من مشغل الطلب.

    1. ضع المؤشر في مربع النص الأساسي بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد النص الأساسي.

    Screenshot showing the

فك ترميز رسائل AS2

حدد علامة التبويب لسير عمل التطبيق المنطقي القياسي أو الاستهلاك:

موصل AS2 v2

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

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء AS2 (v2) المسمى AS2 Decode إلى سير العمل الخاص بك.

  3. في مربع معلومات الإجراء، قم بتوفير المعلومات التالية:

    الخاصية المطلوب ‏‏الوصف
    النص الأساسي ‏‏نعم‬ نص الرسالة المراد فك ترميزها، على سبيل المثال، إخراج النص الأساسي من مشغل الطلب.

    1. ضع المؤشر في مربع النص الأساسي بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد النص الأساسي.
    رؤوس ‏‏نعم‬ رؤوس الرسالة المراد فك ترميزها، على سبيل المثال، إخراج الرؤوس من مشغل الطلب.

    1. ضع المؤشر في المربع رؤوس بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد الرؤوس.

    على سبيل المثال:

    Screenshot showing the

موصل AS2

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

  2. في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء AS2 المسمى رسالة Decode AS2 إلى سير العمل الخاص بك.

  3. عند مطالبتك بإنشاء اتصال بحساب التكامل خاصتك، قم بتوفير المعلومات التالية:

    الخاصية المطلوب ‏‏الوصف
    اسم الاتصال ‏‏نعم‬ اسم للاتصال
    حساب التكامل ‏‏نعم‬ من قائمة حسابات التكامل المتوفرة، حدد الحساب الذي تريد استخدامه.

    على سبيل المثال:

    Screenshot showing Consumption workflow and

  4. عند الانتهاء، حدد إنشاء.

  5. في مربع معلومات الإجراء، قم بتوفير المعلومات التالية.

    الخاصية المطلوب ‏‏الوصف
    النص الأساسي ‏‏نعم‬ حمولة الرسالة، على سبيل المثال، إخراج النص الأساسي من مشغل الطلب.

    1. ضع المؤشر في مربع النص الأساسي بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد النص الأساسي.
    رؤوس ‏‏نعم‬ رؤوس الرسالة المراد فك ترميزها، على سبيل المثال، إخراج الرؤوس من مشغل الطلب.

    1. ضع المؤشر في المربع رؤوس بحيث يتم فتح قائمة المحتوى الديناميكي.
    2. بجوار اسم المقطع عند تلقي طلب HTTP، حدد مشاهدة المزيد.
    3. من قائمة المخرجات، حدد الرؤوس.

    Screenshot showing the

عينة

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

استكشاف الأخطاء وإصلاحها

  • مشاكل عند إرسال رسائل موقعة أو مشفرة

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

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