Enterprise Integration Pack ile Azure Logic Apps B2B kurumsal tümleştirme için Exchange AS2 iletileriExchange AS2 messages for B2B enterprise integration in Azure Logic Apps with Enterprise Integration Pack

Azure Logic Apps içinde AS2 iletilerle çalışmak için, AS2 iletişimini yönetmeye yönelik Tetikleyiciler ve eylemler sağlayan AS2 bağlayıcısını kullanabilirsiniz.To work with AS2 messages in Azure Logic Apps, you can use the AS2 connector, which provides triggers and actions for managing AS2 communication. Örneğin, iletileri aktarırken güvenlik ve güvenilirlik sağlamak için şu işlemleri kullanabilirsiniz:For example, to establish security and reliability when transmitting messages, you can use these actions:

  • AS2 kodlama , dijital Imzalama ve ileti değerlendirme bildirimleri (MDN) aracılığıyla, geçiş dışı desteği sağlamaya yardımcı olan bir kodlama eylemi.AS2 Encode action for providing encryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN), which help support non-repudiation. Örneğin, bu eylem AS2/HTTP üstbilgilerini uygular ve yapılandırıldığında bu görevleri gerçekleştirir:For example, this action applies AS2/HTTP headers and performs these tasks when configured:

    • Giden iletileri imzalar.Signs outgoing messages.
    • Giden iletileri şifreler.Encrypts outgoing messages.
    • İletiyi sıkıştırır.Compresses the message.
    • Dosya adını MIME üstbilgisinde iletir.Transmits the file name in the MIME header.
  • Ileti değerlendirmesi bildirimleri (MDN) aracılığıyla şifre çözme, dijital imzalama ve bildirim sağlamak için AS2 kod çözme eylemi .AS2 Decode action for providing decryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN). Örneğin, bu eylem şu görevleri gerçekleştirir:For example, this action performs these tasks:

    • AS2/HTTP üst bilgilerini işler.Processes AS2/HTTP headers.
    • Uzlaştırdığı, özgün giden iletilerle MDNs aldı.Reconciles received MDNs with the original outbound messages.
    • Red olmayan veritabanındaki kayıtları güncelleştirir ve bunları karşılıklı olarak ilişkilendirir.Updates and correlates records in the non-repudiation database.
    • AS2 durum raporlaması için kayıtlar yazar.Writes records for AS2 status reporting.
    • Yük içeriğini Base64 kodlamalı olarak verir.Outputs payload contents as base64-encoded.
    • MDNs gerekip gerekmediğini belirler.Determines whether MDNs are required. AS2 sözleşmesine bağlı olarak, MDNs 'nin zaman uyumlu veya zaman uyumsuz olup olmayacağını belirler.Based on the AS2 agreement, determines whether MDNs should be synchronous or asynchronous.
    • AS2 sözleşmesine göre zaman uyumlu veya zaman uyumsuz MDNs oluşturur.Generates synchronous or asynchronous MDNs based on the AS2 agreement.
    • MDNs üzerindeki bağıntı belirteçlerini ve özellikleri ayarlar.Sets the correlation tokens and properties on MDNs.

    Bu eylem, yapılandırıldığında da bu görevleri gerçekleştirir:This action also performs these tasks when configured:

    • İmzayı doğrular.Verifies the signature.
    • İletilerin şifresini çözer.Decrypts the messages.
    • İletiyi açar.Decompresses the message.
    • İleti KIMLIĞI yinelemelerini denetleyin ve izin vermeyin.Check and disallow message ID duplicates.

Bu makalede, AS2 Encoding ve kod çözme eylemlerinin mevcut bir mantıksal uygulamaya nasıl ekleneceği gösterilmektedir.This article shows how to add the AS2 encoding and decoding actions to an existing logic app.

Önemli

Özgün AS2 Bağlayıcısı kullanımdan kalktı, bu nedenle bunun yerine AS2 (v2) bağlayıcısını kullandığınızdan emin olun.The original AS2 connector is going to be deprecated, so make sure that you use the AS2 (v2) connector instead. Bu sürüm özgün sürümle aynı özellikleri sağlar, Logic Apps çalışma zamanına göre yereldir ve aktarım hızı ve ileti boyutu açısından önemli performans iyileştirmeleri sağlar.This version provides the same capabilities as the original version, is native to the Logic Apps runtime, and provides significant performance improvements in terms of throughput and message size. Ayrıca, yerel v2 Bağlayıcısı tümleştirme hesabınıza bir bağlantı oluşturmanızı gerektirmez.Also, the native v2 connector doesn't require that you create a connection to your integration account. Bunun yerine, Önkoşullar bölümünde açıklandığı gibi, tümleştirme hesabınızı bağlayıcıyı kullanmayı planladığınız Logic App 'e bağladığınızdan emin olun.Instead, as described in the prerequisites, make sure that you link your integration account to the logic app where you plan to use the connector.

