Groupes de clients

  • Article

Les groupes de clients vous permettent de regrouper un ensemble de clients en fonction des points communs. L’objectif principal des groupes de clients est de faciliter la configuration de l’autorisation. Vous pouvez autoriser un groupe de clients à publier ou à s’abonner à un espace de rubrique. Tous les clients du groupe de clients sont autorisés à effectuer l’action de publication ou d’abonnement sur l’espace de rubrique.

Dans un espace de noms, nous fournissons un groupe de clients par défaut nommé « $all ». Le groupe de clients inclut tous les clients de l’espace de noms. Pour faciliter les tests, vous pouvez utiliser $all pour configurer des autorisations.

Notes

  • Le nom du groupe de clients peut avoir entre 3 et 50 caractères
  • Le nom du groupe de clients peut inclure des caractères alphanumériques, un trait d’union(-) et aucun espace
  • Le nom du groupe de clients doit être unique par espace de noms
  • $all est le groupe de clients par défaut qui inclut tous les clients de l’espace de noms. Impossible de modifier ou de supprimer ce groupe

Considérations relatives au groupe de clients

Vous devez limiter la quantité de groupes de clients pour que les autorisations soient gérables.

Actuellement, un maximum de 10 groupes de clients par espace de noms est pris en charge.

Lors du regroupement de clients, assurez-vous qu’il est plus facile de réutiliser le groupe pour publier et s’abonner sur plusieurs espaces de rubrique. À cette fin, il est important de réfléchir à des scénarios de bout en bout afin d'identifier les sujets que chaque client publie ou auxquels il s'abonne.

Nous vous recommandons d’identifier les points communs entre les scénarios afin d’éviter une fragmentation excessive des groupes de clients et des espaces de rubrique. Définissez les attributs client suffisamment génériques pour obtenir un regroupement simple et éviter les requêtes de groupe très complexes.

Comment créer des requêtes de groupe de clients ?

Pour configurer un groupe de clients, vous devez créer une requête qui filtre un ensemble de clients en fonction de leurs valeurs d’attribut.

Voici quelques exemples de requêtes :

  • (attributes.sensors = « motion » or attributes.sensors = « humidité ») ou attributes.type = « home-sensors »
  • attributes.sensors IN ["motion », « humidity », « temperature »] et attributes.floor <= 5
  • authenticationName IN ['client1', 'client2']

Dans les requêtes de groupe, les opérandes suivants sont autorisés :

  • Opérateur d'égalité « = »
  • Parenthèses « () » pour regrouper les expressions pour contrôler l’ordre des opérations
  • Opérateurs logiques « et » et « ou », « et » a une priorité supérieure à « ou »
  • Opérateur différent sous deux formes « <> » et « != »
  • Inférieur à « < », supérieur à « > », inférieur à « <= », supérieur à égal à « >= » pour les valeurs entières longues
  • « IN » à comparer avec un ensemble de valeurs

Exemple de schéma de groupe de clients

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

Configuration du portail Azure

Procédez comme suit pour créer un groupe de clients :

  1. Accédez à votre espace de noms dans le Portail Azure

  2. Sous Groupes de clients, sélectionnez + Groupe de clients.

    Capture d’écran de l’ajout d’un groupe de clients.

  3. Ajouter une requête de groupe de clients.

    Capture d'écran de la configuration du groupe de clients.

  4. Sélectionnez Créer

Configuration d’Azure CLI

Utilisez les commandes suivantes pour créer/afficher/supprimer un groupe de clients

Créer un groupe de clients

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

Obtenir un groupe de clients

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

Supprimer un groupe de clients

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

Étapes suivantes