Tukarkan pesan Applicability Statement 2 menggunakan alur kerja di Azure Logic Apps
Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)
Untuk mengirim dan menerima pesan AS2 dalam alur kerja yang Anda buat menggunakan Azure Logic Apps, Anda dapat menggunakan konektor AS2 (v2), yang menyediakan tindakan yang mendukung dan mengelola komunikasi AS2. Jika Anda memerlukan kemampuan pelacakan, konektor AS2 asli masih tersedia, tetapi tidak digunakan lagi.
Kecuali untuk kemampuan pelacakan, konektor AS2 (v2) menyediakan kemampuan yang sama dengan konektor AS2 asli, berjalan secara asli dengan runtime Azure Logic Apps, dan menawarkan peningkatan performa yang signifikan dalam ukuran pesan, throughput, dan latensi. Tidak seperti konektor AS2 asli, konektor AS2 (v2) tidak mengharuskan Anda membuat koneksi ke akun integrasi Anda. Sebagai gantinya, seperti yang dijelaskan di prasyarat, pastikan Anda menautkan akun integrasi ke sumber daya aplikasi logika tempat Anda berencana menggunakan konektor.
Panduan cara ini menunjukkan cara menambahkan tindakan pengodean dan dekode AS2 ke alur kerja aplikasi logika yang ada. Konektor AS2 (v2) tidak menyertakan pemicu apa pun, sehingga Anda dapat menggunakan pemicu apa pun untuk memulai alur kerja Anda. Contoh dalam panduan ini menggunakan pemicu Permintaan.
Referensi teknis konektor
Konektor AS2 memiliki versi yang berbeda, berdasarkan jenis aplikasi logika dan lingkungan host.
| Aplikasi logika | Lingkungan | Versi konektor |
|---|---|---|
| Consumption | Azure Logic Apps multipenyewa | Konektor terkelola AS2 (v2) dan AS2 (kelas Standar). Konektor AS2 (v2) hanya menyediakan tindakan, tetapi Anda dapat menggunakan pemicu apa pun yang berfungsi untuk skenario Anda. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola AS2 - Operasi konektor terkelola AS2 (v2) - Batas pesan AS2 |
| Standard | Azure Logic Apps penyewa tunggal dan Lingkungan App Service v3 (hanya paket Windows) | Konektor bawaan AS2 (v2) dan konektor terkelola AS2 . Versi bawaan berbeda dengan cara berikut: - Versi bawaan hanya menyediakan tindakan, tetapi Anda dapat menggunakan pemicu apa pun yang berfungsi untuk skenario Anda. - Versi bawaan dapat langsung mengakses jaringan virtual Azure. Anda tidak memerlukan gateway data lokal. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola AS2 - Operasi konektor bawaan AS2 (v2) - Batas pesan AS2 |
Operasi AS2 (v2)
Konektor AS2 (v2) tidak memiliki pemicu. Tabel berikut ini menjelaskan tindakan yang disediakan konektor AS2 (v2) untuk membangun keamanan dan keandalan saat mengirimkan pesan:
| Tindakan | Deskripsi |
|---|---|
| Tindakan Pengodean AS2 | Menyediakan enkripsi, penandatanganan digital, dan pengakuan melalui Pemberitahuan Disposisi Pesan (MDN), yang membantu mendukung nonrepudiasi. Misalnya, tindakan ini menerapkan header AS2/HTTP dan melakukan tugas berikut saat dikonfigurasi: - Tanda tangani pesan keluar. - Mengenkripsi pesan keluar. - Kompres pesan. - Kirim nama file di header MIME. |
| Tindakan Dekode AS2 | Berikan dekripsi, penandatanganan digital, dan pengakuan melalui Pemberitahuan Disposisi Pesan (MDN). Misalnya, tindakan ini melakukan tugas berikut saat dikonfigurasi: - Memproses header AS2/HTTP. - Rekonsiliasi menerima MDN dengan pesan keluar asli. - Memperbarui dan menghubungkan rekaman dalam database nonrepudiasi. - Tulis rekaman untuk pelaporan status AS2. - Konten payload output sebagai dikodekan base64. - Tentukan apakah MDN diperlukan. Berdasarkan perjanjian AS2, tentukan apakah MDN harus sinkron atau asinkron. - Hasilkan MDN sinkron atau asinkron berdasarkan perjanjian AS2. - Atur token korelasi dan properti pada MDN. - Verifikasi tanda tangan. - Dekripsi pesan. - Dekompresi pesan. - Periksa dan larang duplikat ID pesan. |
Prasyarat
Akun dan langganan Azure. Jika Anda belum memiliki langganan, daftar untuk akun Azure gratis.
Sumber daya aplikasi logika dan alur kerja tempat Anda ingin menggunakan operasi Applicability Statement 2.
Sumber daya akun integrasi untuk menentukan dan menyimpan artefak untuk digunakan dalam integrasi perusahaan dan alur kerja B2B.
Akun integrasi dan sumber daya aplikasi logika Anda harus ada di langganan Azure dan wilayah Azure yang sama.
Menentukan setidaknya dua mitra dagang yang berpartisipasi dalam operasi AS2 yang digunakan dalam alur kerja Anda. Definisi untuk kedua mitra harus menggunakan pengkualifikasi identitas bisnis yang sama, yaitu AS2Identity untuk skenario ini.
Menentukan perjanjian AS2 antara mitra dagang yang berpartisipasi dalam alur kerja Anda. Setiap perjanjian membutuhkan mitra host dan mitra tamu. Konten dalam pesan antara Anda dan mitra lain harus sesuai dengan jenis perjanjian. Untuk informasi tentang pengaturan perjanjian yang akan digunakan saat menerima dan mengirim pesan, lihat Pengaturan pesan AS2.
Berdasarkan apakah Anda mengerjakan alur kerja aplikasi logika Konsumsi atau Standar, sumber daya aplikasi logika Anda mungkin memerlukan tautan ke akun integrasi Anda:
Alur kerja aplikasi logika Tautan diperlukan? Consumption - Konektor AS2 (v2): Koneksi diperlukan, tetapi tidak diperlukan tautan
- Konektor AS2 : Tautan diperlukan, tetapi tidak diperlukan koneksiStandard - Konektor AS2 (v2): Tautan diperlukan, tetapi tidak diperlukan koneksi
- Konektor AS2 : Koneksi diperlukan, tetapi tidak diperlukan tautanJika Anda menggunakan Azure Key Vault untuk manajemen sertifikat, periksa apakah kunci vault Anda mengizinkan operasi Enkripsi dan Dekripsi. Jika tidak, tindakan pengodean dan decoding gagal.
Di portal Azure, buka brankas kunci Anda. Pada menu brankas kunci, di bagian Pengaturan, pilih Tombol.
Pada panel Tombol, pilih kunci Anda. Pada panel Versi, pilih versi kunci yang Anda gunakan.
Pada panel Versi Kunci, di bagian Operasi yang diizinkan, konfirmasikan bahwa operasi Enkripsi dan Dekripsi dipilih, misalnya:
Dekodekan pesan AS2
Pilih tab untuk alur kerja aplikasi logika Konsumsi atau Standar:
Konektor AS2 v2
Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan AS2 (v2) bernama Encode AS2 ke alur kerja Anda.
Dalam kotak informasi tindakan, berikan informasi berikut:
Properti Wajib Deskripsi Pesan untuk dikodekan Ya Payload pesan, misalnya, output Isi dari pemicu Permintaan.
1. Letakkan kursor Anda dalam kotak Pesan untuk mengodekan sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Isi.AS2 dari Ya Pengidentifikasi bisnis untuk pengirim pesan seperti yang ditentukan oleh perjanjian AS2 Anda, misalnya, Fabrikam. AS2 ke Ya Pengidentifikasi bisnis untuk penerima pesan seperti yang ditentukan oleh perjanjian AS2 Anda, misalnya, Contoso. 
Konektor AS2
Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan AS2 bernama Encode ke pesan AS2 ke alur kerja Anda.
Saat diminta untuk membuat koneksi ke akun integrasi Anda, berikan informasi berikut:
Properti Wajib Deskripsi Nama koneksi Ya Nama untuk koneksi Akun Integrasi Ya Dari daftar akun integrasi yang tersedia, pilih akun yang akan digunakan. Contohnya:
Jika sudah selesai, pilih Buat.
Dalam kotak informasi tindakan, berikan informasi berikut.
Properti Wajib Deskripsi AS2-Dari Ya Pengidentifikasi bisnis untuk pengirim pesan seperti yang ditentukan oleh perjanjian AS2 Anda, misalnya, Fabrikam. AS2-Ke Ya Pengidentifikasi bisnis untuk penerima pesan seperti yang ditentukan oleh perjanjian AS2 Anda, misalnya, Contoso. body Ya Payload pesan untuk dikodekan, misalnya, output Isi dari pemicu Permintaan.
1. Letakkan kursor Anda di kotak isi sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Isi.
Dekodekan pesan AS2
Pilih tab untuk alur kerja aplikasi logika Konsumsi atau Standar:
Konektor AS2 v2
Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan AS2 (v2) bernama Dekode AS2 ke alur kerja Anda.
Dalam kotak informasi tindakan, berikan informasi berikut:
Properti Wajib Deskripsi body Ya Isi pesan untuk didekodekan, misalnya, output Isi dari pemicu Permintaan.
1. Letakkan kursor Anda di kotak isi sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Isi.Header Ya Header untuk pesan yang akan didekodekan, misalnya, output Header dari pemicu Permintaan.
1. Letakkan kursor Anda dalam kotak Header sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Header.Contohnya:
Konektor AS2
Di portal Microsoft Azure, buka sumber daya dan alur kerja aplikasi logika Anda di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan AS2 bernama dekodekan pesan AS2 ke alur kerja Anda.
Saat diminta untuk membuat koneksi ke akun integrasi Anda, berikan informasi berikut:
Properti Wajib Deskripsi Nama koneksi Ya Nama untuk koneksi Akun Integrasi Ya Dari daftar akun integrasi yang tersedia, pilih akun yang akan digunakan. Contohnya:
Jika sudah selesai, pilih Buat.
Dalam kotak informasi tindakan, berikan informasi berikut.
Properti Wajib Deskripsi body Ya Payload pesan, misalnya, output Isi dari pemicu Permintaan.
1. Letakkan kursor Anda di kotak isi sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Isi.Header Ya Header untuk pesan yang akan didekodekan, misalnya, output Header dari pemicu Permintaan.
1. Letakkan kursor Anda dalam kotak Header sehingga daftar konten dinamis terbuka.
2. Di samping nama bagian Saat permintaan HTTP diterima, pilih Lihat selengkapnya.
3. Dari daftar output, pilih Header.
Sampel
Untuk mencoba menyebarkan aplikasi logika yang beroperasi penuh dan sampel skenario Applicability Statement 2 (v2), tinjau template dan skenario aplikasi logika Applicability Statement 2 (v2).
Memecahkan masalah
Masalah saat mengirim pesan yang ditandatangani atau dienkripsi
Pertimbangkan untuk mencoba format algoritma SHA256 yang berbeda. Spesifikasi AS2 tidak memberikan informasi apa pun tentang format SHA256, jadi setiap penyedia menggunakan implementasi atau format mereka sendiri.