Intercambio de mensajes AS2 para la integración empresarial B2B en Azure Logic Apps con Enterprise Integration PackExchange AS2 messages for B2B enterprise integration in Azure Logic Apps with Enterprise Integration Pack

Importante

El conector AS2 original está en desuso, por lo que, a menos que necesite funcionalidades de seguimiento, use mejor el conector AS2 (v2) .The original AS2 connector is being deprecated, so unless you need tracking capabilities, use the AS2 (v2) connector instead. Excepto seguimiento, el conector v2 proporciona las mismas funcionalidades que la versión original, es nativo del entorno de ejecución de Logic Apps y presenta importantes mejoras de rendimiento en cuanto al tamaño de los mensajes, la capacidad de proceso y la latencia.Except for tracking, the v2 connector provides the same capabilities as the original version, is native to the Logic Apps runtime, and has significant performance improvements in message size, throughput, and latency. Además, el conector v2 no requiere la creación de una conexión a la cuenta de integración.Also, the v2 connector doesn't require that you create a connection to your integration account. En su lugar, tal y como se describe en los requisitos previos, asegúrese de vincular la cuenta de integración a la aplicación lógica donde planea usar el conector.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.

Para trabajar con mensajes AS2 en Azure Logic Apps, puede usar el conector AS2, que proporciona los desencadenadores y acciones que admiten y administran las comunicaciones AS2 (versión 1.2).To work with AS2 messages in Azure Logic Apps, you can use the AS2 connector, which provides triggers and actions that support and manage AS2 (version 1.2) communication. Por ejemplo, para garantizar la seguridad y confiabilidad al transmitir mensajes, puede utilizar estas acciones:For example, to establish security and reliability when transmitting messages, you can use these actions:

  • La acción Codificar con AS2 para proporcionar firmas digitales, cifrado y confirmaciones mediante las notificaciones de disposición del mensaje (MDN), lo que ayuda a admitir la recepción sin rechazo.AS2 Encode action for providing encryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN), which help support non-repudiation. Por ejemplo, esta acción se aplica a los encabezados AS2/HTTP y realiza estas tareas cuando se configura:For example, this action applies AS2/HTTP headers and performs these tasks when configured:

    • Firma los mensajes salientes.Signs outgoing messages.
    • Cifra los mensajes salientes.Encrypts outgoing messages.
    • Comprime el mensaje.Compresses the message.
    • Transmite el nombre de archivo en el encabezado MIME.Transmits the file name in the MIME header.
  • La acción Descodificar con AS2 para proporcionar firmas digitales, descifrado y confirmaciones a través de las notificaciones de disposición de mensajes (MDN).AS2 Decode action for providing decryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN). Por ejemplo, esta acción lleva a cabo estas tareas:For example, this action performs these tasks:

    • Procesa los encabezados AS2/HTTP.Processes AS2/HTTP headers.
    • Reconcilia los MDN recibidos con los mensajes de salida originales.Reconciles received MDNs with the original outbound messages.
    • Actualiza y correlaciona registros en la base de datos sin rechazo.Updates and correlates records in the non-repudiation database.
    • Escribe registros para los informes de estado de AS2.Writes records for AS2 status reporting.
    • Devuelve el contenido de la carga útil con codificación base64.Outputs payload contents as base64-encoded.
    • Determina si el MDN es necesario.Determines whether MDNs are required. En función del contrato AS2, determina si el MDN deben ser sincrónico o asincrónico.Based on the AS2 agreement, determines whether MDNs should be synchronous or asynchronous.
    • Genera el MDN sincrónico o asincrónico según el contrato AS2.Generates synchronous or asynchronous MDNs based on the AS2 agreement.
    • Establece las propiedades y los token de correlación en los MDN.Sets the correlation tokens and properties on MDNs.

    Esta acción también realiza estas tareas cuando se configura:This action also performs these tasks when configured:

    • Comprueba la firma.Verifies the signature.
    • Descifra los mensajes.Decrypts the messages.
    • Descomprime el mensaje.Decompresses the message.
    • Comprueba y prohíbe duplicados de identificador de mensaje.Check and disallow message ID duplicates.

En este artículo se muestra cómo agregar la codificación AS2 y las acciones de descodificación a una aplicación lógica existente.This article shows how to add the AS2 encoding and decoding actions to an existing logic app.