ÖnkoşullarPrerequisites

  • Azure aboneliği.An Azure subscription. Henüz bir Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.If you don't have an Azure subscription yet, sign up for a free Azure account.

  • AS2 bağlayıcısını kullanmak istediğiniz mantıksal uygulama ve mantıksal uygulamanızın iş akışını başlatan bir tetikleyici.The logic app from where you want to use the AS2 connector and a trigger that starts your logic app's workflow. AS2 Bağlayıcısı, Tetikleyiciler değil yalnızca eylemler sağlar.The AS2 connector provides only actions, not triggers. Logic Apps 'e yeni başladıysanız Azure Logic Apps ve hızlı başlangıç ' ı inceleyin: İlk mantıksal uygulamanızıoluşturun.If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app.

  • Azure aboneliğinizle ilişkili ve AS2 bağlayıcısını kullanmayı planladığınız mantıksal uygulamaya bağlı olan bir tümleştirme hesabı .An integration account that's associated with your Azure subscription and linked to the logic app where you plan to use the AS2 connector. Hem mantıksal uygulamanız hem de tümleştirme hesabınız aynı konumda veya Azure bölgesinde bulunmalıdır.Both your logic app and integration account must exist in the same location or Azure region.

  • AS2 Identity niteleyicisi kullanarak, tümleştirme hesabınızda zaten tanımlamış olduğunuz en az iki ticari iş ortağı .At least two trading partners that you've already defined in your integration account by using the AS2 identity qualifier.

  • AS2 bağlayıcısını kullanabilmeniz için, ticari iş ortaklarınız arasında bir AS2 sözleşmesi oluşturmanız ve bu sözleşmeyi tümleştirme hesabınızda depolamanız gerekir.Before you can use the AS2 connector, you must create an AS2 agreement between your trading partners and store that agreement in your integration account.

  • Sertifika yönetimi için Azure Key Vault kullanıyorsanız, kasa anahtarlarınızın şifreleme ve şifre çözme işlemlerine izin verdiğinden emin olun.If you use Azure Key Vault for certificate management, check that your vault keys permit the Encrypt and Decrypt operations. Aksi takdirde, kodlama ve kod çözme eylemleri başarısız olur.Otherwise, the encoding and decoding actions fail.

    Azure portal, anahtar kasanıza gidin, kasa anahtarınızın Izin verilen işlemlerinigörüntüleyin ve şifreleme ve şifre çözme işlemlerinin seçili olduğunu doğrulayın.In the Azure portal, go to your key vault, view your vault key's Permitted operations, and confirm that the Encrypt and Decrypt operations are selected.

    Kasa anahtarı işlemlerini denetleme

AS2 iletilerini kodlaEncode AS2 messages

  1. Henüz yapmadıysanız, Azure Portalmantıksal uygulama tasarımcısında mantıksal uygulamanızı açın.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. Tasarımcıda mantıksal uygulamanıza yeni bir eylem ekleyin.In the designer, add a new action to your logic app.

  3. Eylem Seç ' in altında, arama kutusu ' nun altında Tümü' nü seçin.Under Choose an action and the search box, select All. Arama kutusuna "AS2 encode" yazın ve AS2 (v2) eylemini seçtiğinizden emin olun: AS2 kodlamaIn the search box, enter "as2 encode", and make sure that you select the AS2 (v2) action: AS2 Encode

    "AS2 encode" öğesini seçin

  4. Şimdi şu özellikler için bilgi sağlayın:Now provide information for these properties:

    ÖzellikProperty AçıklamaDescription
    Kodlanacak iletiMessage to encode İleti yüküThe message payload
    AS2AS2 from AS2 anlaşmanız tarafından belirtilen şekilde ileti göndericisinin tanımlayıcısıThe identifier for the message sender as specified by your AS2 agreement
    AS2AS2 to İleti alıcısının AS2 anlaşmanız tarafından belirtilen tanımlayıcısıThe identifier for the message receiver as specified by your AS2 agreement

    Örneğin:For example:

    İleti kodlama özellikleri

AS2 iletilerinin kodunu çözmeDecode AS2 messages

  1. Henüz yapmadıysanız, Azure Portalmantıksal uygulama tasarımcısında mantıksal uygulamanızı açın.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. Tasarımcıda mantıksal uygulamanıza yeni bir eylem ekleyin.In the designer, add a new action to your logic app.

  3. Eylem Seç ' in altında, arama kutusu ' nun altında Tümü' nü seçin.Under Choose an action and the search box, select All. Arama kutusuna "AS2 kodunu çöz" yazın ve AS2 (v2) eylemini seçtiğinizden emin olun: AS2 kodunu çözIn the search box, enter "as2 decode", and make sure that you select the AS2 (v2) action: AS2 Decode

    "AS2 kodunu çöz" seçeneğini belirleyin

  4. Kodlanacak ileti ve ileti üstbilgileri özellikleri için önceki tetikleyiciden veya eylem çıktılarından bu değerleri seçin.For the Message to encode and the Message headers properties, select these values from previous trigger or action outputs.

    Örneğin, mantıksal uygulamanızın iletileri bir Istek tetikleyicisi aracılığıyla aldığını varsayalım.For example, suppose your logic app receives messages through a Request trigger. Bu tetikleyiciden gelen çıktıları seçebilirsiniz.You can select the outputs from that trigger.

    Istek çıktılarından gövde ve üst bilgi seçin

ÖrnekSample

Tam işletimsel bir mantıksal uygulamayı ve örnek AS2 senaryosunu dağıtmaya çalışmak için AS2 Logic App şablonu ve senaryosunabakın.To try deploying a fully operational logic app and sample AS2 scenario, see the AS2 logic app template and scenario.

Bağlayıcı başvurusuConnector reference

Bağlayıcının Openapı (eski adıyla Swagger) dosyasında açıklandığı gibi Tetikleyiciler, Eylemler ve sınırlar gibi teknik ayrıntılar için bağlayıcının başvuru sayfasınabakın.For technical details, such as triggers, actions, and limits, as described by the connector's OpenAPI (formerly Swagger) file, see the connector's reference page.

Sonraki adımlarNext steps

Enterprise Integration Pack hakkında daha fazla bilgi edininLearn more about the Enterprise Integration Pack