Mengintegrasikan Azure Event Grid dengan Auth0

Artikel ini menjelaskan cara menghubungkan Auth0 dan akun Azure dengan membuat topik mitra Event Grid.

Catatan

Lihat kode jenis peristiwa Auth0 untuk mengetahui daftar lengkap peristiwa yang didukung Auth0

Mengirim peristiwa dari Auth0 ke Azure Event Grid

Untuk mengirim peristiwa Auth0 ke Azure:

1. Mendaftarkan penyedia sumber Event Grid dengan langganan Azure Anda.
2. Mengotorisasi mitra untuk membuat topik mitra di grup sumber daya Anda.
3. Minta Auth0 agar mengaktifkan alur kejadian ke topik mitra dengan menyiapkan topik mitra Auth0 di Dasbor Auth0.
4. Mengaktifkan topik mitra sehingga peristiwa Anda mulai mengalir ke topik mitra Anda.
5. Berlangganan peristiwa.

Mendaftarkan penyedia sumber Event Grid

Kecuali jika Event Grid telah digunakan sebelumnya, Anda harus mendaftarkan penyedia sumber daya Event Grid. Jika Anda pernah menggunakan Event Grid sebelumnya, lewati ke bagian berikutnya.

Di portal Azure, lakukan langkah-langkah berikut:

1. Di menu sebelah kiri, pilih Langganan.

2. Pilih langganan yang ingin Anda gunakan untuk Event Grid dari daftar langganan.

3. Pada halaman Langganan, pilih Penyedia sumber pada bagian Pengaturan di menu sebelah kiri.

4. Cari Microsoft.EventGrid, dan konfirmasikan bahwa Status Tidak Terdaftar.

5. Pilih Microsoft.EventGrid dalam daftar penyedia.

6. Pilih Daftar pada bilah perintah.

   

7. Refresh untuk memastikan status Microsoft.EventGrid diubah menjadi Terdaftar.

   

Mengotorisasi mitra untuk membuat topik mitra

Anda harus memberikan persetujuan Anda kepada mitra untuk membuat topik mitra dalam grup sumber daya yang Anda tetapkan. Otorisasi ini memiliki waktu kedaluwarsa. Ini efektif untuk jangka waktu yang Anda tentukan antara 1 hingga 365 hari.

Penting

Untuk sikap keamanan yang lebih besar, tentukan waktu kedaluwarsa minimum yang menawarkan cukup waktu kepada mitra untuk mengonfigurasi peristiwa Anda agar mengalir ke Event Grid dan untuk menyediakan topik mitra Anda. Mitra Anda tidak akan dapat membuat sumber daya (topik mitra) di langganan Azure Anda setelah waktu kedaluwarsa otorisasi.

Catatan

Event Grid mulai memberlakukan pemeriksaan otorisasi untuk membuat topik mitra sekitar 30 Juni 2022.

1. Masuk ke portal Azure.

2. Di bilah pencarian di bagian atas, masukkan Konfigurasi Mitra, dan pilih Konfigurasi Mitra Event Grid pada bagian Layanan di hasil.

3. Pada halaman Konfigurasi Mitra Event Grid, pilih tombol Buat konfigurasi mitra Event Grid di halaman (atau) pilih + Buat pada bilah perintah.

   

4. Pada halaman Buat Konfigurasi Mitra, lakukan langkah-langkah berikut:

   1. Di bagian Detail Proyek, pilih langganan Azure dan grup sumber daya tempat Anda ingin mengizinkan mitra membuat topik mitra.

   2. Di bagian Otorisasi Mitra, tentukan waktu kedaluwarsa default untuk otorisasi mitra yang ditentukan dalam konfigurasi ini.

   3. Untuk memberikan otorisasi Anda kepada mitra untuk membuat topik mitra di grup sumber daya yang ditentukan, pilih + tautan Otorisasi Mitra.

      

5. Pada halaman Tambahkan otorisasi mitra untuk membuat sumber daya, Anda melihat daftar mitra terverifikasi. Mitra terverifikasi adalah mitra yang identitasnya telah divalidasi oleh Microsoft. Ikuti langkah-langkah ini untuk mengotorisasi Auth0 untuk membuat topik mitra.

   1. Pilih mitra terverifikasi (Auth0, SAP, Tribal Group, atau Microsoft Graph API) dari daftar mitra terverifikasi.

   2. Tentukan waktu kedaluwarsa otorisasi.

   3. pilih Tambahkan.

      

      Penting

      Mitra Anda tidak akan dapat membuat sumber daya (topik mitra) di langganan Azure Anda setelah waktu kedaluwarsa otorisasi.

6. Kembali ke halaman Buat Konfigurasi Mitra, verifikasi bahwa mitra ditambahkan ke daftar otorisasi mitra di bagian bawah.

7. Pilih Tinjau + buat di bagian bawah halaman.

8. Pada halaman Tinjau, tinjau semua pengaturan, lalu pilih Buat untuk membuat pendaftaran mitra.

Menyiapkan topik mitra Auth0

