Personaliza los encabezados HTTP de los mensajes AS2 - AWS Transfer Family
Descripción general de la plantillaCómo funcionaCaracterísticas principales de Detalles de la implementaciónDespliegue y uso

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.

Personaliza los encabezados HTTP de los mensajes AS2

Al enviar AS2 mensajes a socios comerciales, es posible que necesite personalizar los encabezados HTTP para cumplir requisitos específicos o mejorar la compatibilidad con la configuración del AS2 servidor de su socio. Esta AWS CloudFormation plantilla crea una infraestructura que permite personalizar los encabezados HTTP de los AS2 mensajes enviados. AWS Transfer Family Configura una función de Amazon API Gateway y Lambda para que actúen como proxy, lo que permite la modificación dinámica de los encabezados requeridos por los servidores de los socios comerciales. AS2

Utilice esta plantilla para hacer lo siguiente:

  • Agregue encabezados HTTP personalizados a los mensajes salientes AS2

  • Reemplace los valores de encabezado predeterminados con valores personalizados

    importante

    Tenga cuidado al anular los valores de encabezado predeterminados, ya que puede provocar errores de envío: algunos AS2 encabezados son obligatorios.

  • Garantice la compatibilidad con los socios comerciales que tienen requisitos de encabezado específicos

Descripción general de la plantilla

La plantilla crea los siguientes componentes principales:

  • Función Lambda que procesa y reenvía mensajes AS2

  • Una Amazon API Gateway para exponer la función Lambda

  • Funciones y permisos de IAM para la función Lambda

  • Recursos condicionales para la compatibilidad con HTTPS

El archivo de plantilla está disponible aquí: Plantilla de encabezados HTTP dinámicos.

Cómo funciona

  1. Amazon API Gateway recibe los AS2 mensajes entrantes de AWS Transfer Family.

  2. La solicitud se reenvía a la función Lambda.

  3. La función Lambda procesa la solicitud, añadiendo o modificando encabezados según sea necesario.

  4. A continuación, la solicitud modificada se reenvía al servidor del AS2 socio.

  5. La respuesta del servidor del socio se devuelve a través de Lambda y Amazon API Gateway a. AWS Transfer Family

Características principales de

  • Modificación dinámica del encabezado: permite personalizar el encabezado del asunto y añadir otros encabezados necesarios.

  • Soporte de protocolos: funciona con los protocolos HTTP y HTTPS.

  • Configuración flexible: permite especificar el host, el puerto y la ruta del socio.

Detalles de la implementación

La plantilla implementa los siguientes componentes clave:

Función Lambda

El núcleo de la solución es una función Lambda de Node.js que:

  • Recibe solicitudes de Amazon API Gateway

  • Modifica los encabezados en función de la configuración y los datos de las solicitudes entrantes

  • Reenvía la solicitud modificada al servidor del socio AS2

  • Maneja los protocolos HTTP y HTTPS

  • Incluye la gestión y el registro de errores

Amazon API Gateway

Una API HTTP está configurada para:

  • Recibir AS2 mensajes entrantes

  • Enrutar las solicitudes a la función Lambda

  • Devuelva las respuestas a AWS Transfer Family

Parámetros de plantilla

Introduzca la información de los parámetros de la plantilla de la siguiente manera. Tenga en cuenta que todos estos parámetros son cadenas.

  • Environment: este parámetro se usa para nombrar los recursos que crea la plantilla, independientemente de si están destinados a un entorno de desarrollo o producción. Los valores válidos son dev y prod.

  • PartnerHost: la dirección IP o el nombre de host del servidor AS2 asociado.

  • PartnerPort: el número de puerto del servidor AS2 asociado. Si no se especifica, el valor predeterminado es 80 para HTTP y 443 para HTTPS.

  • PartnerPath: la ruta al AS2 punto final en el servidor asociado

  • ProtocolType: el protocolo que se utilizará para la AS2 comunicación: los valores válidos son HTTP y HTTPS.

Recursos condicionales

Para ser compatible con HTTPS, la plantilla crea de forma condicional:

  • Una capa Lambda para certificados de CA

  • Configuración específica de HTTPS en la función Lambda

Despliegue y uso

Para personalizar los encabezados AS2 HTTP mediante una CloudFormation plantilla

  1. Abre la AWS CloudFormation consola en https://console.aws.amazon.com/cloudformation.

  2. En el panel de navegación izquierdo, elija Pilas.

  3. Elija Create stack (Crear pila), y, a continuación, elija With new resources (standard) (Con nuevos recursos [estándar]).

  4. En la sección Requisitos previos: preparar una plantilla, elija Elegir una plantilla existente.

  5. Copie este enlace, plantilla de encabezados HTTP dinámicos, y péguelo en el campo URL de Amazon S3.

  6. Elija Siguiente.

  7. Rellene los detalles de los parámetros con su información. Estos se detallan enParámetros de plantilla.

  8. Elija Siguiente. En la página Configurar opciones de pila, elija Siguiente.

  9. Revise los detalles de la pila que está creando y, a continuación, seleccione Crear pila.

    nota

    Al final de la página, en la sección Capacidades, debes reconocer que AWS CloudFormation podrían crear recursos AWS Identity and Access Management (IAM).

Tras implementar esta AWS CloudFormation pila:

  1. Anote la URL del punto de conexión de Amazon API Gateway proporcionada en los resultados de la pila.

  2. Actualice su AWS Transfer Family conector actual para usar este nuevo punto de conexión de Amazon API Gateway.

  3. La solución ahora gestionará AS2 los mensajes y añadirá o modificará los encabezados según lo configurado.

aviso

Modifique únicamente el encabezado del asunto o añada los encabezados que su pareja espere explícitamente. Cambiar otros encabezados puede provocar errores en la transferencia.