Tentang konektor di Azure Logic Apps

Ketika Anda membangun alur kerja menggunakan Azure Logic Apps, Anda dapat menggunakan konektor untuk membantu Anda dengan cepat dan mudah mengakses data, peristiwa, dan sumber daya di aplikasi, layanan, sistem, protokol, dan platform lain - sering kali tanpa menulis kode apa pun. Konektor menyediakan operasi bawaan yang dapat Anda gunakan sebagai langkah dalam alur kerja Anda. Azure Logic Apps menyediakan ratusan konektor yang dapat Anda gunakan. Jika tidak ada konektor yang tersedia untuk sumber daya yang ingin Anda akses, Anda dapat menggunakan operasi HTTP generik untuk berkomunikasi dengan layanan, atau Anda dapat membuat konektor kustom.

Gambaran umum ini memberikan pengenalan tingkat tinggi pada konektor dan cara kerjanya secara umum.

Apa itu konektor?

Secara teknis, banyak konektor menyediakan proksi atau pembungkus di sekitar API yang digunakan layanan dasar untuk berkomunikasi dengan Azure Logic Apps. Konektor ini menyediakan operasi yang Anda gunakan dalam alur kerja Anda untuk melakukan tugas. Operasi tersedia baik sebagai pemicu atau tindakan dengan properti yang dapat Anda konfigurasikan. Beberapa pemicu dan tindakan juga mengharuskan Anda terlebih dahulu membuat dan mengonfigurasi koneksi ke layanan atau sistem yang mendasarinya, misalnya, sehingga Anda dapat mengautentikasi akses ke akun pengguna. Untuk informasi gambaran umum selengkapnya, tinjau Gambaran umum konektor untuk Azure Logic Apps, Microsoft Power Automate, dan Microsoft Power Apps.

Untuk informasi tentang konektor yang lebih populer dan umum digunakan di Azure Logic Apps, tinjau dokumentasi berikut:

Pemicu

Pemicu menentukan peristiwa yang memulai alur kerja 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 pendorongan, tetapi terkadang, pemicu tersedia di kedua versi.

  • 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 dorong mendengarkan data baru atau peristiwa yang 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 mungkin ingin menyusun alur kerja yang melakukan sesuatu ketika file diunggah ke server FTP Anda. Sebagai langkah pertama dalam alur kerja Anda, Anda dapat menggunakan pemicu FTP bernama Ketika file ditambahkan atau dimodifikasi, yang mengikuti pola polling. Anda kemudian dapat menentukan jadwal untuk memeriksa peristiwa upload secara berkala.

Pemicu juga meneruskan input dan data lain yang diperlukan ke dalam alur kerja Anda tempat tindakan nantinya dapat mereferensikan dan menggunakan data tersebut di seluruh alur kerja. Misalnya, Anda ingin menggunakan pemicu Outlook Office 365 bernama Ketika ada email baru untuk memulai alur kerja jika Anda mendapatkan email baru. Anda dapat mengonfigurasi pemicu ini untuk meneruskan konten dari setiap email baru, seperti pengirim, baris subjek, isi, lampiran, dan sebagainya. Alur kerja Anda kemudian dapat memproses informasi tersebut dengan menggunakan tindakan lain.

Tindakan

Tindakan adalah operasi yang mengikuti pemicu dan melakukan beberapa jenis tugas di alur kerja Anda. Anda dapat menggunakan beberapa tindakan di alur kerja Anda. Misalnya, Anda mungkin memulai alur kerja dengan pemicu SQL yang mendeteksi data pelanggan baru dalam database SQL. Mengikuti pemicunya, alur kerja Anda bisa menyuruh tindakan SQL mendapatkan data pelanggan. Mengikuti tindakan SQL, alur kerja Anda bisa memiliki tindakan berbeda yang memproses data.

Kategori konektor

Di Azure Logic Apps, sebagian besar pemicu dan tindakan tersedia dalam versi bawaan atau versi konektor terkelola. Beberapa pemicu dan tindakan tersedia di kedua versi. Versi yang tersedia bergantung pada apakah Anda membuat aplikasi logika Konsumsi yang berjalan di Azure Logic Apps multi-penyewa, atau aplikasi logika Standar yang berjalan di Azure Logic Apps penyewa tunggal.

  • Konektor bawaan berjalan secara asli pada runtime Azure Logic Apps.

  • Konektor terkelola disebarkan, dihosting, dan dikelola oleh Microsoft. Konektor tersebut menyediakan pemicu dan tindakan untuk layanan cloud, sistem lokal, atau keduanya.

    Dalam aplikasi logika Standar, semua konektor terkelola diatur sebagai konektor Azure. Namun, dalam aplikasi logika Konsumsi, konektor terkelola diatur sebagai Standar atau Enterprise, berdasarkan tingkat harga.

