Klientské skupiny

  • Článek

Skupiny klientů umožňují seskupit sadu klientů na základě společných rysů. Hlavním účelem skupin klientů je usnadnit konfiguraci autorizace. Skupinu klientů můžete autorizovat k publikování nebo přihlášení k odběru prostoru tématu. Všichni klienti ve skupině klientů mají oprávnění k provedení akce publikování nebo přihlášení k odběru v prostoru tématu.

V oboru názvů poskytujeme výchozí skupinu klientů s názvem "$all". Skupina klientů zahrnuje všechny klienty v oboru názvů. Pro usnadnění testování můžete ke konfiguraci oprávnění použít $all.

Poznámka:

  • Název skupiny klientů může mít délku 3 až 50 znaků.
  • Název skupiny klientů může obsahovat alfanumerické znaky, pomlčky (-) a bez mezer.
  • Název skupiny klientů musí být jedinečný pro každý obor názvů.
  • $all je výchozí skupina klientů, která zahrnuje všechny klienty v oboru názvů. Tuto skupinu nelze upravit ani odstranit.

Důležité informace o skupině klientů

Měli byste zachovat malé množství skupin klientů, aby bylo možné spravovat oprávnění.

V současné době se podporuje maximálně 10 skupin klientů na obor názvů.

Při seskupování klientů se ujistěte, že je jednodušší skupinu znovu použít k publikování a přihlášení k odběru napříč několika mezerami témat. Pro tento účel je důležité si promyslet kompletní scénáře, abyste identifikovali témata, která každý klient publikuje nebo odebírá.

Doporučujeme identifikovat běžné situace ve scénářích, abyste se vyhnuli fragmentaci skupin klientů a prostorů témat. Nastavte obecné atributy klienta, abyste dosáhli jednoduchého seskupení a vyhnuli se vysoce složitým dotazům na skupiny.

Jak vytvořit dotazy na skupinu klientů?

Pokud chcete nastavit skupinu klientů, musíte vytvořit dotaz, který filtruje sadu klientů na základě hodnot jejich atributů.

Tady je několik ukázkových dotazů:

  • (attributes.sensors = "motion" nebo attributes.sensors = "vlhkost") nebo atributy.type = "home-sensors"
  • attributes.sensors IN ["motion", "vlhkost", "teplota"] a atributy.floor <= 5
  • authenticationName IN ['client1', 'client2']

Ve skupinových dotazech jsou povoleny následující operandy:

  • Operátor rovnosti "="
  • Závorky () pro seskupení výrazů za účelem řízení pořadí operací
  • Logické operátory "and" , "or" , "a" mají vyšší prioritu než "nebo"
  • Operátor nerovná se ve dvou formách "<>" a "!="
  • Menší než "<", větší než ">", menší než rovno "<=", větší než rovno ">=" pro dlouhé celočíselné hodnoty
  • "IN" pro porovnání se sadou hodnot

Ukázkové schéma skupiny klientů

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

Konfigurace webu Azure Portal

Pomocí následujícího postupu vytvořte skupinu klientů:

  1. Přechod na obor názvů na webu Azure Portal

  2. V části Skupiny klientů vyberte + Skupina klientů.

    Snímek obrazovky s přidáním skupiny klientů

  3. Přidání dotazu na skupinu klientů

    Snímek obrazovky s konfigurací skupiny klientů

  4. Vyberte příkaz Vytvořit.

Konfigurace Azure CLI

K vytvoření, zobrazení nebo odstranění skupiny klientů použijte následující příkazy.

Vytvoření skupiny klientů

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

Získání skupiny klientů

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

Odstranění skupiny klientů

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

Další kroky