Ringkasan Peristiwa Mitra untuk mitra - Azure Event Grid

Artikel
04/12/2023

Peristiwa Mitra Event Grid memungkinkan pelanggan untuk berlangganan peristiwa yang berasal dari sistem terdaftar menggunakan mekanisme yang sama yang akan digunakan untuk sumber peristiwa lain di Azure, seperti layanan Azure. Sistem terdaftar tersebut terintegrasi dengan Event Grid yang dikenal sebagai "mitra". Fitur ini juga memungkinkan pelanggan untuk mengirim peristiwa ke sistem mitra yang mendukung penerimaan dan perutean peristiwa ke solusi/titik akhir pelanggan di platform mereka. Biasanya, mitra adalah penyedia perangkat lunak sebagai layanan (SaaS) atau ERP, tetapi mitra mungkin merupakan platform perusahaan yang ingin membuat peristiwa tersedia untuk tim internal. Mitra sengaja berintegrasi dengan Event Grid untuk mewujudkan kasus penggunaan pelanggan menyeluruh yang berakhir di Azure (pelanggan berlangganan peristiwa yang dikirim oleh mitra) atau berakhir di sistem mitra (pelanggan berlangganan peristiwa Microsoft yang dikirim oleh Azure Event Grid). Pelanggan mengandalkan Azure Event Grid untuk mengirim peristiwa yang diterbitkan oleh mitra ke tujuan yang didukung seperti webhook, Azure Functions, Azure Event Hubs, atau Azure Service Bus, untuk beberapa nama. Pelanggan juga mengandalkan Azure Event Grid untuk merutekan peristiwa yang berasal dari layanan Microsoft, seperti Outlook, Teams, atau MICROSOFT Entra ID, sehingga solusi pelanggan dapat bereaksi terhadapnya. Dengan Peristiwa Mitra, pelanggan dapat membangun solusi berbasis peristiwa di seluruh platform dan batas jaringan untuk menerima atau mengirim peristiwa dengan andal, aman, dan dalam skala besar.

Catatan

Ini adalah artikel konseptual yang wajib dibaca sebelum Anda memutuskan untuk onboard sebagai mitra Azure Event Grid. Untuk petunjuk langkah demi langkah tentang cara bergabung sebagai mitra Event Grid menggunakan portal Azure, lihat Cara onboard sebagai mitra Event Grid (portal Azure).

Peristiwa Mitra: Cara kerjanya

Sebagai mitra, Anda membuat sumber daya Event Grid yang memungkinkan Anda menerbitkan peristiwa ke Azure Event Grid sehingga pelanggan di Azure dapat berlangganan ke peristiwa tersebut. Untuk sebagian besar mitra, misalnya penyedia SaaS, ini adalah satu-satunya kemampuan integrasi yang akan digunakan.

Anda juga dapat membuat sumber daya Event Grid untuk menerima peristiwa dari Azure Event Grid. Kasus penggunaan ini adalah untuk organisasi yang memiliki atau mengelola platform yang memungkinkan pelanggannya menerima peristiwa dengan mengekspos titik akhir. Beberapa dari organisasi tersebut adalah sistem ERP yang juga memiliki kemampuan perutean peristiwa dalam platformnya, yang mengirimkan peristiwa Azure yang masuk ke aplikasi pelanggan yang dihosting di platformnya.

Untuk menerbitkan peristiwa atau menerima peristiwa, Anda membuat sumber daya Event Grid yang sama dengan mengikuti langkah-langkah umum ini.