PrerrequisitosPrerequisites

  • Suscripción a Azure.An Azure subscription. Si aún no tiene ninguna suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.If you don't have an Azure subscription yet, sign up for a free Azure account.

  • La aplicación lógica desde la que quiere usar el conector AS2 y un desencadenador que inicie el flujo de trabajo de la aplicación lógica.The logic app from where you want to use the AS2 connector and a trigger that starts your logic app's workflow. El conector AS2 proporciona únicamente las acciones, no los desencadenadores.The AS2 connector provides only actions, not triggers. Si no está familiarizado con las aplicaciones lógicas, consulte ¿Qué es Azure Logic Apps? e Inicio rápido: Creación de la primera aplicación lógica.If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app.

  • Una cuenta de integración asociada con la suscripción a Azure y vinculada a las aplicaciones lógicas en las que planea usar el conector 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. Tanto la cuenta de integración como la aplicación de lógica deben existir en la misma ubicación o región de Azure.Both your logic app and integration account must exist in the same location or Azure region.

  • Al menos dos entidades que ya haya creado en su cuenta de integración mediante el calificador de identidad AS2.At least two trading partners that you've already defined in your integration account by using the AS2 identity qualifier.

  • Para poder usar el conector AS2, debe crear un contrato AS2 entre las entidades y almacenarlo en la cuenta de integración.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 usa Azure Key Vault para la administración de certificados, compruebe que las claves de almacén permitan las operaciones Cifrar y Descifrar.If you use Azure Key Vault for certificate management, check that your vault keys permit the Encrypt and Decrypt operations. En caso contrario, las acciones de codificación y descodificación producirán un error.Otherwise, the encoding and decoding actions fail.

    En Azure Portal, vaya a la clave en el almacén de claves, consulte las operaciones permitidas de esta y confirme que las operaciones Cifrar y Descifrar están seleccionadas, por ejemplo:In the Azure portal, go to the key in your key vault, review your key's Permitted operations, and confirm that the Encrypt and Decrypt operations are selected, for example:

    Comprobar las operaciones con claves de almacén

Codificación de mensajes AS2Encode AS2 messages

  1. Si aún no lo ha hecho, en Azure Portal, abra la aplicación lógica en el Diseñador de aplicación lógica.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. En el diseñador, agregue una nueva acción a la aplicación lógica.In the designer, add a new action to your logic app.

  3. En Elegir una acción y en el cuadro de búsqueda, seleccione Todas.Under Choose an action and the search box, select All. En el cuadro de búsqueda, escriba "codificación con AS2" y asegúrese de que selecciona la acción AS2 (v2): Codificación con AS2In the search box, enter "as2 encode", and make sure that you select the AS2 (v2) action: AS2 Encode

    Seleccionar "Codificación con AS2"

  4. Ahora, proporcione la información de las siguientes propiedades:Now provide information for these properties:

    PropiedadProperty DescripciónDescription
    Mensaje que se codificaráMessage to encode Carga útil del mensaje.The message payload
    AS2 desdeAS2 from Identificador del remitente del mensaje según lo especificado por su contrato AS2.The identifier for the message sender as specified by your AS2 agreement
    AS2 hastaAS2 to Identificador del receptor del mensaje según lo especificado por su contrato AS2.The identifier for the message receiver as specified by your AS2 agreement

    Por ejemplo:For example:

    Propiedades de codificación del mensaje.

Sugerencia

Si experimenta problemas al enviar mensajes firmados o cifrados, considere la posibilidad de probar distintos formatos de algoritmo SHA256.If you experience problems when sending signed or encrypted messages, consider trying different SHA256 algorithm formats. La especificación AS2 no proporciona ninguna información sobre los formatos SHA256, por lo que cada proveedor usa su propia implementación o formato.The AS2 specification doesn't provide any information about SHA256 formats, so each provider uses their own implementation or format.

Descodificación de mensajes AS2Decode AS2 messages

  1. Si aún no lo ha hecho, en Azure Portal, abra la aplicación lógica en el Diseñador de aplicación lógica.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. En el diseñador, agregue una nueva acción a la aplicación lógica.In the designer, add a new action to your logic app.

  3. En Elegir una acción y en el cuadro de búsqueda, seleccione Todas.Under Choose an action and the search box, select All. En el cuadro de búsqueda, escriba "descodificación con AS2" y asegúrese de que selecciona la acción AS2 (v2): Descodificación con AS2In the search box, enter "as2 decode", and make sure that you select the AS2 (v2) action: AS2 Decode

    Seleccionar "Descodificación con AS2"

  4. En las propiedades Mensaje que se codificará y Encabezados del mensaje, seleccione estos valores de las salidas anteriores del desencadenador o acción.For the Message to encode and the Message headers properties, select these values from previous trigger or action outputs.

    Por ejemplo, suponga que la aplicación lógica recibe mensajes a través de un desencadenador de solicitud.For example, suppose your logic app receives messages through a Request trigger. Puede seleccionar las salidas de ese desencadenador.You can select the outputs from that trigger.

    Seleccione el cuerpo y los encabezados de las salidas de la solicitud

MuestraSample

Para intentar implementar una aplicación lógica totalmente operativa y conocer el escenario de ejemplo de AS2, consulte el artículo sobre escenario y plantilla de aplicaciones lógicas de AS2.To try deploying a fully operational logic app and sample AS2 scenario, see the AS2 logic app template and scenario.

Referencia de conectoresConnector reference

Si necesita más detalles técnicos sobre este conector, como las acciones y los límites que se describen en el archivo de Swagger del conector, consulte la página de referencia del conector.For more technical details about this connector, such as actions and limits as described by the connector's Swagger file, see the connector's reference page.

Nota

En el caso de las aplicaciones lógicas de un entorno de servicio de integración (ISE), la versión con la etiqueta ISE de este conector usa los límites de mensajes B2B del ISE.For logic apps in an integration service environment (ISE), this connector's ISE-labeled version uses the B2B message limits for ISE.

Pasos siguientesNext steps