Échanger des messages AS2 dans le cadre d’une intégration d’entreprise B2B dans Azure Logic Apps avec Enterprise Integration PackExchange AS2 messages for B2B enterprise integration in Azure Logic Apps with Enterprise Integration Pack

Pour utiliser des messages AS2 dans Azure Logic Apps, vous pouvez vous servir du connecteur AS2, qui fournit des déclencheurs et des actions pour la gestion de la communication AS2.To work with AS2 messages in Azure Logic Apps, you can use the AS2 connector, which provides triggers and actions for managing AS2 communication. Par exemple, pour garantir la sécurité et la fiabilité lors de la transmission des messages, vous pouvez utiliser ces actions :For example, to establish security and reliability when transmitting messages, you can use these actions:

  • Action Encodage AS2 pour fournir les fonctionnalités de chiffrement, de signature numérique et d’accusés de réception par notification de réception du message (MDN), ce qui renforce la non-répudiation.AS2 Encode action for providing encryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN), which help support non-repudiation. Par exemple, cette action applique des en-têtes AS2/HTTP et effectue les tâches suivantes lorsqu’elles sont configurées :For example, this action applies AS2/HTTP headers and performs these tasks when configured:

    • Signature des messages sortants.Signs outgoing messages.
    • Chiffrement des messages sortants.Encrypts outgoing messages.
    • Compression du message.Compresses the message.
    • Transmission du nom de fichier dans l’en-tête MIME.Transmits the file name in the MIME header.
  • Action Décodage AS2 pour fournir les fonctionnalités de déchiffrement, de signature numérique et d’accusés de réception par notification de réception du message (MDN).AS2 Decode action for providing decryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN). Par exemple, cette action effectue les tâches suivantes :For example, this action performs these tasks:

    • Traitement des en-têtes AS2/HTTP.Processes AS2/HTTP headers.
    • Rapprochement des MDN reçues avec le message sortant d’origine.Reconciles received MDNs with the original outbound messages.
    • Mise à jour et mise en corrélation les enregistrements dans la base de données de non-répudiation.Updates and correlates records in the non-repudiation database.
    • Écriture des enregistrements pour le rapport d’état AS2.Writes records for AS2 status reporting.
    • Génération des contenus de charge codés en base64.Outputs payload contents as base64-encoded.
    • Détermination du caractère obligatoire des MDN.Determines whether MDNs are required. Selon le contrat AS2, détermination du caractère synchrone ou asynchrone des MDN.Based on the AS2 agreement, determines whether MDNs should be synchronous or asynchronous.
    • Génération des MDN synchrones ou asynchrones en fonction du contrat AS2.Generates synchronous or asynchronous MDNs based on the AS2 agreement.
    • Définition des propriétés et des jetons de corrélation sur les MDN.Sets the correlation tokens and properties on MDNs.

    Cette action effectue également les tâches suivantes lorsqu’elles sont configurées :This action also performs these tasks when configured:

    • Vérification de la signature.Verifies the signature.
    • Déchiffrement des messages.Decrypts the messages.
    • Décompression du message.Decompresses the message.
    • Vérification et interdiction des doublons d’ID de message.Check and disallow message ID duplicates.

Cet article explique comment ajouter des actions de codage et de décodage AS2 à une application logique existante.This article shows how to add the AS2 encoding and decoding actions to an existing logic app.

Important

Il est déconseillé d’utiliser le connecteur AS2 d’origine.Asurez-vous donc d’utiliser le connecteur AS2 (v2) .The original AS2 connector is going to be deprecated, so make sure that you use the AS2 (v2) connector instead. Cette version offre les mêmes fonctionnalités que la version d’origine, est native au runtime Logic Apps et apporte d’importantes améliorations des performances en ce qui concerne le débit et de taille des messages.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. De plus, le connecteur v2 natif ne nécessite pas la création d’une connexion à votre compte d’intégration.Also, the native v2 connector doesn't require that you create a connection to your integration account. Comme indiqué dans les prérequis; assurez-vous plutôt de lier votre compte d’intégration à l’application logique dans laquelle vous envisagez d’utiliser le connecteur.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.

