Apa itu konektor di Azure Logic Apps

Saat membuat alur kerja menggunakan Azure Logic Apps, Anda dapat menggunakan konektor untuk bekerja dengan data, peristiwa, dan sumber daya di aplikasi, layanan, sistem, dan platform lain - tanpa menulis kode. Konektor menyediakan satu atau beberapa operasi bawaan, yang Anda gunakan sebagai langkah-langkah dalam alur kerja Anda.

Dalam konektor, setiap operasi adalah kondisi pemicu yang memulai alur kerja atau tindakan berikutnya yang melakukan tugas tertentu, bersama dengan properti yang dapat Anda konfigurasi. Meskipun banyak konektor memiliki pemicu dan tindakan, beberapa konektor hanya menawarkan pemicu, sementara yang lain hanya menyediakan tindakan.

Di Azure Logic Apps, konektor tersedia dalam versi bawaan, versi terkelola, atau keduanya. Banyak konektor biasanya mengharuskan Anda terlebih dahulu membuat dan mengonfigurasi koneksi ke layanan atau sistem yang mendasar, biasanya sehingga Anda dapat mengautentikasi akses ke akun pengguna. Jika tidak ada konektor yang tersedia untuk layanan atau sistem yang ingin Anda akses, Anda dapat mengirim permintaan menggunakan operasi HTTP generik, atau Anda dapat membuat konektor kustom.

Gambaran umum ini memberikan pengenalan tingkat tinggi pada konektor dan cara kerjanya secara umum. Untuk informasi konektor selengkapnya, lihat dokumentasi berikut ini:

• gambaran umum Koneksi or untuk layanan seperti Power Automate dan Power Apps
• Gambaran umum konektor bawaan untuk Azure Logic Apps
• Gambaran umum konektor terkelola untuk Azure Logic Apps
• Referensi konektor terkelola untuk Azure Logic Apps

Konektor bawaan versus konektor terkelola

Di Azure Logic Apps, konektor dibangun atau dikelola. Beberapa konektor memiliki kedua versi. Versi yang tersedia bergantung pada apakah Anda membuat alur kerja aplikasi logika Konsumsi yang berjalan di Azure Logic Apps multi-penyewa atau alur kerja aplikasi logika Standar yang berjalan di Azure Logic Apps penyewa tunggal. Untuk informasi selengkapnya tentang jenis sumber daya aplikasi logika, lihat Jenis sumber daya dan perbedaan lingkungan host.

• Konektor bawaan dirancang untuk berjalan secara langsung dan asli di dalam Azure Logic Apps.

• Konektor terkelola disebarkan, dihosting, dan dikelola di Azure oleh Microsoft. Konektor terkelola sebagian besar menyediakan proksi atau pembungkus di sekitar API yang digunakan layanan atau sistem yang mendasar untuk berkomunikasi dengan Azure Logic Apps.

  • Dalam alur kerja Konsumsi, konektor terkelola muncul di perancang di bawah label Standar atau Perusahaan , berdasarkan tingkat harganya.

  • Dalam alur kerja Standar, semua konektor terkelola muncul di perancang di bawah label Azure .

Untuk informasi selengkapnya, lihat dokumentasi berikut:

• Model harga dan tagihan di Azure Logic Apps
• Detail harga Azure Logic Apps

Memicu

Pemicu menentukan kondisi yang akan dipenuhi sebelum alur kerja dapat dimulai dan selalu merupakan langkah pertama dalam alur kerja apa pun. Setiap pemicu juga mengikuti pola pengaktifan tertentu yang mengontrol bagaimana pemicu memantau dan merespons peristiwa. Biasanya, pemicu mengikuti pola polling atau pola dorong . Terkadang, kedua versi pemicu tersedia.

• Pemicu polling secara berkala memeriksa layanan atau sistem tertentu pada jadwal tertentu untuk memeriksa data baru atau peristiwa tertentu. Jika ada data baru, atau peristiwa tertentu terjadi, pemicu tersebut membuat dan menjalankan instans baru untuk alur kerja Anda. Instans baru ini kemudian dapat menggunakan data yang diteruskan sebagai input.

• Pemicu push atau webhook mendengarkan data baru atau agar peristiwa terjadi, tanpa polling. Ketika ada data baru, atau ketika terjadi peristiwa, pemicu tersebut membuat dan menjalankan instans baru untuk alur kerja Anda. Instans baru ini kemudian dapat menggunakan data yang diteruskan sebagai input.

Misalnya, Anda ingin membuat alur kerja yang berjalan saat file diunggah ke server FTP Anda. Sebagai langkah pertama dalam alur kerja, Anda dapat menambahkan pemicu FTP bernama Saat file ditambahkan atau dimodifikasi, yang mengikuti pola polling. Anda kemudian menentukan jadwal untuk memeriksa peristiwa unggahan secara teratur.

Ketika pemicu diaktifkan, pemicu biasanya melewati output peristiwa untuk tindakan berikutnya untuk mereferensikan dan menggunakan. Untuk contoh FTP, pemicu secara otomatis menghasilkan informasi seperti nama dan jalur file. Anda juga dapat menyiapkan pemicu untuk menyertakan konten file. Jadi, untuk memproses data ini, Anda harus menambahkan tindakan ke alur kerja Anda.