Salah satu bagian dari proses integrasi adalah menyiapkan Auth0 untuk digunakan sebagai sumber kejadian dengan menggunakan Dasbor Auth0.

1. Masuk ke Dasbor Auth0.
2. Buka Memantau>Aliran.
3. Klik + Buat Aliran Log.
4. Pilih Azure Event Grid dan masukkan nama unik untuk aliran baru Anda.
5. Untuk ID Langganan, masukkan ID langganan Azure Anda.
6. Untuk Wilayah Azure, pilih wilayah Azure tempat grup sumber daya berada.
7. Untuk Grup Sumber Daya, masukkan nama grup sumber daya.
8. Untuk Filter menurut Kategori Kejadian, pilih Semua atau filter jenis kejadian tertentu.
9. Pilih opsi Gunakan hari dan waktu tertentu untuk memulai aliran jika Anda ingin agar streaming dimulai pada hari dan waktu tertentu.
10. Klik Simpan.

Anda akan melihat topik mitra di grup sumber daya yang Anda tentukan. Aktifkan topik mitra sehingga kejadian Anda mulai mengalir ke topik mitra Anda. Kemudian, berlangganan ke kejadian.

Mengaktifkan topik mitra

1. Di bilah pencarian portal Azure, cari dan pilih Topik Mitra Event Grid.

2. Pada halaman Topik Mitra Event Grid, pilih topik mitra dalam daftar.

   

3. Tinjau pesan aktivasi, dan pilih Aktifkan di halaman atau di bilah perintah untuk mengaktifkan topik mitra sebelum waktu kedaluwarsa yang disebutkan di halaman.

   

4. Konfirmasikan bahwa status aktivasi diatur ke Diaktifkan lalu buat langganan peristiwa untuk topik mitra dengan memilih + Langganan Peristiwa di bilah perintah.

   

Berlangganan Peristiwa

Pertama, buat penanganan aktivitas yang akan menangani peristiwa dari mitra. Misalnya, buat hub peristiwa, antrean atau topik Azure Service Bus, atau fungsi Azure. Kemudian, buat langganan peristiwa untuk topik mitra menggunakan penanganan aktivitas yang Anda buat.

Buat penanganan aktivitas

Untuk menguji topik mitra Anda, Anda memerlukan penanganan aktivitas. Buka langganan Azure Anda dan jalankan layanan yang didukung sebagai penanganan aktivitas seperti Azure Function. Sebagai contoh, lihat sampel Penampil Event Grid yang dapat Anda gunakan sebagai penanganan aktivitas melalui webhook.

Berlangganan topik mitra

Berlangganan topik mitra memberi tahu Event Grid tempat Anda ingin peristiwa mitra Anda dikirimkan.

1. Di portal Azure, ketik Topik Mitra Event Grid di kotak pencarian, dan pilih Topik Mitra Event Grid.

2. Pada halaman Topik Mitra Event Grid, pilih topik mitra dalam daftar.

   

3. Pada halaman Topik Mitra Event Grid untuk topik mitra, pilih + Langganan Peristiwa di bilah perintah.

   

4. Pada halaman Buat Langganan Peristiwa, lakukan langkah-langkah berikut ini:

   1. Masukkan nama untuk langganan acara.

   2. Untuk Filter ke Jenis Peristiwa, pilih jenis peristiwa yang akan diterima langganan Anda.

   3. Untuk Jenis Titik Akhir, pilih layanan Azure (Azure Function, Storage Queues, Event Hubs, Bus Layanan Queue, Bus Layanan Topic, Hybrid Koneksi ions, dll.), atau webhook.

   4. Klik link Pilih titik akhir. Dalam contoh ini, mari gunakan tujuan atau titik akhir Azure Event Hubs.

      

   5. Pada halaman Pilih Event Hub, pilih konfigurasi untuk titik akhir, lalu pilih Konfirmasi Pilihan.

      

   6. Sekarang di halaman Membuat Langganan Peristiwa, pilih Buat.

      

Coba gunakan salah satu tindakan Auth0 yang memicu peristiwa yang akan diterbitkan untuk melihat aliran peristiwa.

Memverifikasi integrasi

Untuk memverifikasi bahwa integrasi berfungsi sesuai harapan:

1. Masuk ke Dasbor Auth0.
2. Buka Memantau>Aliran.
3. Klik Aliran Event Grid Anda.
4. Setelah di aliran, klik tab Kesehatan. Aliran akan aktif dan selama Anda tidak melihat kesalahan apa pun, aliran tersebut berfungsi.

Upaya dan coba lagi pengiriman

Peristiwa Auth0 dikirim ke Azure melalui mekanisme streaming. Setiap kejadian dikirim karena dipicu di Auth0. Jika Event Grid tidak dapat menerima peristiwa, Auth0 akan mencoba lagi hingga tiga kali untuk mengirim peristiwa. Jika tidak, Auth0 akan mencatat kegagalan untuk dikirim dalam sistemnya.

Langkah berikutnya

• Topik Mitra Auth0
• Ringkasan topik mitra
• Menjadi mitra Event Grid