Sesuaikan header HTTP untuk pesan AS2

Saat mengirim AS2 pesan ke mitra dagang, Anda mungkin perlu menyesuaikan header HTTP untuk memenuhi persyaratan tertentu atau meningkatkan kompatibilitas dengan konfigurasi AS2 server mitra Anda. AWS CloudFormation Template ini membuat infrastruktur untuk mengaktifkan header HTTP yang disesuaikan untuk AS2 pesan yang dikirim. AWS Transfer Family Ini mengatur fungsi Amazon API Gateway dan Lambda untuk bertindak sebagai proxy, memungkinkan modifikasi dinamis header yang diperlukan oleh server mitra dagang. AS2

Gunakan template ini untuk melakukan hal berikut:

• Tambahkan header HTTP kustom ke pesan keluar AS2

• Ganti nilai header default dengan nilai kustom

  penting

  Hati-hati saat mengganti nilai header default, karena dapat menyebabkan kegagalan pengiriman: beberapa AS2 header diperlukan.

• Pastikan kompatibilitas dengan mitra dagang yang memiliki persyaratan header tertentu

Gambaran Umum Templat

Template membuat komponen utama berikut:

• Fungsi Lambda yang memproses dan meneruskan pesan AS2

• Amazon API Gateway untuk mengekspos fungsi Lambda

• Peran dan izin IAM untuk fungsi Lambda

• Sumber daya bersyarat untuk dukungan HTTPS

File template tersedia di sini: Template header HTTP dinamis.

Cara Kerjanya

1. Amazon API Gateway menerima AS2 pesan masuk dari AWS Transfer Family.

2. Permintaan diteruskan ke fungsi Lambda.

3. Fungsi Lambda memproses permintaan, menambahkan atau memodifikasi header sesuai kebutuhan.

4. Permintaan yang dimodifikasi kemudian diteruskan ke server mitra. AS2

5. Respons dari server mitra dikembalikan melalui Lambda dan Amazon API Gateway kembali ke. AWS Transfer Family

Fitur Utama

• Modifikasi Header Dinamis: Memungkinkan kustomisasi header Subjek dan penambahan header lain yang diperlukan.

• Protocol Support: Bekerja dengan protokol HTTP dan HTTPS.

• Konfigurasi Fleksibel: Memungkinkan spesifikasi host mitra, port, dan jalur.

Detail Implementasi

Template mengimplementasikan komponen-komponen kunci berikut:

Fungsi Lambda

Inti dari solusinya adalah fungsi Lambda Node.js yang:

• Menerima permintaan dari Amazon API Gateway

• Memodifikasi header berdasarkan konfigurasi dan data permintaan masuk

• Meneruskan permintaan yang dimodifikasi ke server mitra AS2

• Menangani protokol HTTP dan HTTPS

• Termasuk penanganan kesalahan dan pencatatan

Amazon API Gateway

API HTTP diatur untuk:

• Menerima pesan masuk AS2

• Permintaan rute ke fungsi Lambda

• Kembalikan tanggapan kembali ke AWS Transfer Family

Parameter template

Masukkan informasi untuk parameter template sebagai berikut. Perhatikan bahwa semua parameter ini adalah string.

• Environment: parameter ini digunakan untuk memberi nama sumber daya yang dibuat template: apakah mereka dimaksudkan untuk pengembangan atau lingkungan produksi. Nilai yang valid adalah dev dan prod.

• PartnerHost: alamat IP atau nama host dari server AS2 mitra.

• PartnerPort: nomor port untuk server AS2 mitra. Jika tidak ditentukan, default ke 80 untuk HTTP dan 443 untuk HTTPS.

• PartnerPath: jalur ke AS2 titik akhir di server mitra

• ProtocolType: protokol yang digunakan untuk AS2 komunikasi: nilai yang valid adalah HTTP dan HTTPS.

Sumber Daya Bersyarat

Untuk dukungan HTTPS, template membuat secara kondisional:

• Lapisan Lambda untuk sertifikat CA

• Konfigurasi khusus HTTP dalam fungsi Lambda

Penerapan dan Penggunaan

Untuk menyesuaikan header AS2 HTTP menggunakan template CloudFormation

1. Buka AWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

2. Di panel navigasi sebelah kiri, pilih Tumpukan.

3. Pilih Buat tumpukan, lalu pilih Dengan sumber daya baru (standar).

4. Di bagian Prasyarat - Siapkan templat, pilih Pilih templat yang ada.

5. Salin tautan ini, template header HTTP Dinamis, dan tempel ke bidang URL Amazon S3.

6. Pilih Berikutnya.

7. Isi detail parameter dengan informasi Anda. Ini dirinci dalamParameter template.

8. Pilih Berikutnya. Pada halaman Configure stack options, pilih Next lagi.

9. Tinjau detail tumpukan yang Anda buat, lalu pilih Buat tumpukan.

   catatan

   Di bagian bawah halaman, di bawah Kemampuan, Anda harus mengakui bahwa AWS CloudFormation mungkin membuat sumber daya AWS Identity and Access Management (IAM).

Setelah menerapkan AWS CloudFormation tumpukan ini:

1. Perhatikan URL titik akhir Amazon API Gateway yang disediakan dalam output tumpukan.

2. Perbarui AWS Transfer Family Konektor yang ada untuk menggunakan titik akhir Amazon API Gateway baru ini.

3. Solusinya sekarang akan menangani AS2 pesan, menambahkan atau memodifikasi header seperti yang dikonfigurasi.

Awas

Hanya ubah header Subjek atau tambahkan header yang diharapkan pasangan Anda secara eksplisit. Mengubah header lain dapat menyebabkan kegagalan transfer.