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

Mengirim dan menerima AS2 pesan

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

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

Menerima proses AS2 pesan

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

Mengirim dan menerima AS2 pesan melalui HTTPS

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

Kirim AS2 pesan melalui HTTPS

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

Menerima AS2 pesan melalui HTTPS

AWS Transfer Family AS2 server saat ini hanya menyediakan transportasi HTTP melalui port 5080. Namun, Anda dapat menghentikan TLS pada penyeimbang beban jaringan atau aplikasi di depan titik akhir VPC server Transfer Family Anda dengan menggunakan port dan sertifikat pilihan Anda. Dengan pendekatan ini, Anda dapat memiliki AS2 pesan 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 mendefinisikan 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 Create load balancer.

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 yang menghadap ke Internet.

   • 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 Availability Zones yang terkait dengan subnet publik yang tersedia di VPC yang sama yang Anda gunakan dengan endpoint server Anda.

   • Untuk IPv4 alamat setiap subnet, pilih salah satu alamat IP elastis 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 grup target.

   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 Access untuk Network Load Balancer Anda.

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

Configure ALB

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

Untuk membuat Application Load Balancer dan mendefinisikan 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 Create load balancer.

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 timbal balik (mTL), konfigurasikan pengaturan keamanan dan toko kepercayaan.

   1. Lampirkan SSL/TLS sertifikat Anda ke pendengar.

   2. Di bawah penanganan sertifikat Klien, pilih Mutual Authentication (mTLS).

   3. Pilih Verifikasi dengan toko kepercayaan.

   4. Di bawah pengaturan mTLS tingkat lanjut, pilih atau buat toko kepercayaan dengan mengunggah sertifikat CA Anda.

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

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 listener untuk menggunakan sertifikat SSL/TLS Anda.

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

Uji akses ke server dari alamat IP Elastis

Connect ke server melalui port kustom dengan menggunakan alamat IP Elastis atau nama DNS Network Load Balancer.

Mentransfer file dengan menggunakan konektor AS2

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

Anda dapat menggunakan Transfer Family untuk mengirim AS2 pesan 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

list-connectorsPerintah mengembalikan konektor IDs, URLs, dan Amazon Resource Names (ARNs) 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

describe-connectorPerintah 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 AS2 pesan.

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

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

Nama dan lokasi file

Bagian ini membahas konvensi penamaan file untuk transfer. AS2

Untuk transfer file masuk, perhatikan hal berikut:

Untuk transfer keluar, penamaannya 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 mengirim AS2 pesan. 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 inbound 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"
}