Échangez des messages AS2 à l’aide de flux de travail dans Azure Logic Apps
S’applique à : Azure Logic Apps (Consommation + Standard)
Pour envoyer et recevoir des messages AS2 dans les workflows que vous créez avec Azure Logic Apps, vous pouvez utiliser le connecteur AS2 (v2). Celui-ci fournit des actions qui prennent en charge et gèrent la communication AS2. Si vous avez besoin de fonctionnalités de suivi, la version d’origine du connecteur AS2 est toujours disponible, mais sera bientôt dépréciée.
À l’exception des fonctionnalités de suivi, le connecteur AS2 (v2) offre les mêmes fonctionnalités que la version d’origine du connecteur AS2. En outre, il exécute nativement le runtime Azure Logic Apps et comporte d’importantes améliorations au niveau de la taille des messages, du débit et de la latence. Contrairement au connecteur AS2 d’origine, le connecteur AS2 (v2) ne nécessite pas de créer une connexion à votre compte d’intégration. Comme indiqué dans les prérequis, assurez-vous plutôt de lier votre compte d’intégration à la ressource d’application logique dans laquelle vous envisagez d’utiliser le connecteur.
Ce guide pratique explique comment ajouter des actions d’encodage et de décodage AS2 à un workflow d’application logique existant. Le connecteur AS2 (v2) ne comprend pas de déclencheur. Vous pouvez donc utiliser n’importe quel déclencheur pour démarrer votre workflow. Les exemples de ce guide utilisent le déclencheur de Requête.
Référence technique du connecteur
Le connecteur AS2 a différentes versions, en fonction du type d’application logique et de l’environnement hôte.
| Application logique | Environnement | Version du connecteur |
|---|---|---|
| Consommation | Azure Logic Apps multilocataire | Connecteurs managés AS2 (v2) et AS2 (classe Standard). Le connecteur AS2 (v2) fournit uniquement des actions. Cependant, vous pouvez utiliser n’importe quel déclencheur qui convient à votre scénario. Pour plus d’informations, consultez la documentation suivante : - Documentation de référence du connecteur managé AS2 - Opérations du connecteur managé AS2 (v2) - Limites des messages AS2 |
| Consommation | Environnement de service d’intégration (ISE) | Connecteurs managés AS2 (v2) et AS2 (classe Standard) et AS2 version ISE, dont les limites de messages diffèrent de celles de la classe Standard. Le connecteur AS2 (v2) fournit uniquement des actions. Cependant, vous pouvez utiliser n’importe quel déclencheur qui convient à votre scénario. Pour plus d’informations, consultez la documentation suivante : - Documentation de référence du connecteur managé AS2 - Opérations du connecteur managé AS2 (v2) - Limites des messages AS2 |
| Standard | Azure Logic Apps monolocataire et App Service Environment v3 (plans Windows uniquement) | Connecteur intégré AS2 (v2) et connecteur managé AS2. La version intégrée diffère de la manière suivante : - La version intégrée fournit uniquement des actions. Cependant, vous pouvez utiliser n’importe quel déclencheur qui convient à votre scénario. - La version intégrée peut accéder directement aux réseaux virtuels Azure. Vous n’avez pas besoin d’une passerelle de données locale. Pour plus d’informations, consultez la documentation suivante : - Documentation de référence du connecteur managé AS2 - Opérations du connecteur intégré AS2 (v2) - Limites des messages AS2 |
Opérations AS2 (v2)
Le connecteur AS2 (v2) ne comprend pas de déclencheur. Le tableau suivant décrit les actions réalisées par le connecteur AS2 (v2) pour l’établissement de la sécurité et de la fiabilité lors de la transmission de messages :
| Action | Description |
|---|---|
| Action Encodage AS2 | Fournit le chiffrement, la signature numérique et les accusés de réception par le biais de notifications de destruction de messages (MDN), qui aident à prendre en charge la non-répudiation. Par exemple, cette action applique des en-têtes AS2/HTTP et effectue les tâches suivantes lors de la configuration : - Signer les messages sortants. - Chiffrer les messages sortants. - Compresser le message. - Transmettre le nom de fichier dans l’en-tête MIME. |
| Action Décodage AS2 | Fournit des fonctionnalités de déchiffrement, de signature numérique et d’accusés de réception par notification de réception du message (MDN). Par exemple, cette action effectue les tâches suivantes lors de la configuration : - Traiter les en-têtes AS2/HTTP. - Rapprocher les MDN reçues avec les messages sortants d’origine. - Mettre à jour et mettre en corrélation les enregistrements dans la base de données de non-répudiation. - Écrire des enregistrements pour les rapport d’état AS2. - Générer des contenus de charge utile codés en Base64. - Déterminer le caractère obligatoire des MDN. Selon le contrat AS2, déterminer si les MDN doivent être synchrones ou asynchrones. - Générer des MDN synchrones ou asynchrones en fonction du contrat AS2. - Définir des propriétés et des jetons de corrélation pour les MDN. - Vérifier la signature. - Déchiffrer les messages. - Décompresser les messages. - Vérifier et interdire les doublons d’ID de message. |
Prérequis
Un compte et un abonnement Azure. Si vous n’avez pas encore d’abonnement, vous pouvez vous inscrire pour obtenir un compte Azure gratuitement.
La ressource d’application logique et le flux de travail dans lesquels vous souhaitez utiliser les opérations AS2.
Une ressource de compte d'intégration pour définir et stocker les artefacts à utiliser dans des workflows d’intégration d’entreprise et B2B.
Votre compte d’intégration et votre ressource d’application logique doivent exister dans le même abonnement et la même région Azure.
Définit au moins deux partenaires commerciaux qui participent à l’opération AS2 utilisée dans votre workflow. Les définitions des deux partenaires doivent utiliser le même qualificateur d’identité d’entreprise, qui est AS2Identity, pour ce scénario.
Définit un accord AS2 entre les parties qui participent à votre workflow. Chaque contrat requiert un partenaire hôte et un partenaire invité. Le contenu des messages entre vous et l’autre partenaire doit correspondre au type de contrat. Pour plus d’informations sur les paramètres d’accord à utiliser lors de la réception et de l’envoi de messages, consultez Paramètres de messages AS2.
Selon que vous utilisez un workflow d’application logique Consommation ou Standard, vous aurez peut-être à lier votre ressource d’application logique à votre compte d’intégration :
Workflow d’application logique Liaison nécessaire ? Consommation - Connecteur AS2 (v2) : Connecter ion requise, mais aucun lien n’est requis
Connecteur - AS2 : liaison nécessaire, mais connexion non nécessaireStandard - Connecteur AS2 (v2) : liaison requise, mais aucune connexion n’est requise
Connecteur - AS2 : connexion nécessaire, mais liaison non nécessaireSi 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. Sinon, le codage et le décodage échouent.
Dans le portail Azure, ouvrez votre coffre de clés. Dans le menu de coffre de clés, sous Paramètres, sélectionnez Clés.
Dans le volet Clés, sélectionnez votre clé. Dans le volet Versions, sélectionnez la version de clé que vous utilisez.
Dans le volet Version de clé, sous Opérations autorisées, confirmez que les opérations Chiffrer et Déchiffrer sont sélectionnées, par exemple :
Encoder des messages AS2
Sélectionnez l’onglet du workflow d’application logique Consommation ou Standard :
Connecteur AS2 v2
Dans le portail Azure, ouvrez votre ressource d’application logique et votre flux de travail dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action AS2 (v2) nommée Encoder AS2 à votre workflow.
Dans la zone d’informations sur l’action, fournissez les informations suivantes :
Propriété Obligatoire Description Message à encoder Oui Par exemple, la charge utile du message, la sortie Corps du déclencheur Requête.
1. Placez votre curseur dans la zone Message à encoder pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez Corps.AS2 à partir de Oui Identificateur d’entreprise de l’expéditeur du message tel que spécifié par votre contrat AS2, par exemple, Fabrikam. AS2 vers Oui Identificateur d’entreprise du destinataire du message tel que spécifié par votre contrat AS2, par exemple, Contoso. 
Connecteur AS2
Dans le portail Azure, ouvrez votre ressource d’application logique et votre flux de travail dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action AS2 nommée Encoder vers message AS2 à votre workflow.
Lorsque vous êtes invité à créer une connexion à votre compte d’intégration, fournissez les informations suivantes :
Propriété Obligatoire Description Nom de connexion Oui Un nom pour la connexion Compte d’intégration Oui Dans la liste de comptes d’intégration disponibles, sélectionnez un compte à utiliser. Par exemple :
Sélectionnez Créer lorsque vous avez terminé.
Dans la zone d’informations sur l’action, fournissez les informations suivantes.
Propriété Obligatoire Description AS2-From Oui Identificateur d’entreprise de l’expéditeur du message tel que spécifié par votre contrat AS2, par exemple, Fabrikam. AS2-To Oui Identificateur d’entreprise du destinataire du message tel que spécifié par votre contrat AS2, par exemple, Contoso. body Oui Par exemple, la charge utile du message à encoder, la sortie Corps du déclencheur Requête.
1. Placez votre curseur dans la zone Corps pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez Corps.
Décoder des messages AS2
Sélectionnez l’onglet du workflow d’application logique Consommation ou Standard :
Connecteur AS2 v2
Dans le portail Azure, ouvrez votre ressource d’application logique et votre flux de travail dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action AS2 (v2) nommée Décoder AS2 à votre workflow.
Dans la zone d’informations sur l’action, fournissez les informations suivantes :
Propriété Obligatoire Description body Oui Par exemple, le corps du message à décoder, la sortie Corps du déclencheur Requête.
1. Placez votre curseur dans la zone Corps pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez Corps.En-têtes Oui Par exemple, les en-têtes du message à décoder, la sortie En-têtes du déclencheur Requête.
1. Placez votre curseur dans la zone En-têtes pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez En-têtes.Par exemple :
Connecteur AS2
Dans le portail Azure, ouvrez votre ressource d’application logique et votre flux de travail dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action AS2 nommée Décoder le message AS2 à votre workflow.
Lorsque vous êtes invité à créer une connexion à votre compte d’intégration, fournissez les informations suivantes :
Propriété Obligatoire Description Nom de connexion Oui Un nom pour la connexion Compte d’intégration Oui Dans la liste de comptes d’intégration disponibles, sélectionnez un compte à utiliser. Par exemple :
Sélectionnez Créer lorsque vous avez terminé.
Dans la zone d’informations sur l’action, fournissez les informations suivantes.
Propriété Obligatoire Description body Oui Par exemple, la charge utile du message, la sortie Corps du déclencheur Requête.
1. Placez votre curseur dans la zone Corps pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez Corps.En-têtes Oui Par exemple, les en-têtes du message à décoder, la sortie En-têtes du déclencheur Requête.
1. Placez votre curseur dans la zone En-têtes pour ouvrir la liste de contenus dynamiques.
2. En regard du nom de la section Lors de la réception d’une demande HTTP, sélectionnez Voir plus.
3. Dans la liste des sorties, sélectionnez En-têtes.
Exemple
Pour déployer une application logique totalement opérationnelle dans le cadre d’un exemple de scénario AS2 (v2), consultez le scénario et le modèle d’application logique AS2 (v2).
Résoudre les problèmes
Problèmes lors de l’envoi de messages signés ou chiffrés
Essayez différents formats d’algorithmes SHA256. Comme la spécification AS2 ne fournit pas d’informations sur les formats SHA256, chaque fournisseur utilise sa propre implémentation ou son propre format.