Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Enviar y recibir mensajes AS2

En esta sección se describen los procesos para enviar y recibir mensajes AS2. También proporciona detalles sobre los nombres de archivo y las ubicaciones asociadas a los mensajes AS2.

En la tabla siguiente se enumeran los algoritmos de cifrado disponibles para los mensajes AS2 y cuándo se pueden usar.

Proceso de recepción de mensajes AS2

El proceso entrante se define como un mensaje o archivo que se transfiere a su AWS Transfer Family servidor. La secuencia de los mensajes entrantes es la siguiente:

Enviar y recibir mensajes de AS2 a través de HTTPS

En esta sección, se describe cómo configurar un servidor Transfer Family que utiliza el protocolo AS2 para enviar y recibir mensajes a través de HTTPS.

Enviar mensajes de AS2 a través de HTTPS

Para enviar mensajes de AS2 mediante HTTPS, cree un conector con la siguiente información:

Recibir mensajes de AS2 a través de HTTPS

AWS Transfer Family Actualmente, los servidores AS2 solo proporcionan transporte HTTP a través del puerto 5080. Sin embargo, puedes cancelar el TLS en un balanceador de cargas de red o de aplicaciones situado frente al punto de conexión de la VPC de tu servidor de Transfer Family mediante el puerto y el certificado que elijas. Con este método, puede hacer que los mensajes de AS2 entrantes utilicen HTTPS.

Requisitos previos

Puede configurar un equilibrio de carga de red (NLB) o un balanceador de carga de aplicaciones (ALB). En la tabla siguiente se enumeran las ventajas y desventajas de cada enfoque.

La siguiente tabla muestra las diferencias en las capacidades cuando se usa un NLB frente a un ALB para terminar TLS.

Configure NLB

Este procedimiento describe cómo configurar un balanceador de carga de red (NLB) con conexión a Internet en su VPC.

Creación de un equilibrador de carga de red y definición del punto de conexión de VPC del servidor como destino del equilibrador de carga

1. Abra la consola de Amazon Elastic Compute Cloud en. https://console.aws.amazon.com/ec2/

2. En el panel de navegación, elija Equilibradores de carga y, a continuación, elija Crear equilibrador de carga.

3. En equilibrador de carga de red, seleccione Crear.

4. En la sección Configuración básica, introduzca la siguiente información:

   • En Nombre, escriba el nombre del equilibrador de carga.

   • Para Scheme, elija Internet-facing.

   • En Tipo de dirección IP, elija ipv4.

5. En la sección Asignaciones de red, escriba la siguiente información:

   • En VPC, elija la nube privada virtual (VPC) que haya creado.

   • En Asignaciones, elija las zonas de disponibilidad asociadas a las subredes públicas que están disponibles en la misma VPC que utiliza con los puntos de conexión del servidor.

   • Para la dirección IPv4 de cada subred, elija una de las direcciones IP elásticas que haya asignado.

6. En la sección Oyentes y rutas, escriba la siguiente información:

   • En Protocol, elija TLS.

   • En Puerto, escriba 5080.

   • En Acción predeterminada, elija Crear grupo objetivo. Para obtener información detallada sobre la creación de un nuevo grupo objetivo, consulte Creación de un grupo de destino.

   Tras crear un grupo objetivo, introduzca su nombre en el campo Acción predeterminada.

7. En la sección Configuración de Secure Listener, elija su certificado en el área de SSL/TLS certificado predeterminado.

8. Elija Crear un equilibrador de carga para crear el equilibrador de carga de red.

9. (Opcional, pero recomendado) Active los registros de acceso del equilibrador de carga de red para mantener un registro de auditoría completo, tal y como se describe en los registros de acceso del equilibrador de carga de red.

   Recomendamos este paso porque la conexión TLS finaliza en el NLB. Por lo tanto, la dirección IP de origen que se refleja en tus grupos de CloudWatch registro AS2 de Transfer Family es la dirección IP privada del NLB, en lugar de la dirección IP externa de tu socio comercial.

Configure ALB

Este procedimiento describe cómo configurar un balanceador de carga de aplicaciones (ALB) en su VPC.