Conditions préalables requisesPrerequisites

  • Un abonnement Azure.An Azure subscription. Si vous n’avez pas encore d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.If you don't have an Azure subscription yet, sign up for a free Azure account.

  • L’application logique à partir de laquelle vous souhaitez utiliser le connecteur AS2 et un déclencheur qui démarre le flux de travail de votre application logique.The logic app from where you want to use the AS2 connector and a trigger that starts your logic app's workflow. Le connecteur AS2 fournit uniquement des actions, pas des déclencheurs.The AS2 connector provides only actions, not triggers. Si vous débutez avec les applications logiques, consultez Qu’est-ce qu’Azure Logic Apps ? et Démarrage rapide : Créer votre première application logique.If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app.

  • Un compte d’intégration associé à votre abonnement Azure et lié à l’application logique dans laquelle vous prévoyez d’utiliser le connecteur AS2.An integration account that's associated with your Azure subscription and linked to the logic app where you plan to use the AS2 connector. Votre application logique et votre compte d’intégration doivent tous deux exister dans le même emplacement ou dans la même région Azure.Both your logic app and integration account must exist in the same location or Azure region.

  • Au moins deux partenaires commerciaux déjà définis dans votre compte d’intégration à l’aide du qualificateur d’identité AS2.At least two trading partners that you've already defined in your integration account by using the AS2 identity qualifier.

  • Pour pouvoir utiliser le connecteur AS2, vous devez créer un contrat AS2 entre vos partenaires commerciaux et le stocker dans votre compte d’intégration.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.

  • Si vous utilisez Azure Key Vault pour la gestion des certificats, vérifiez que les clés de coffre autorisent les opérations Chiffrer et Déchiffrer.If you use Azure Key Vault for certificate management, check that your vault keys permit the Encrypt and Decrypt operations. Sinon, le codage et le décodage échouent.Otherwise, the encoding and decoding actions fail.

    Dans le portail Azure, accédez à votre coffre de clés, affichez les opérations autorisées sur les clés du coffre et vérifiez que les actions Chiffrer et Déchiffrer sont sélectionnées.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.

    Vérifier les opérations sur les clés de coffre

Encoder des messages AS2Encode AS2 messages

  1. Si ce n’est déjà fait, dans le Portail Microsoft Azure, ouvrez votre application logique dans le Concepteur d’application logique.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. Dans le concepteur, ajoutez une nouvelle action à votre application logique.In the designer, add a new action to your logic app.

  3. Sous Choisir une action et la zone de recherche, sélectionnez Tous.Under Choose an action and the search box, select All. Dans la zone de recherche, entrez « encodage AS2 » et assurez-vous de sélectionner l’action AS2 (v2) : Encodage AS2In the search box, enter "as2 encode", and make sure that you select the AS2 (v2) action: AS2 Encode

    Sélectionnez « encodage AS2 »

  4. Maintenant, fournissez des informations pour les propriétés suivantes :Now provide information for these properties:

    PropriétéProperty DescriptionDescription
    Message à encoderMessage to encode Charge utile du messageThe message payload
    AS2 à partir deAS2 from Identificateur de l’expéditeur du message tel que spécifié par votre contrat AS2The identifier for the message sender as specified by your AS2 agreement
    AS2 versAS2 to Identificateur du destinataire du message tel que spécifié par votre contrat AS2The identifier for the message receiver as specified by your AS2 agreement

    Par exemple :For example:

    Propriétés de codage de message

Décoder des messages AS2Decode AS2 messages

  1. Si ce n’est déjà fait, dans le Portail Microsoft Azure, ouvrez votre application logique dans le Concepteur d’application logique.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. Dans le concepteur, ajoutez une nouvelle action à votre application logique.In the designer, add a new action to your logic app.

  3. Sous Choisir une action et la zone de recherche, sélectionnez Tous.Under Choose an action and the search box, select All. Dans la zone de recherche, entrez « décodage AS2 » et assurez-vous de sélectionner l’action AS2 (v2) : Décodage AS2In the search box, enter "as2 decode", and make sure that you select the AS2 (v2) action: AS2 Decode

    Sélectionnez « décodage AS2 »

  4. Pour les propriétés du Message à encoder et les En-têtes de message, sélectionnez ces valeurs à partir de sorties de déclencheur ou d’action précédentes.For the Message to encode and the Message headers properties, select these values from previous trigger or action outputs.

    Par exemple, supposons que votre application logique reçoive des messages via un déclencheur de requête.For example, suppose your logic app receives messages through a Request trigger. Vous pouvez sélectionner les sorties de ce déclencheur.You can select the outputs from that trigger.

    Sélectionnez le corps et les en-têtes à partir des sorties de requête.

ExempleSample

Pour déployer une application logique totalement opérationnelle dans le cadre d’un exemple de scénario AS2, consultez le scénario et le modèle d’application logique AS2.To try deploying a fully operational logic app and sample AS2 scenario, see the AS2 logic app template and scenario.

Référence de connecteurConnector reference

Pour plus d’informations techniques, notamment sur les déclencheurs, les actions et les limites, comme décrit dans le fichier OpenAPI (anciennement Swagger) du connecteur, voir la page de référence du connecteur.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.

Étapes suivantesNext steps

En savoir plus sur Enterprise Integration PackLearn more about the Enterprise Integration Pack