Gérer les utilisateurs et rôles dans votre application Azure IoT Central

Cet article explique comment vous pouvez ajouter, modifier et supprimer des utilisateurs dans votre application Azure IoT Central. L’article explique également comment gérer des rôles dans votre application.

Pour accéder à la section Autorisations et l’utiliser, vous devez avoir le rôle Administrateur d’application pour une application Azure IoT Central ou un rôle personnalisé incluant des autorisations d’administration. Si vous créez une application Azure IoT Central, le rôle Administrateur d’application vous est automatiquement attribué pour cette application.

Pour savoir comment gérer les utilisateurs et les rôles à l’aide de l’API REST IoT Central, consultez Comment utiliser l’API REST IoT Central pour gérer les utilisateurs et les rôles.

Ajouter des utilisateurs

Chaque utilisateur doit disposer d’un compte d’utilisateur pour pouvoir se connecter à une application et y accéder. IoT Central prend en charge des comptes d’utilisateur Microsoft, des comptes Microsoft Entra, des groupes Microsoft Entra et des principaux de service Microsoft Entra. Pour découvrir plus d’informations, consultez Aide sur le Compte Microsoft et Démarrage rapide : Ajouter de nouveaux utilisateurs à Microsoft Entra ID.

1. Pour ajouter un utilisateur à une application IoT Central, accédez à la page Utilisateurs dans la section Autorisations :

   

2. Pour ajouter un utilisateur, dans la page Utilisateurs, choisissez + Attribuer un utilisateur. Pour ajouter un principal de service sur la page Utilisateurs, choisissez + Affecter un principal de service. Pour ajouter un groupe Microsoft Entra dans la page Utilisateurs, choisissez + Affecter un groupe. Commencez à entrer le nom du groupe ou du principal de service Active Directory pour remplir automatiquement le formulaire.

   Remarque

   Les principaux de service et les groupes Active Directory doivent appartenir au même tenant Microsoft Entra que l’abonnement Azure associé à l’application IoT Central.

3. Si votre application utilise des organisations, choisissez une organisation à attribuer à l’utilisateur dans le menu déroulant Organisation.

4. Choisissez un rôle pour l’utilisateur dans la liste déroulante Rôle. Découvrez plus d’informations sur les rôles dans la section Gérer les rôles de cet article :

   

   Les rôles disponibles dépendent de l’organisation à laquelle l’utilisateur est associé. Vous pouvez attribuer des rôles Application à des utilisateurs associés à l’organisation racine, et des rôles Organisation à des utilisateurs associés à toute autre organisation figurant dans la hiérarchie.

   Remarque

   Un utilisateur qui se trouve dans un rôle personnalisé qui lui accorde l’autorisation d’ajouter d’autres utilisateurs peut uniquement ajouter des utilisateurs à un rôle avec des autorisations identiques ou moins nombreuses que son propre rôle.

   Lorsque vous invitez un nouvel utilisateur, vous devez lui partager l’URL de l’application et lui demander de se connecter. Une fois l’utilisateur connecté pour la première fois, l’application apparaît dans la page Mes applications de l’utilisateur.

   Remarque

   Si un utilisateur est supprimé de Microsoft Entra ID puis rajouté, il ne peut pas se connecter à l’application IoT Central. Pour réactiver l’accès, l’administrateur de l’application doit également supprimer et rajouter l’utilisateur dans l’application.

Les limitations suivantes s’appliquent aux groupes et principaux de service Microsoft Entra :

• Le nombre total de groupes Microsoft Entra pour chaque application IoT Central ne peut pas dépasser 20.
• Le nombre total de groupes Microsoft Entra uniques provenant du même tenant Microsoft Entra ne peut pas dépasser 200 pour toutes les applications IoT Central.
• Les principaux de service qui font partie d’un groupe Microsoft Entra ne sont pas automatiquement autorisés à accéder à l’application. Les principaux de service doivent être ajoutés explicitement.

Modifier les rôles et les organisations attribués aux utilisateurs

Il n’est pas possible de modifier des rôles et organisations après leur attribution. Pour modifier le rôle ou l’organisation attribués à un utilisateur, supprimez celui-ci, puis rajoutez-le avec un rôle ou une organisation différents.

Supprimer les utilisateurs

Pour supprimer des utilisateurs, sélectionnez une ou plusieurs cases à cocher sur la page Utilisateurs. Puis sélectionnez Supprimer.

Gérer les rôles

Les rôles vous permettent de contrôler qui, au sein de votre organisation, peut effectuer différentes tâches dans IoT Central. Vous pouvez attribuer trois rôles intégrés aux utilisateurs de votre application. Vous pouvez également créer des rôles personnalisés si vous avez besoin d’un contrôle plus fin.

Administrateur d’application

Les utilisateurs auxquels est attribué le rôle Administrateur d’administrateur peuvent gérer et contrôler toutes les parties de l’application, dont la facturation.

