Bagikan melalui


Grup Klien

Grup klien memungkinkan Anda mengelompokkan sekumpulan klien bersama-sama berdasarkan kesamaan. Tujuan utama grup klien adalah untuk memudahkan konfigurasi otorisasi. Anda dapat mengotorisasi grup klien untuk menerbitkan atau berlangganan ruang topik. Semua klien dalam grup klien berwenang untuk melakukan tindakan terbitkan atau berlangganan pada ruang topik.

Di namespace layanan, kami menyediakan grup klien default bernama "$all". Grup klien menyertakan semua klien di namespace layanan. Untuk kemudahan pengujian, Anda dapat menggunakan $all untuk mengonfigurasi izin.

Catatan

  • Panjang nama grup klien bisa 3-50 karakter
  • Nama grup klien dapat mencakup alfanumerik, tanda hubung(-) dan, tanpa spasi
  • Nama grup klien harus unik per namespace
  • $all adalah grup klien default yang menyertakan semua klien di namespace layanan. Grup ini tidak dapat diedit atau dihapus

Pertimbangan grup klien

Anda harus menjaga kuantitas grup klien tetap kecil untuk membuat izin dapat dikelola.

Saat ini, maksimum 10 grup klien per namespace sebagai didukung.

Saat mengelompokkan klien, pastikan bahwa lebih mudah untuk menggunakan kembali grup untuk menerbitkan dan berlangganan di beberapa ruang topik. Untuk tujuan ini, penting untuk memikirkan skenario end-to-end untuk mengidentifikasi topik yang diterbitkan atau berlangganan setiap klien.

Sebaiknya identifikasi kesamaan di seluruh skenario, untuk menghindari fragmentasi grup klien dan ruang topik. Atur atribut klien yang cukup umum untuk mencapai pengelompokan sederhana dan hindari kueri grup yang sangat kompleks.

Bagaimana cara membuat kueri grup klien?

Untuk menyiapkan grup klien, Anda perlu membuat kueri yang memfilter sekumpulan klien berdasarkan nilai atributnya.

Berikut adalah beberapa contoh kueri:

  • (attributes.sensors = "motion" atau attributes.sensors = "humidity") atau attributes.type = "home-sensors"
  • attributes.sensors IN ["motion", "humidity", "temperature"] and attributes.floor <= 5
  • authenticationName IN ['client1', 'client2']

Dalam kueri grup, operand berikut diizinkan:

  • Operator kesetaraan "="
  • Tanda kurung "()" untuk mengelompokkan ekspresi untuk mengontrol urutan operasi
  • Operator logis "dan" , "atau" , "dan" memiliki prioritas yang lebih tinggi daripada "atau"
  • Operator tidak sama dalam dua bentuk "<>" dan "!="
  • Kurang dari "<", lebih besar dari ">", kurang dari sama dengan "<=", lebih besar dari sama dengan ">=" untuk nilai bilangan bulat panjang
  • "IN" untuk dibandingkan dengan sekumpulan nilai

Contoh skema grup klien

{
  "properties": {
    "description": "Description of client group",
    "query": "attributes.b IN ['a', 'b', 'c']"
  }
}

Konfigurasi portal Microsoft Azure

Gunakan langkah-langkah berikut untuk membuat grup klien:

  1. Buka namespace Anda di portal Azure

  2. Di bawah Grup klien, pilih + Grup klien.

    Cuplikan layar menambahkan grup klien.

  3. Tambahkan kueri grup klien.

    Cuplikan layar konfigurasi grup klien.

  4. Pilih Buat

Konfigurasi CLI Azure

Gunakan perintah berikut untuk membuat/menampilkan/menghapus grup klien

Membuat grup klien

az eventgrid namespace client-group create -g myRG --namespace-name myNS -n myCG 

Dapatkan grup klien

az eventgrid namespace client-group show -g myRG --namespace-name myNS -n myCG

Menghapus grup klien

az eventgrid namespace client-group delete -g myRG --namespace-name myNS -n myCG

Langkah berikutnya