Tindakan

Tindakan menentukan tugas yang akan dilakukan dan selalu muncul sebagai langkah berikutnya dalam alur kerja. Anda dapat menggunakan beberapa tindakan di alur kerja Anda. Misalnya, Anda dapat memulai alur kerja dengan pemicu SQL Server yang memeriksa data pelanggan baru dalam database SQL. Mengikuti pemicu, alur kerja Anda dapat memiliki tindakan SQL Server yang mendapatkan data pelanggan. Mengikuti tindakan SQL Server ini, alur kerja Anda dapat menggunakan tindakan berbeda yang memproses data, misalnya, tindakan Operasi Data yang membuat tabel CSV.

izin Koneksi ion

Dalam alur kerja aplikasi logika Konsumsi, sebelum Anda dapat membuat atau mengelola sumber daya aplikasi logika, alur kerja, dan koneksinya, Anda memerlukan izin tertentu. Untuk informasi selengkapnya tentang izin ini, lihat Operasi aman - Akses dan data aman di Azure Logic Apps.

pembuatan, konfigurasi, dan autentikasi Koneksi ion

Sebelum Anda dapat menggunakan operasi konektor di alur kerja Anda, banyak konektor mengharuskan Anda terlebih dahulu membuat koneksi ke layanan atau sistem target. Untuk membuat koneksi dari dalam perancang alur kerja, Anda harus mengautentikasi identitas Anda dengan kredensial akun dan terkadang informasi koneksi lainnya.

Misalnya, sebelum alur kerja dapat mengakses dan berfungsi dengan akun email Outlook Office 365 Anda, Anda harus mengotorisasi koneksi ke akun tersebut. Untuk beberapa konektor bawaan dan konektor terkelola, Anda dapat menyiapkan dan menggunakan identitas terkelola untuk autentikasi, daripada memberikan info masuk Anda.

Meskipun Anda membuat koneksi dalam alur kerja, koneksi ini sebenarnya adalah sumber daya Azure yang terpisah dengan definisi sumber dayanya sendiri. Untuk meninjau definisi sumber daya koneksi ini, ikuti langkah-langkah ini berdasarkan apakah Anda memiliki alur kerja Konsumsi atau Standar:

• Consumption

  • Untuk melihat dan mengelola koneksi ini di portal Azure, lihat Menampilkan koneksi untuk alur kerja Konsumsi di portal Azure.

  • Untuk melihat dan mengelola koneksi ini di Visual Studio, lihat Mengelola alur kerja Konsumsi dengan Visual Studio, dan mengunduh sumber daya aplikasi logika Anda dari Azure ke Visual Studio.

  Untuk informasi selengkapnya tentang definisi sumber daya koneksi untuk alur kerja Konsumsi, lihat definisi sumber daya Koneksi ion.

• Standard

  • Untuk melihat dan mengelola koneksi ini di portal Azure, lihat Menampilkan koneksi untuk alur kerja Standar di portal Azure.

  • Untuk melihat dan mengelola koneksi ini di Visual Studio Code, lihat Menampilkan alur kerja aplikasi logika Anda di Visual Studio Code. File connections.json berisi konfigurasi yang diperlukan untuk koneksi yang dibuat oleh konektor.

Keamanan dan enkripsi koneksi

Detail konfigurasi koneksi, seperti alamat server, nama pengguna, dan kata sandi, kredensial, dan rahasia dienkripsi dan disimpan di lingkungan Azure yang aman. Informasi ini hanya dapat digunakan dalam sumber daya aplikasi logika dan oleh klien yang memiliki izin untuk sumber daya koneksi, yang diberlakukan menggunakan pemeriksaan akses tertaut. Koneksi yang menggunakan Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth), seperti Office 365, Salesforce, dan GitHub, mengharuskan Anda masuk, tetapi Azure Logic Apps hanya menyimpan akses dan refresh token sebagai rahasia, bukan kredensial masuk.

Koneksi yang dibuat dapat mengakses layanan atau sistem target selama layanan atau sistem tersebut memungkinkan. Untuk layanan yang menggunakan koneksi Microsoft Entra ID OAuth, seperti Office 365 dan Dynamics, Azure Logic Apps me-refresh token akses tanpa batas waktu. Layanan lain mungkin memiliki batasan durasi Logic Apps dapat menggunakan token tanpa me-refresh. Beberapa tindakan, seperti mengubah kata sandi Anda, akan membatalkan semua token akses.

Catatan

Jika organisasi Anda tidak mengizinkan Anda untuk mengakses sumber daya tertentu melalui konektor di Azure Logic Apps, Anda dapat memblokir kemampuan untuk membuat koneksi tersebut menggunakan Azure Policy.

Untuk informasi selengkapnya tentang mengamankan alur kerja dan koneksi aplikasi logika, lihat Mengamankan akses dan data di Azure Logic Apps.

Akses firewall untuk koneksi

