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

Mengirim dan menerima pesan AS2

Bagian ini menjelaskan proses untuk mengirim dan menerima pesan AS2. Ini juga memberikan rincian tentang nama file dan lokasi yang terkait dengan pesan AS2.

Tabel berikut mencantumkan algoritma enkripsi yang tersedia untuk pesan AS2, dan kapan Anda dapat menggunakannya.

Menerima proses pesan AS2

Proses inbound didefinisikan sebagai pesan atau file yang ditransfer ke AWS Transfer Family server Anda. Urutan untuk pesan masuk adalah sebagai berikut:

Mengirim dan menerima pesan AS2 melalui HTTPS

Bagian ini menjelaskan cara mengonfigurasi server Transfer Family yang menggunakan protokol AS2 untuk mengirim dan menerima pesan melalui HTTPS.

Kirim pesan AS2 melalui HTTPS

Untuk mengirim pesan AS2 menggunakan HTTPS, buat konektor dengan informasi berikut:

Menerima pesan AS2 melalui HTTPS

AWS Transfer Family Server AS2 saat ini hanya menyediakan transportasi HTTP melalui port 5080. Namun, Anda dapat menghentikan TLS pada jaringan atau penyeimbang beban aplikasi di depan titik akhir VPC server Transfer Family Anda dengan menggunakan port dan sertifikat pilihan Anda. Dengan pendekatan ini, Anda dapat meminta pesan AS2 masuk menggunakan HTTPS.

Prasyarat

Anda dapat mengonfigurasi Network Load Balance (NLB) atau Application Load Balancer (ALB). Tabel berikut mencantumkan pro dan kontra untuk setiap pendekatan.

Tabel di bawah ini memberikan perbedaan kemampuan saat Anda menggunakan NLB versus ALB untuk mengakhiri TLS.

Configure NLB

Prosedur ini menjelaskan cara mengatur Network Load Balancer (NLB) yang menghadap ke internet di VPC Anda.

Untuk membuat Network Load Balancer dan menentukan titik akhir VPC server sebagai target penyeimbang beban

1. Buka konsol Amazon Elastic Compute Cloud di https://console.aws.amazon.com/ec2/.

2. Dari panel navigasi, pilih Load Balancers, lalu pilih Buat penyeimbang beban.

3. Di bawah Penyeimbang Beban Jaringan, pilih Buat.

4. Di bagian Konfigurasi dasar, masukkan informasi berikut:

   • Untuk Nama, masukkan nama deskriptif untuk penyeimbang beban.

   • Untuk Skema, pilih Internet-facing.

   • Untuk jenis alamat IP, pilih IPv4.

5. Di bagian Pemetaan jaringan, masukkan informasi berikut:

   • Untuk VPC, pilih virtual private cloud (VPC) yang Anda buat.

   • Di bawah Pemetaan, pilih Zona Ketersediaan yang terkait dengan subnet publik yang tersedia di VPC yang sama yang Anda gunakan dengan titik akhir server Anda.

   • Untuk alamat IPv4 dari setiap subnet, pilih salah satu alamat IP Elastic yang Anda alokasikan.

6. Di bagian Pendengar dan perutean, masukkan informasi berikut:

   • Untuk Protokol, pilih TLS.

   • Untuk Port, masukkan 5080.

   • Untuk Tindakan default, pilih Buat grup target. Untuk detail pembuatan grup target baru, lihatUntuk membuat kelompok sasaran.

   Setelah Anda membuat grup target, masukkan namanya di bidang tindakan default.

7. Di bagian Pengaturan pendengar aman, pilih sertifikat Anda di area SSL/TLS Sertifikat default.

8. Pilih Buat penyeimbang beban untuk membuat NLB Anda.

9. (Opsional, tetapi disarankan) Aktifkan log akses untuk Network Load Balancer untuk mempertahankan jejak audit penuh, seperti yang dijelaskan dalam Log akses untuk Penyeimbang B eban Jaringan Anda.

   Kami merekomendasikan langkah ini karena koneksi TLS dihentikan di NLB. Oleh karena itu, alamat IP sumber yang tercermin dalam grup CloudWatch log Transfer Family AS2 Anda adalah alamat IP pribadi NLB, bukan alamat IP eksternal mitra dagang Anda.

