Personalizza le intestazioni HTTP per i messaggi AS2

Quando si inviano AS2 messaggi a partner commerciali, potrebbe essere necessario personalizzare le intestazioni HTTP per soddisfare requisiti specifici o migliorare la compatibilità con la configurazione del AS2 server del partner. Questo AWS CloudFormation modello crea un'infrastruttura per abilitare intestazioni HTTP personalizzate per i AS2 messaggi inviati. AWS Transfer Family Configura un Amazon API Gateway e una funzione Lambda che fungono da proxy, permettendo la modifica dinamica delle intestazioni richieste dai server dei partner commerciali. AS2

Usa questo modello per effettuare le seguenti operazioni:

• Aggiungi intestazioni HTTP personalizzate ai messaggi in uscita AS2

• Sostituisci i valori di intestazione predefiniti con valori personalizzati

  Importante

  Fai attenzione quando sovrascrivi i valori di intestazione predefiniti, poiché ciò può causare errori di invio: alcune intestazioni sono obbligatorie. AS2

• Garantisci la compatibilità con i partner commerciali che hanno requisiti di intestazione specifici

Panoramica del modello

Il modello crea i seguenti componenti principali:

• Una funzione Lambda che elabora e inoltra i messaggi AS2

• Un Amazon API Gateway per esporre la funzione Lambda

• Ruoli e autorizzazioni IAM per la funzione Lambda

• Risorse condizionali per il supporto HTTPS

Il file modello è disponibile qui: Modello di intestazioni HTTP dinamiche.

Come funziona

1. Amazon API Gateway riceve AS2 messaggi in arrivo da AWS Transfer Family.

2. La richiesta viene inoltrata alla funzione Lambda.

3. La funzione Lambda elabora la richiesta, aggiungendo o modificando le intestazioni secondo necessità.

4. La richiesta modificata viene quindi inoltrata al server del partner. AS2

5. La risposta dal server del partner viene restituita tramite Lambda e Amazon API Gateway a. AWS Transfer Family

Caratteristiche chiave

• Modifica dinamica dell'intestazione: consente la personalizzazione dell'intestazione dell'oggetto e l'aggiunta di altre intestazioni richieste.

• Protocol Support: funziona con entrambi i protocolli HTTP e HTTPS.

• Configurazione flessibile: consente di specificare l'host, la porta e il percorso del partner.

Dettagli di implementazione

Il modello implementa i seguenti componenti chiave:

Funzione Lambda

Il cuore della soluzione è una funzione Lambda Node.js che:

• Riceve richieste da Amazon API Gateway

• Modifica le intestazioni in base alla configurazione e ai dati delle richieste in entrata

• Inoltra la richiesta modificata al server del partner AS2

• Gestisce entrambi i protocolli HTTP e HTTPS

• Include la gestione e la registrazione degli errori

Amazon API Gateway

Un'API HTTP è configurata per:

• Ricevere messaggi in arrivo AS2

• Indirizza le richieste alla funzione Lambda

• Restituisci le risposte a AWS Transfer Family

Parametri del modello

Immettete le informazioni per i parametri del modello come segue. Notate che tutti questi parametri sono stringhe.

• Environment: questo parametro viene utilizzato per denominare le risorse create dal modello, indipendentemente dal fatto che siano destinate a un ambiente di sviluppo o di produzione. I valori validi sono dev e prod.

• PartnerHost: l'indirizzo IP o il nome host del server AS2 partner.

• PartnerPort: il numero di porta per il server AS2 partner. Se non specificato, il valore predefinito è 80 per HTTP e 443 per HTTPS.

• PartnerPath: il percorso dell' AS2 endpoint sul server partner

• ProtocolType: il protocollo da utilizzare per la AS2 comunicazione: i valori validi sono HTTP e HTTPS.

Risorse condizionali

Per il supporto HTTPS, il modello crea in modo condizionale:

• Un Lambda Layer per i certificati CA

• Configurazione specifica per HTTPS nella funzione Lambda

Distribuzione e utilizzo

Per personalizzare le intestazioni AS2 HTTP utilizzando un modello CloudFormation

1. Apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformazione.

2. Nel riquadro di navigazione a sinistra, selezionare Stacks (Stack).

3. Scegliere Create stack (Crea stack), quindi scegliere Con nuove risorse (standard).

4. Nella sezione Prerequisito: prepara il modello, scegli Scegli un modello esistente.

5. Copia questo link, modello di intestazioni HTTP dinamiche, e incollalo nel campo URL di Amazon S3.

6. Scegli Next (Successivo).

7. Inserisci i dettagli del parametro con le tue informazioni. Questi sono descritti in dettaglio inParametri del modello.

8. Scegli Next (Successivo). Nella pagina Configura le opzioni dello stack, scegli di nuovo Avanti.

9. Controlla i dettagli dello stack che stai creando, quindi scegli Crea stack.

   Nota

   Nella parte inferiore della pagina, in Capacità, devi riconoscere che AWS CloudFormation potrebbe creare risorse AWS Identity and Access Management (IAM).

Dopo aver distribuito questo AWS CloudFormation stack:

1. Prendi nota dell'URL dell'endpoint Amazon API Gateway fornito negli output dello stack.

2. Aggiorna il tuo AWS Transfer Family connettore esistente per utilizzare questo nuovo endpoint Amazon API Gateway.

3. La soluzione ora gestirà AS2 i messaggi, l'aggiunta o la modifica delle intestazioni in base alla configurazione.

avvertimento

Modifica l'intestazione Subject o aggiungi solo le intestazioni che il tuo partner si aspetta esplicitamente. La modifica di altre intestazioni può causare errori di trasferimento.