Para crear un balanceador de carga de aplicaciones y definir el punto final de la VPC del servidor como el destino del balanceador de carga

1. Abra la consola de Amazon Elastic Compute Cloud en. https://console.aws.amazon.com/ec2/

2. En el panel de navegación, elija Equilibradores de carga y, a continuación, elija Crear equilibrador de carga.

3. En Equilibrador de carga de aplicación, elija Create (Crear).

4. En la consola ALB, cree un nuevo oyente HTTP en el puerto 443 (HTTPS).

5. (Opcional). Si desea configurar la autenticación mutua (mTLS), configure los ajustes de seguridad y un almacén de confianza.

   1. Adjunte su SSL/TLS certificado al oyente.

   2. En Gestión de certificados de clientes, selecciona Autenticación mutua (mTLS).

   3. Elige Verificar con un almacén de confianza.

   4. En Configuración avanzada de mTLS, elige o crea un almacén de confianza cargando tus certificados de CA.

6. Cree un nuevo grupo de destino y añada las direcciones IP privadas de los puntos finales de su servidor AS2 de Transfer Family como destinos en el puerto 5080. Para obtener información detallada sobre la creación de un nuevo grupo objetivo, consulte Creación de un grupo de destino.

7. Configure las comprobaciones de estado para que el grupo objetivo utilice el protocolo HTTP en el puerto 5080.

8. Cree una nueva regla para reenviar el tráfico HTTPS del oyente al grupo de destino.

9. Configure el oyente para que use su certificado. SSL/TLS

Tras configurar el equilibrador de carga, los clientes se comunican con el equilibrador de carga a través del receptor de puertos personalizado. A continuación, el equilibrador de carga se comunica con el servidor a través del puerto 5080.

Prueba del acceso al servidor desde una dirección IP elástica

Conéctese al servidor a través del puerto personalizado mediante una dirección IP elástica o el nombre DNS del equilibrador de carga de red.

Transferencia de archivos mediante un conector AS2

Los conectores AS2 establecen una relación entre los socios comerciales para las transferencias de mensajes de AS2 desde un servidor Transfer Family a un destino externo propiedad del socio.

Puede usar Transfer Family para enviar mensajes AS2 haciendo referencia al ID del conector y a las rutas de acceso a los archivos, como se muestra en el siguiente comando (): start-file-transfer AWS Command Line Interface AWS CLI

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/amzn-s3-demo-source-bucket/myfile1.txt" "/amzn-s3-demo-source-bucket/myfile2.txt"

Para obtener los detalles de los conectores, ejecute el siguiente comando:

aws transfer list-connectors

El comando list-connectors devuelve los ID de los conectores, las URL y los nombres de recursos de Amazon (ARN) de los conectores.

Para devolver las propiedades de un conector concreto, ejecute el siguiente comando con el ID que desee usar:

aws transfer describe-connector --connector-id your-connector-id

El comando describe-connector devuelve todas las propiedades del conector, incluidas la URL, los roles, los perfiles, los avisos de disposición de mensajes (MDNs), las etiquetas y las métricas de supervisión.

Para confirmar que el socio recibió correctamente los archivos, consulte los archivos JSON y MDN. Estos archivos se nombran de acuerdo con las convenciones descritas en Nombres y ubicaciones de los archivos. Si configuró una función de registro al crear el conector, también puede comprobar el estado de los mensajes de AS2 en sus CloudWatch registros.

Para ver los detalles del conector AS2, consulte Visualización de los detalles del conector AS2. Para obtener más información acerca de cómo crear un conector AS2, consulte Configure los conectores AS2.

El procesamiento AS2 admite muchos de los protocolos RFC 4130, y se centra en los casos de uso comunes y en la integración con las implementaciones de servidores existentes. AS2-enabled Para más información sobre las configuraciones compatibles, consulte Configuraciones AS2.

Nombres y ubicaciones de los archivos

En esta sección, se analizan las convenciones de nomenclatura de archivos para las transferencias de AS2.

En cuanto a las transferencias de archivos entrantes, tenga en cuenta lo siguiente:

En el caso de las transferencias salientes, el nombre es similar, con la diferencia de que no hay ningún archivo de mensajes entrantes y, además, el identificador de transferencia del mensaje transferido se añade al nombre del archivo. La operación de la StartFileTransfer API devuelve el identificador de transferencia (o cuando otro proceso o script llama a esta operación).

También puedes consultar los CloudWatch registros para ver los detalles de tus transferencias, incluidas las que hayan fallado.

Códigos de estado

En la siguiente tabla se enumeran todos los códigos de estado que se pueden registrar en los CloudWatch registros cuando tú o tu pareja enviáis un mensaje AS2. Los diferentes pasos de procesamiento de mensajes se aplican a los diferentes tipos de mensajes y están destinados únicamente a la supervisión. Los estados COMPLETADO y FALLIDO representan el paso final del procesamiento y están visibles en los archivos JSON.

Ejemplos de archivos de JSON

En esta sección, se enumeran los archivos JSON de muestra para las transferencias entrantes y salientes, incluidos los archivos de muestra para las transferencias correctas y las transferencias que no se realizan correctamente.

Ejemplo de archivo saliente que se transfirió correctamente:

{
  "requester-content-type": "application/octet-stream",
  "message-subject": "File xyzTest from MyCompany_OID to partner YourCompany",
  "requester-file-name": "TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-from": "MyCompany_OID",
  "connector-id": "c-c21c63ceaaf34d99b",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 3198,
  "mdn-message-id": "OPENAS2-11072022063009+0000-df865189-1450-435b-9b8d-d8bc0cee97fd@PartnerA_OID_MyCompany_OID",
  "mdn-subject": "Message be18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa has been accepted",
  "as2-to": "PartnerA_OID",
  "transfer-id": "dedf4601-4e90-4043-b16b-579af35e0d83",
  "file-path": "/amzn-s3-demo-bucket/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

Ejemplo de archivo saliente que se transfirió sin éxito:

{
  "failure-code": "HTTP_ERROR_RESPONSE_FROM_PARTNER",
  "status-code": "FAILED",
  "requester-content-type": "application/octet-stream",
  "subject": "Test run from Id da86e74d6e57464aae1a55b8596bad0a to partner 9f8474d7714e476e8a46ce8c93a48c6c",
  "transfer-size": 3198,
  "requester-file-name": "openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "as2-message-id": "9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "failure-message": "http://Test123456789.us-east-1.elb.amazonaws.com:10080 returned status 500 for message with ID 9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "transfer-id": "07bd3e07-a652-4cc6-9412-73ffdb97ab92",
  "connector-id": "c-056e15cc851f4b2e9",
  "file-path": "/amzn-s3-demo-bucket-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

Ejemplo de archivo entrante que se ha transferido correctamente:

{
  "requester-content-type": "application/EDI-X12",
  "subject": "File openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat sent from MyCompany to PartnerA",
  "client-ip": "10.0.109.105",
  "requester-file-name": "openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat",
  "as2-from": "MyCompany_OID",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 1050,
  "mdn-subject": "Message Disposition Notification",
  "as2-message-id": "OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID",
  "as2-to": "PartnerA_OID",
  "agreement-id": "a-f5c5cbea5f7741988",
  "file-path": "processed/openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID.dat",
  "server-id": "s-5f7422b04c2447ef9",
  "timestamp": "2022-07-11T23:36:36.105030Z"
}

Ejemplo de archivo entrante que se transfirió sin éxito:

{
  "failure-code": "INVALID_REQUEST",
  "status-code": "FAILED",
  "subject": "Sending a request from InboundHttpClientTests",
  "client-ip": "10.0.117.27",
  "as2-message-id": "testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "as2-to": "0beff6af56c548f28b0e78841dce44f9",
  "failure-message": "Unsupported date format: 2022/123/456T",
  "agreement-id": "a-0ceec8ca0a3348d6a",
  "as2-from": "ab91a398aed0422d9dd1362710213880",
  "file-path": "failed/01187f15-523c-43ac-9fd6-51b5ad2b08f3.testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "server-id": "s-0582af12e44540b9b",
  "timestamp": "2022-07-11T06:30:03.662939Z"
}