Configure ALB

Prosedur ini menjelaskan cara mengatur Application Load Balancer (ALB) di VPC Anda.

Untuk membuat Application Load Balancer dan menentukan titik akhir VPC server sebagai target penyeimbang beban

1. Buka konsol Amazon Elastic Compute Cloud di https://console.aws.amazon.com/ec2/.

2. Dari panel navigasi, pilih Load Balancers, lalu pilih Buat penyeimbang beban.

3. Di bawah Application Load Balancer, pilih Buat.

4. Di konsol ALB, buat pendengar HTTP baru di port 443 (HTTPS).

5. (Opsional). Jika Anda ingin mengatur otentikasi bersama (MTL), konfigurasikan pengaturan keamanan dan penyimpanan kepercayaan.

   1. Lampirkan SSL/TLS sertifikat Anda ke pendengar.

   2. Di bawah Penanganan sertifikat klien, pilih O tentikasi bersama (MTL).

   3. Pilih Verifikasi dengan toko kepercayaan.

   4. Di bawah Pengaturan MTL lanj utan, pilih atau buat penyimpanan kepercayaan dengan mengunggah sertifikat CA Anda.

6. Buat grup target baru dan tambahkan alamat IP pribadi dari titik akhir server Transfer Family AS2 Anda sebagai target pada port 5080. Untuk detail pembuatan grup target baru, lihatUntuk membuat kelompok sasaran.

7. Konfigurasikan pemeriksaan kesehatan untuk kelompok target untuk menggunakan protokol HTTP pada port 5080.

8. Buat aturan baru untuk meneruskan lalu lintas HTTPS dari pendengar ke grup target.

9. Konfigurasikan pendengar untuk menggunakan SSL/TLS sertifikat Anda.

Setelah Anda mengatur penyeimbang beban, klien berkomunikasi dengan penyeimbang beban melalui pendengar port khusus. Kemudian, load balancer berkomunikasi dengan server melalui port 5080.

Uji akses ke server dari alamat IP Elastic

Hubungkan ke server melalui port khusus dengan menggunakan alamat IP Elastic atau nama DNS dari Network Load Balancer.

Mentransfer file dengan menggunakan konektor AS2

Konektor AS2 membangun hubungan antara mitra dagang untuk transfer pesan AS2 dari server Transfer Family ke tujuan eksternal milik mitra.

Anda dapat menggunakan Transfer Family untuk mengirim pesan AS2 dengan mereferensikan ID konektor dan jalur ke file, seperti yang diilustrasikan dalam perintah start-file-transfer AWS Command Line Interface (AWS CLI) berikut:

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/amzn-s3-demo-source-bucket/myfile1.txt" "/amzn-s3-demo-source-bucket/myfile2.txt"

Untuk mendapatkan detail konektor Anda, jalankan perintah berikut:

aws transfer list-connectors

Per list-connectors intah mengembalikan ID konektor, URL, dan Nama Sumber Daya Amazon (ARN) untuk konektor Anda.

Untuk mengembalikan properti konektor tertentu, jalankan perintah berikut dengan ID yang ingin Anda gunakan:

aws transfer describe-connector --connector-id your-connector-id

Per describe-connector intah mengembalikan semua properti untuk konektor, termasuk URL, peran, profil, Pemberitahuan Disposisi Pesan (mDNS), tag, dan metrik pemantauan.

Anda dapat mengonfirmasi bahwa mitra berhasil menerima file dengan melihat file JSON dan MDN. File-file ini diberi nama sesuai dengan konvensi yang dijelaskan dalamNama dan lokasi file. Jika Anda mengonfigurasi peran logging saat membuat konektor, Anda juga dapat memeriksa CloudWatch log Anda untuk status pesan AS2.

Untuk melihat detail konektor AS2, lihatLihat detail konektor AS2. Untuk informasi selengkapnya tentang membuat konektor AS2, lihatKonfigurasikan konektor AS2.

Pemrosesan AS2 mendukung banyak protokol RFC 4130, dengan fokus pada kasus penggunaan umum dan integrasi dengan implementasi server yang ada AS2-enabled . Untuk detail konfigurasi yang didukung, lihatKonfigurasi AS2.

Nama dan lokasi file

