Autentikasi Microsoft Entra JWT dan otorisasi Azure RBAC untuk menerbitkan atau berlangganan pesan MQTT

Anda dapat mengautentikasi klien MQTT dengan Microsoft Entra JWT untuk menyambungkan ke namespace Layanan Event Grid. Anda dapat menggunakan kontrol akses berbasis peran Azure (Azure RBAC) untuk mengaktifkan klien MQTT, dengan identitas Microsoft Entra, untuk menerbitkan atau berlangganan akses ke ruang topik tertentu.

Penting

  • Fitur ini hanya didukung saat menggunakan versi protokol MQTT v5
  • Autentikasi JWT hanya didukung untuk Identitas Terkelola dan Perwakilan layanan

Prasyarat

Autentikasi menggunakan Microsoft Entra JWT

Anda dapat menggunakan paket MQTT v5 CONNECT untuk menyediakan token Microsoft Entra JWT untuk mengautentikasi klien Anda, dan Anda dapat menggunakan paket AUTH MQTT v5 untuk menyegarkan token.

Dalam paket CONNECT, Anda dapat memberikan nilai yang diperlukan di bidang berikut:

Bidang Nilai
Metode autentikasi OAUTH2-JWT
Data Autentikasi Token JWT

Dalam paket AUTH, Anda dapat memberikan nilai yang diperlukan di bidang berikut:

Bidang Nilai
Metode autentikasi OAUTH2-JWT
Data Autentikasi Token JWT
Kode Alasan Autentikasi 25

Autentikasi Kode Alasan dengan nilai 25 menandakan autentikasi ulang.

Catatan

  • Audiens: Klaim "aud" harus diatur ke "https://eventgrid.azure.net/".

Otorisasi untuk memberikan izin akses

Klien yang menggunakan autentikasi JWT berbasis ID Microsoft Entra perlu diotorisasi untuk berkomunikasi dengan namespace Layanan Event Grid. Anda dapat menetapkan dua peran bawaan berikut untuk menyediakan izin terbitkan atau berlangganan, kepada klien dengan identitas Microsoft Entra.

  • Menggunakan peran Penerbit EventGrid TopicSpaces untuk menyediakan akses penerbit pesan MQTT
  • Menggunakan peran Pelanggan EventGrid TopicSpaces untuk menyediakan akses pelanggan pesan MQTT

Anda dapat menggunakan peran ini untuk memberikan izin di langganan, grup sumber daya, namespace layanan Event Grid, atau cakupan ruang topik Event Grid.

Menetapkan peran penerbit ke identitas Microsoft Entra Anda di cakupan ruang topik

  1. Di portal Azure, navigasikan ke namespace Layanan Event Grid Anda
  2. Navigasikan ke ruang topik yang ingin Anda otorisasi aksesnya.
  3. Masuk ke halaman Kontrol akses (IAM) ruang topik
  4. Pilih tab Penetapan peran untuk melihat penetapan peran pada cakupan ini.
  5. Pilih + Tambahkan dan Tambahkan penetapan peran.
  6. Pada tab Peran, pilih peran "Penerbit Event Grid TopicSpaces".
  7. Pada tab Anggota, untuk Menetapkan akses ke, pilih Opsi pengguna, grup, atau perwakilan layanan untuk menetapkan peran yang dipilih ke satu atau beberapa perwakilan layanan (aplikasi).
  8. Pilih + Pilih anggota.
  9. Temukan dan pilih perwakilan layanan.
  10. Pilih Selanjutnya
  11. Pilih Tinjau + tetapkan pada tab Tinjau + tetapkan.

Catatan

Anda dapat mengikuti langkah serupa untuk menetapkan peran Pelanggan EventGrid TopicSpaces bawaan di cakupan ruang topik.

Langkah berikutnya