View a markdown version of this page

Sesuaikan header HTTP untuk pesan AS2 - AWS Transfer Family
Gambaran Umum TemplatCara KerjanyaFitur UtamaDetail ImplementasiPenerapan dan Penggunaan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Sesuaikan header HTTP untuk pesan AS2

Saat mengirim pesan AS2 ke mitra dagang, Anda mungkin perlu menyesuaikan header HTTP untuk memenuhi persyaratan tertentu atau meningkatkan kompatibilitas dengan konfigurasi server AS2 mitra Anda. CloudFormation Template ini membuat infrastruktur untuk mengaktifkan header HTTP yang disesuaikan untuk pesan AS2 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 AS2 mitra dagang.

Gunakan template ini untuk melakukan hal berikut:

  • Tambahkan header HTTP kustom ke pesan AS2 keluar

  • Ganti nilai header default dengan nilai kustom

    penting

    Hati-hati saat mengganti nilai header default, karena dapat menyebabkan kegagalan pengiriman: beberapa header AS2 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 pesan AS2 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 AS2 mitra.

  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 kunci berikut:

Fungsi Lambda

Inti dari solusinya adalah fungsi Node.js Lambda yang:

  • Menerima permintaan dari Amazon API Gateway

  • Memodifikasi header berdasarkan konfigurasi dan data permintaan masuk

  • Meneruskan permintaan yang dimodifikasi ke server AS2 mitra

  • Menangani protokol HTTP dan HTTPS

  • Termasuk penanganan kesalahan dan pencatatan

Amazon API Gateway

API HTTP diatur untuk:

  • Terima pesan AS2 yang masuk

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

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

  • PartnerPath: jalur ke titik akhir AS2 di server mitra

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

Sumber Daya Bersyarat

Untuk dukungan HTTPS, template membuat secara kondisional:

  • Lapisan Lambda untuk sertifikat CA

  • HTTPS-specific konfigurasi dalam fungsi Lambda

Penerapan dan Penggunaan

Untuk menyesuaikan header HTTP AS2 menggunakan template CloudFormation

  1. Buka 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 CloudFormation mungkin membuat sumber daya AWS Identity and Access Management (IAM).

Setelah menerapkan 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 pesan AS2, 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.