Bagian ini membahas konvensi penamaan file untuk transfer AS2.

Untuk transfer file masuk, perhatikan hal berikut:

Untuk transfer keluar, penamaan serupa, dengan perbedaan bahwa tidak ada file pesan masuk, dan juga, ID transfer untuk pesan yang ditransfer ditambahkan ke nama file. ID transfer dikembalikan oleh operasi StartFileTransfer API (atau ketika proses atau skrip lain memanggil operasi ini).

Anda juga dapat memeriksa CloudWatch log untuk melihat detail transfer Anda, termasuk yang gagal.

Kode status

Tabel berikut mencantumkan semua kode status yang dapat dicatat ke CloudWatch log saat Anda atau pasangan Anda mengirim pesan AS2. Langkah-langkah pemrosesan pesan yang berbeda berlaku untuk jenis pesan yang berbeda dan dimaksudkan untuk pemantauan saja. Status COMPLETED dan FAILED mewakili langkah terakhir dalam pemrosesan, dan terlihat dalam file JSON.

Contoh file JSON

Bagian ini mencantumkan contoh file JSON untuk transfer masuk dan keluar, termasuk file sampel untuk transfer yang berhasil dan transfer yang gagal.

Contoh file keluar yang berhasil ditransfer:

{
  "requester-content-type": "application/octet-stream",
  "message-subject": "File xyzTest from MyCompany_OID to partner YourCompany",
  "requester-file-name": "TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-from": "MyCompany_OID",
  "connector-id": "c-c21c63ceaaf34d99b",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 3198,
  "mdn-message-id": "OPENAS2-11072022063009+0000-df865189-1450-435b-9b8d-d8bc0cee97fd@PartnerA_OID_MyCompany_OID",
  "mdn-subject": "Message be18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa has been accepted",
  "as2-to": "PartnerA_OID",
  "transfer-id": "dedf4601-4e90-4043-b16b-579af35e0d83",
  "file-path": "/amzn-s3-demo-bucket/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

Contoh file keluar yang tidak berhasil ditransfer:

{
  "failure-code": "HTTP_ERROR_RESPONSE_FROM_PARTNER",
  "status-code": "FAILED",
  "requester-content-type": "application/octet-stream",
  "subject": "Test run from Id da86e74d6e57464aae1a55b8596bad0a to partner 9f8474d7714e476e8a46ce8c93a48c6c",
  "transfer-size": 3198,
  "requester-file-name": "openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "as2-message-id": "9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "failure-message": "http://Test123456789.us-east-1.elb.amazonaws.com:10080 returned status 500 for message with ID 9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "transfer-id": "07bd3e07-a652-4cc6-9412-73ffdb97ab92",
  "connector-id": "c-056e15cc851f4b2e9",
  "file-path": "/amzn-s3-demo-bucket-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

Contoh file masuk yang berhasil ditransfer:

{
  "requester-content-type": "application/EDI-X12",
  "subject": "File openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat sent from MyCompany to PartnerA",
  "client-ip": "10.0.109.105",
  "requester-file-name": "openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat",
  "as2-from": "MyCompany_OID",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 1050,
  "mdn-subject": "Message Disposition Notification",
  "as2-message-id": "OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID",
  "as2-to": "PartnerA_OID",
  "agreement-id": "a-f5c5cbea5f7741988",
  "file-path": "processed/openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID.dat",
  "server-id": "s-5f7422b04c2447ef9",
  "timestamp": "2022-07-11T23:36:36.105030Z"
}

Contoh file masuk yang tidak berhasil ditransfer:

{
  "failure-code": "INVALID_REQUEST",
  "status-code": "FAILED",
  "subject": "Sending a request from InboundHttpClientTests",
  "client-ip": "10.0.117.27",
  "as2-message-id": "testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "as2-to": "0beff6af56c548f28b0e78841dce44f9",
  "failure-message": "Unsupported date format: 2022/123/456T",
  "agreement-id": "a-0ceec8ca0a3348d6a",
  "as2-from": "ab91a398aed0422d9dd1362710213880",
  "file-path": "failed/01187f15-523c-43ac-9fd6-51b5ad2b08f3.testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "server-id": "s-0582af12e44540b9b",
  "timestamp": "2022-07-11T06:30:03.662939Z"
}