Untuk mengetahui informasi selengkapnya tentang jenis aplikasi logika, tinjau Perbedaan jenis sumber daya dan lingkungan host.

Konfigurasi koneksi

Di aplikasi logika Konsumsi, sebelum Anda dapat membuat atau mengelola aplikasi logika dan koneksinya, Anda memerlukan izin tertentu. Untuk informasi selengkapnya tentang izin ini, tinjau Operasi aman - Mengamankan akses dan data di Azure Logic Apps.

Sebelum Anda dapat menggunakan pemicu atau tindakan konektor terkelola dalam alur kerja Anda, sebagian besar konektor mengharuskan Anda membuat koneksi terlebih dahulu ke layanan atau sistem target. Untuk membuat koneksi dari dalam perancang alur kerja aplikasi logika, Anda harus mengautentikasi identitas Anda dengan info masuk 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 aplikasi logika Konsumsi atau Standar:

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 Autentikasi Terbuka Azure Active Directory (Azure AD OAuth), seperti Office 365, Salesforce, dan GitHub, mengharuskan Anda masuk, tetapi Azure Logic Apps hanya menyimpan akses dan menyegarkan token sebagai rahasia, bukan mandat masuk.

Koneksi yang dibuat dapat mengakses layanan atau sistem target selama layanan atau sistem tersebut memungkinkan. Untuk layanan yang menggunakan koneksi OAuth Azure Active Directory, seperti Office 365 dan Dynamics, Azure Logic Apps merefresh token akses tanpa batas. 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.

Tip

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 aplikasi dan koneksi logika, tinjau akses dan data aman 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 Outlook Office 365 atau konektor SQL, atau menggunakan konektor kustom, firewall Anda juga perlu mengizinkan akses untuk semuaalamat IP keluar konektor terkelola di wilayah Azure aplikasi logika. Untuk informasi selengkapnya, tinjau Konfigurasi Firewall.

Konektor dan API kustom

Di aplikasi logika Konsumsi yang berjalan di Azure Logic Apps multi-penyewa, Anda dapat memanggil API berbasis Swagger atau berbasis SOAP yang tidak tersedia sebagai konektor siap pakai. Anda juga dapat menjalankan kode kustom dengan membuat Aplikasi API kustom. Untuk informasi selengkapnya, baca dokumentasi berikut ini:

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

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 pembuatan ISES, tinjau Menghubungkan 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, aplikasi logika dalam ISE kemungkinan besar tidak memerlukan gateway data saat berkomunikasi dengan sumber daya tersebut. Jika Anda memiliki konektor kustom yang dibuat di luar ISE dan memerlukan gateway data lokal, aplikasi logika di ISE dapat menggunakan konektor tersebut.

Di perancang alur kerja, saat Anda menelusuri konektor bawaan dan konektor terkelola yang ingin digunakan untuk aplikasi logika di dalam ISE, label CORE muncul pada konektor bawaan, sementara label ISE muncul di konektor terkelola yang dirancang untuk berfungsi dengan ISE.

Contoh konektor CORE

CORE

Konektor bawaan dengan label ini berjalan di ISE yang sama dengan aplikasi logika Anda.

Contoh konektor ISE

ISE

Konektor terkelola dengan label ini berjalan di ISE yang sama dengan aplikasi logika 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.

Contoh konektor non-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 menyertakan masalah yang diketahui untuk konektor Logic Apps.

Pesan kesalahan Deskripsi Resolusi
Error: BadGateway. Client request id: '{GUID}' Kesalahan ini disebabkan oleh pembaruan tag pada aplikasi logika sehingga satu atau beberapa koneksi tidak mendukung autentikasi OAuth Azure Active Directory (Azure AD), seperti SFTP iklan SQL, yang memutuskan koneksi tersebut. Untuk mencegah perilaku ini, hindari memperbarui tag tersebut.

Langkah berikutnya