Hubungi tim Event Grid untuk askgrid@microsoft.com mengomunikasikan minat Anda untuk menjadi mitra. Setelah Anda menghubungi kami, kami akan memandu Anda melalui proses onboarding dan membantu layanan Anda mendapatkan kartu masuk di galeri Azure Event Grid kami sehingga layanan Anda dapat ditemukan di portal Azure.
Buat pendaftaran mitra. Ini adalah sumber daya global dan Anda biasanya perlu membuatnya sekali.
Buat namespace layanan mitra. Sumber daya ini mengekspos titik akhir tempat Anda dapat menerbitkan peristiwa ke Azure. Saat membuat namespace layanan mitra, berikan pendaftaran mitra yang Anda buat.
Pelanggan mengotorisasi Anda untuk membuat topik mitra di langganan Azure pelanggan.
Pelanggan mengakses halaman web Anda atau menjalankan perintah, Anda tentukan pengalaman pengguna, untuk meminta aliran peristiwa Anda ke Azure atau kemampuan untuk menerima peristiwa Microsoft ke dalam sistem Anda. Menanggapi permintaan tersebut, Anda siapkan sistem Anda untuk melakukannya dengan input dari pelanggan. Misalnya, pelanggan mungkin memiliki opsi untuk memilih peristiwa tertentu dari sistem Anda yang harus diteruskan ke Azure.
Buat topik mitra di langganan Azure pelanggan dan grup sumber daya dengan menggunakan saluran. Saluran adalah sumber daya yang terkandung oleh namespace mitra.
Pelanggan mengaktifkan topik mitra yang Anda buat di langganan Azure dan grup sumber daya mereka.
Mulai menerbitkan peristiwa ke namespace mitra Anda.

Catatan

Anda harus mendaftarkan penyedia sumber Azure Event Grid ke setiap langganan Azure tempat Anda ingin membuat sumber daya Event Grid. Jika tidak, operasi untuk membuat sumber daya akan gagal.

Mengapa saya harus menggunakan Peristiwa Mitra?

Anda mungkin ingin menggunakan fitur Peristiwa Mitra jika Anda memiliki satu atau beberapa persyaratan berikut.

Untuk mitra sebagai penerbit peristiwa

Anda ingin mekanisme untuk membuat peristiwa Anda tersedia untuk pelanggan Anda di Azure. Pengguna Anda dapat memfilter dan merutekan peristiwa tersebut dengan menggunakan topik mitra dan langganan peristiwa yang mereka miliki dan kelola. Anda dapat menggunakan pendekatan integrasi lain seperti topik dan domain. Namun, pendekatan tersebut tidak akan memungkinkan pemisahan yang bersih antara kepemilikan sumber daya, manajemen, dan penagihan antara Anda dan pelanggan. Fitur Peristiwa Mitra juga memberikan pengalaman pengguna yang lebih intuitif yang memudahkan untuk menemukan layanan Anda.
Anda memerlukan model multi-penyewa sederhana tempat Anda menerbitkan peristiwa ke satu titik akhir regional, titik akhir namespace layanan, untuk merutekan peristiwa ke pelanggan yang berbeda.
Anda ingin memiliki visibilitas ke dalam metrik yang terkait dengan peristiwa yang diterbitkan.
Anda ingin menggunakan skema Cloud Events 1.0 untuk peristiwa Anda.

Untuk mitra sebagai pelanggan

Anda ingin layanan Anda bereaksi terhadap peristiwa pelanggan yang berasal dari Microsoft Azure.
Anda ingin pelanggan Anda bereaksi terhadap peristiwa layanan Microsoft Azure menggunakan aplikasinya yang dihosting oleh platform Anda. Anda menggunakan kemampuan perutean peristiwa platform Anda untuk mengirimkan peristiwa ke solusi pelanggan yang tepat.
Anda menginginkan model sederhana di mana pelanggan Anda cukup memilih nama layanan Anda sebagai tujuan tanpa perlu mereka mengetahui detail teknis seperti titik akhir platform Anda.
Sistem/platform Anda mendukung skema Cloud Events 1.0.

Sumber daya yang dikelola oleh mitra

Sebagai mitra, Anda mengelola jenis sumber daya berikut.

Pendaftaran mitra

Pendaftaran menyimpan informasi umum yang terkait dengan mitra. Pendaftaran diperlukan saat membuat namespace layanan mitra. Artinya, Anda harus memiliki pendaftaran mitra untuk membuat sumber daya Azure yang diperlukan untuk diintegrasikan dengan Azure Event Grid.

