View a markdown version of this page

Personalizza le intestazioni HTTP per i messaggi AS2 - AWS Transfer Family
Panoramica del modelloCome funzionaCaratteristiche chiaveDettagli di implementazioneDistribuzione e utilizzo

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Personalizza le intestazioni HTTP per i messaggi AS2

Quando si inviano messaggi AS2 a partner commerciali, potrebbe essere necessario personalizzare le intestazioni HTTP per soddisfare requisiti specifici o migliorare la compatibilità con la configurazione del server AS2 del partner. Questo CloudFormation modello crea un'infrastruttura per abilitare intestazioni HTTP personalizzate per i messaggi AS2 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 AS2 dei partner commerciali.

Usa questo modello per effettuare le seguenti operazioni:

  • Aggiungi intestazioni HTTP personalizzate ai messaggi AS2 in uscita

  • 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 AS2 sono necessarie.

  • 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 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 messaggi AS2 in entrata 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 AS2 del partner.

  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 Node.js Lambda 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 AS2 del partner

  • Gestisce entrambi i protocolli HTTP e HTTPS

  • Include la gestione e la registrazione degli errori

Gateway Amazon API

Un'API HTTP è configurata per:

  • Ricevere messaggi AS2 in arrivo

  • 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 partner AS2.

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

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

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

Risorse condizionali

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

  • Un livello Lambda per i certificati CA

  • HTTPS-specific configurazione nella funzione Lambda

Distribuzione e utilizzo

Per personalizzare le intestazioni HTTP AS2 utilizzando un modello CloudFormation

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

  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 dettagliati 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 CloudFormation potrebbe creare risorse AWS Identity and Access Management (IAM).

Dopo aver distribuito questo 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à i messaggi AS2, aggiungendo o modificando le 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.