Jika Anda menggunakan firewall yang membatasi lalu lintas, dan alur kerja aplikasi logika perlu berkomunikasi melalui firewall tersebut, Anda harus menyiapkan firewall untuk mengizinkan akses baik untuk alamat IP masuk dan keluar yang digunakan oleh platform atau runtime Azure Logic Apps di wilayah Azure tempat alur kerja aplikasi logika Anda berada.

Jika alur kerja Anda juga menggunakan konektor terkelola, seperti konektor Office 365 Outlook atau konektor SQL, atau menggunakan konektor kustom, firewall Anda juga perlu mengizinkan akses untuk semuaalamat IP keluar konektor terkelola di wilayah Azure sumber daya aplikasi logika Anda. Untuk informasi selengkapnya, lihat Konfigurasi firewall.

Konektor dan API kustom

Dalam alur kerja Konsumsi untuk Azure Logic Apps multi-penyewa, Anda dapat memanggil API berbasis Swagger atau berbasis SOAP yang tidak tersedia sebagai konektor di luar kotak. Anda juga dapat menjalankan kode kustom dengan membuat Aplikasi API kustom. Untuk informasi selengkapnya, lihat dokumentasi berikut:

• Konektor kustom berbasis Swagger atau berbasis SOAP untuk alur kerja Konsumsi

• Buat konektor kustom berbasis Swagger atau berbasis SOAP, yang membuat API ini tersedia untuk alur kerja aplikasi logika Konsumsi apa pun di langganan Azure Anda.

  Untuk membuat konektor kustom menjadi publik bagi siapa saja untuk digunakan di Azure, kirimkan konektor untuk sertifikasi Microsoft.

• Membuat API Apps kustom

Di Alur kerja Standar untuk Azure Logic Apps penyewa tunggal, Anda dapat membuat konektor bawaan kustom berbasis penyedia layanan yang berjalan secara asli yang tersedia untuk alur kerja aplikasi logika Standar apa pun. Untuk informasi selengkapnya, lihat dokumentasi berikut:

• Konektor bawaan kustom berbasis penyedia layanan untuk alur kerja Standar

• Membuat konektor bawaan kustom berbasis penyedia layanan untuk alur kerja Standar

ISE dan konektor

Untuk alur kerja yang memerlukan akses langsung ke sumber daya di jaringan virtual Azure, Anda dapat membuat lingkungan layanan integrasi (ISE) khusus tempat Anda dapat membangun, menyebarkan, dan menjalankan alur kerja pada sumber daya khusus. Untuk informasi selengkapnya tentang membuat ISE, lihat Koneksi ke jaringan virtual Azure dari Azure Logic Apps.

Konektor kustom yang dibuat di dalam ISE tidak berfungsi dengan gateway data lokal. Namun, konektor tersebut dapat langsung mengakses sumber data lokal yang terhubung ke jaringan virtual Azure yang menghosting ISE. Jadi, alur kerja aplikasi logika di ISE kemungkinan besar tidak memerlukan gateway data saat berkomunikasi dengan sumber daya tersebut. Jika Anda memiliki konektor kustom yang Anda buat di luar ISE yang memerlukan gateway data lokal, alur kerja di ISE dapat menggunakan konektor tersebut.

Di perancang alur kerja, saat Anda menelusuri konektor bawaan atau konektor terkelola yang ingin Anda gunakan untuk alur kerja di ISE, label CORE muncul pada konektor bawaan, sementara label ISE muncul pada konektor terkelola yang dirancang untuk bekerja dengan ISE.

CORE

Konektor bawaan dengan label ini berjalan di ISE yang sama dengan alur kerja Anda.

ISE

Konektor terkelola dengan label ini berjalan di ISE yang sama dengan alur kerja Anda.

Jika Anda memiliki sistem lokal yang terhubung ke jaringan virtual Azure, ISE memungkinkan alur kerja Anda mengakses sistem tersebut secara langsung tanpa menggunakan gateway data lokal. Sebagai gantinya, Anda dapat menggunakan konektor ISE sistem jika tersedia, tindakan HTTP, atau konektor kustom.

Untuk sistem lokal yang tidak memiliki konektor ISE, gunakan gateway data lokal. Untuk menemukan konektor ISE yang tersedia, tinjau konektor ISE.

Tanpa label

Semua konektor lain tanpa label, yang dapat terus Anda gunakan, berjalan di layanan Logic Apps multi-penyewa global.

Masalah yang diketahui

Tabel berikut ini mencakup masalah yang diketahui untuk konektor di Azure Logic Apps:

Pesan kesalahan	Deskripsi	Resolusi
Error: BadGateway. Client request id: '{GUID}'	Kesalahan ini mengakibatkan pembaruan tag pada sumber daya aplikasi logika di mana satu atau beberapa koneksi tidak mendukung autentikasi Microsoft Entra ID OAuth, seperti SFTP ad SQL, memutus koneksi tersebut.	Untuk mencegah perilaku ini, hindari memperbarui tag tersebut.

Langkah berikutnya

Membuat alur kerja aplikasi logika Konsumsi - portal Azure

Membuat alur kerja aplikasi logika Standar - portal Azure