Pendaftaran global. Artinya, mereka tidak terkait dengan wilayah Azure tertentu. Anda dapat membuat pendaftaran mitra tunggal dan menggunakannya saat membuat namespace layanan mitra Anda.

Saluran

Saluran adalah sumber daya berlapis ke Namespace Layanan Mitra. Saluran memiliki dua tujuan utama:

Ini adalah jenis sumber daya yang memungkinkan Anda membuat sumber daya mitra pada langganan Azure pelanggan. Saat Anda membuat saluran jenis partner topic, topik mitra dibuat pada langganan Azure pelanggan. Topik mitra adalah sumber daya pelanggan tempat peristiwa dirutekan saat sistem mitra menerbitkan peristiwa.

Saluran memiliki siklus hidup yang sama dengan topik atau tujuan mitra pelanggan terkait. Jika saluran jenis partner topic dihapus, misalnya, topik mitra pelanggan terkait akan dihapus. Demikian pula, jika topik mitra dihapus oleh pelanggan, saluran terkait pada langganan Azure Anda akan dihapus.
Ini adalah sumber daya yang digunakan untuk merutekan peristiwa. Saluran jenis partner topic digunakan untuk mengarahkan peristiwa ke topik mitra pelanggan. Ini mendukung dua jenis mode perutean.
- Perutean nama saluran. Dengan perutean semacam ini, Anda menerbitkan peristiwa menggunakan header http yang disebut aeg-channel-name tempat Anda memberikan nama saluran tempat peristiwa harus dirutekan. Karena saluran adalah representasi mitra dari topik mitra, peristiwa yang diarahkan ke saluran menunjukkan topik mitra pelanggan. Jenis perutean ini adalah kemampuan baru yang tidak ada di event channels, yang hanya mendukung perutean berbasis sumber. Perutean nama saluran memungkinkan lebih banyak kasus penggunaan daripada perutean berbasis sumber dan itu adalah mode perutean yang disarankan untuk dipilih. Misalnya, dengan perutean nama saluran, pelanggan dapat meminta peristiwa yang berasal dari sumber peristiwa yang berbeda untuk masuk di satu topik mitra.
- Perutean berbasis sumber. Pendekatan perutean ini didasarkan pada nilai atribut konteks source dalam peristiwa tersebut. Sumber dipetakan ke saluran dan ketika suatu peristiwa datang dengan sumber, katakanlah, bernilai "A", peristiwa tersebut dirutekan ke topik mitra yang terkait dengan saluran yang berisi "A" di properti sumbernya.
Anda mungkin ingin mendeklarasikan jenis peristiwa yang dirutekan ke saluran dan ke topik mitra terkait. Jenis peristiwa ditampilkan kepada pelanggan saat membuat langganan peristiwa pada topik mitra dan digunakan untuk memilih jenis peristiwa tertentu untuk dikirim ke tujuan penanganan aktivitas. Pelajari selengkapnya.

Penting

Jenis peristiwa dapat dikelola di saluran dan setelah nilai diperbarui, perubahan segera tercermin pada topik mitra terkait.

Namespace layanan mitra

Namespace layanan mitra adalah sumber daya regional yang memiliki titik akhir untuk menerbitkan peristiwa ke Azure Event Grid. Namespace layanan mitra berisi saluran atau saluran peristiwa (sumber daya lama). Anda harus membuat namespace layanan mitra di wilayah tempat pelanggan meminta topik atau tujuan mitra karena saluran dan sumber daya mitra yang sesuai harus berada di wilayah yang sama. Anda tidak dapat memiliki saluran di wilayah tertentu dengan topik mitra terkait, misalnya, terletak di wilayah yang berbeda.

Namespace layanan mitra berisi saluran atau Saluran peristiwa. Ini ditentukan oleh mode perutean topik mitra properti di namespace layanan. Jika diatur ke Header nama saluran, saluran adalah satu-satunya jenis sumber daya yang dapat dibuat di bagian namespace layanan. Jika mode perutean topik mitra diatur ke Atribut sumber dalam peristiwa, namespace layanan hanya dapat berisi saluran peristiwa. Ingatlah bahwa keputusan mengatur partner topic routing mode yang benar bukanlah keputusan antara memilih nama saluran atau perutean berbasis sumber. Saluran mendukung keduanya. Ini lebih merupakan keputusan antara menggunakan jenis baru sumber daya perutean, saluran, versus menggunakan sumber daya lama, saluran peristiwa.