L’utilisateur qui crée une application se voit automatiquement attribué le rôle Administrateur d’application. Le rôle Administrateur d’application doit toujours être attribué à au moins un utilisateur.

Générateur d’application

Les utilisateurs auxquels est attribué le rôle Générateur d’application peuvent gérer toutes les parties de l’application, mais ils ne peuvent pas apporter de changement sous les onglets Application ou Exportation de données.

Opérateur d’application

Les utilisateurs auxquels est attribué le rôle Opérateur d’application peuvent surveiller l’intégrité et l’état des appareils. Ils ne sont pas autorisés à apporter des modifications aux modèles d’appareils ni à administrer l’application. Les opérateurs peuvent ajouter et supprimer des appareils, gérer des ensembles d’appareils et exécuter des analytiques et des travaux.

Administrateur de l’organisation

IoT Central ajoute ce rôle automatiquement quand vous ajoutez une organisation à votre application. Ce rôle empêche les administrateurs d’organisation d’accéder à certaines fonctionnalités d’application, telles que la facturation, la personnalisation, les couleurs, les jetons d’API et les informations du groupe d’inscription.

Les utilisateurs auxquels est attribué le rôle Administrateur d’organisation peuvent inviter des utilisateurs à accéder à l’application, créer des sous-organisations dans la hiérarchie de leur organisation, et gérer les appareils au sein de leur organisation.

Opérateur d’organisation

IoT Central ajoute ce rôle automatiquement quand vous ajoutez une organisation à votre application. Ce rôle empêche les opérateurs d’organisation d’accéder à certaines fonctionnalités à l’échelle de l’application.

Les utilisateurs auxquels est attribué le rôle Opérateur d’organisation peuvent effectuer des tâches telles que l’ajout d’appareils, l’exécution de commandes, l’affichage de données d’appareil, la création de tableaux de bord et la création de groupes d’appareils.

Observateur de l’organisation

IoT Central ajoute ce rôle automatiquement quand vous ajoutez une organisation à votre application.

Les utilisateurs auxquels est attribué le rôle Observateur d’organisation peuvent afficher des éléments tels que des appareils et leurs données, des tableaux de bord d’organisation, des groupes d’appareils et des modèles d’appareil.

Créer un rôle personnalisé

Si votre solution nécessite des contrôles d’accès plus précis, vous pouvez créer des rôles avec des ensembles d’autorisations personnalisés. Pour créer un rôle personnalisé, accédez à la page Rôles, dans la section Autorisations de votre application, puis choisissez l’une des options suivantes :

• Sélectionnez + Nouveau, ajoutez un nom et une description pour votre rôle, puis sélectionnez Application ou Organisation en tant que type de rôle. Cette option vous permet de créer une définition de rôle à partir de rien.
• Accédez à un rôle existant et sélectionnez Copier. Cette option vous permet de commencer avec une définition de rôle existante que vous pouvez personnaliser.

Lorsque vous invitez un utilisateur à accéder à votre application, si vous associez l’utilisateur à :

• l’organisation racine, seuls les rôles Application sont disponibles.
• toute autre organisation, seuls les rôles Organisation sont disponibles.

Vous pouvez ajouter des utilisateurs à votre rôle personnalisé de la même façon que vous ajoutez des utilisateurs à un rôle intégré.

Options de rôle personnalisé

Lorsque vous définissez un rôle personnalisé, vous choisissez le jeu d’autorisations qu’un utilisateur reçoit s’il est membre du rôle. Certaines autorisations dépendent les unes des autres. Par exemple, si vous ajoutez l’autorisation Mettre à jour les tableaux de bord personnels à un rôle, l’autorisation Afficher les tableaux de bord personnels est automatiquement ajoutée. Les tableaux suivants résument les autorisations disponibles et leurs dépendances, que vous pouvez utiliser lors de la création de rôles personnalisés.

Gestion des appareils

Autorisations du modèle d’appareil

Autorisations des instances d’appareils

Autorisations des groupes d’appareils

Autorisations de gestion de la connectivité des appareils

Manifestes de déploiement Edge

Autorisations de travaux

Autorisations de règles

Gestion de l’application

Autorisations des paramètres d’application

Autorisations d’exportation du modèle d’application

Autorisations de chargement de fichier d’appareil

Autorisations de facturation

Autorisations du journal d’audit

Gestion des utilisateurs et des rôles

Autorisations de rôles personnalisés

Autorisations de gestion des utilisateurs

Autorisations de gestion de l’organisation

Personnalisation de l’application

Autorisations des tableaux de bord d’applications

Autorisations des tableaux de bord personnels

Autorisations de l’explorateur de données

Autorisations Marque, Icône favorite et Couleurs

Autorisations de liens d’aide

Extension de l’application

Autorisations d’exportation de données

Autorisations de jeton d’API