Saluran Kejadian

Saluran Peristiwa adalah sumber daya yang pertama kali dirilis dengan Peristiwa Mitra untuk mengarahkan peristiwa yang masuk ke topik mitra. Saluran peristiwa hanya mendukung perutean berbasis sumber dan selalu mewakili topik mitra pelanggan.

Penting

Saluran peristiwa tidak digunakan lagi. Oleh karena itu, disarankan agar Anda menggunakan Saluran.

Mitra terverifikasi

Mitra terverifikasi adalah organisasi mitra yang identitasnya telah divalidasi oleh Microsoft. Sangat disarankan agar organisasi Anda diverifikasi. Pelanggan berusaha untuk terlibat dengan mitra yang telah diverifikasi karena verifikasi tersebut memberikan jaminan yang lebih besar bahwa mereka berurusan dengan organisasi yang sah. Setelah diverifikasi, Anda mendapat keuntungan dari kehadiran di Galeri Event Grid tempat pelanggan dapat menemukan layanan Anda dengan mudah dan mendapatkan pengalaman pihak pertama saat berlangganan peristiwa Anda, misalnya.

Otorisasi pelanggan untuk membuat topik mitra

Pelanggan mengotorisasi Anda untuk membuat topik mitra di langganan Azure mereka. Otorisasi diberikan untuk grup sumber daya tertentu dalam langganan Azure pelanggan dan terikat waktu. Anda harus membuat saluran sebelum tanggal kedaluwarsa yang diatur oleh pelanggan. Anda harus memiliki dokumentasi yang menyarankan pelanggan rentang waktu yang memadai untuk mengonfigurasi sistem Anda guna mengirim atau menerima peristiwa dan untuk membuat saluran sebelum otorisasi berakhir. Jika Anda mencoba membuat saluran tanpa otorisasi atau setelah kedaluwarsa, pembuatan saluran akan gagal dan tidak ada sumber daya yang akan dibuat pada langganan Azure pelanggan.

Catatan

Event Grid mulai memberlakukan pemeriksaan otorisasi untuk membuat topik mitra sekitar 30 Juni 2022. Dokumentasi Anda harus meminta pelanggan Anda untuk memberi Anda otorisasi sebagai prasyarat sebelum Anda membuat saluran.

Penting

Mitra terverifikasi bukanlah mitra terotorisasi. Bahkan jika mitra telah diperiksa oleh Microsoft, Anda masih perlu diotorisasi sebelum Anda dapat membuat topik mitra di langganan Azure pelanggan.

Aktivasi topik mitra

Pelanggan mengaktifkan topik mitra atau tujuan yang Anda buat untuk mereka. Pada saat itu, status aktivasi saluran berubah menjadi Diaktifkan. Setelah saluran diaktifkan, Anda dapat mulai menerbitkan peserta ke titik akhir namespace layanan mitra yang berisi saluran tersebut.

Bagaimana Anda mengotomatiskan proses untuk mengetahui kapan Anda dapat mulai menerbitkan peristiwa untuk topik mitra tertentu?

Anda memiliki dua pilihan:

Baca (polling) status saluran secara berkala untuk memeriksa apakah status aktivasi telah dialihkan dari NeverActivated ke Diaktifkan. Operasi ini bisa menjadi komputasi yang intensif.
Buat langganan peristiwa untuk langganan Azure atau grup sumber daya yang berisi saluran yang ingin Anda pantau. Anda akan menerima peristiwa Microsoft.Resources.ResourceWriteSuccess setiap kali saluran diperbarui. Anda kemudian harus membaca status saluran dengan ID Azure Resource Manager yang diberikan untuk memastikan bahwa pembaruan terkait dengan perubahan status aktivasi menjadi Diaktifkan.