Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez utiliser Microsoft Entra ID pour authentifier les demandes auprès des API DPS (Device Provisioning Service) Azure IoT Hub, telles que créer une identité d’appareil et appeler une méthode directe. Vous pouvez également utiliser le contrôle d’accès en fonction du rôle (RBAC) Azure pour autoriser ces mêmes API de service. En utilisant ces technologies ensemble, vous pouvez accorder des autorisations pour accéder aux API DPS (Device Provisioning Service) Azure IoT Hub à un principal de sécurité Microsoft Entra. Le principal de sécurité peut être un utilisateur, un groupe ou un principal du service d’application.
L’authentification de l’accès en utilisant Microsoft Entra ID et le contrôle des autorisations avec Azure RBAC offrent une sécurité et une simplicité d’utilisation améliorées par rapport aux jetons de sécurité. Pour réduire les problèmes de sécurité potentiels inhérents aux jetons de sécurité, nous vous recommandons d’utiliser Microsoft Entra ID avec votre service Azure IoT Hub Device Provisioning (DPS) dans la mesure du possible.
Remarque
L’authentification avec Microsoft Entra ID n’est pas prise en charge pour les API de périphérique du service Azure IoT Hub Device Provisioning Service (DPS) (comme enregistrer un périphérique ou consulter l’état d’enregistrement d’un périphérique). Utilisez des clés symétriques, X.509 ou TPM pour authentifier les appareils auprès du Service Azure IoT Hub Device Provisioning (DPS).
Authentification et autorisation
Lorsqu’un principal de sécurité Microsoft Entra demande l’accès à une API DPS (Device Provisioning Service) Azure IoT Hub, l’identité du principal est d’abord authentifiée. Pour l’authentification, la demande doit contenir un jeton d’accès OAuth 2.0 au moment de l’exécution. Le nom de ressource pour la demande du jeton est https://azure-devices-provisioning.net. Si l’application s’exécute dans une ressource Azure comme une machine virtuelle Azure, une application Azure Functions ou une application Azure App Service, elle peut être représentée en tant qu’identité managée.
Une fois le principal Microsoft Entra authentifié, l’étape suivante est l’autorisation. Dans cette étape, Azure IoT Hub Device Provisioning Service (DPS) utilise le service d’attribution de rôle Microsoft Entra pour déterminer les autorisations dont dispose le principal. Si les autorisations du principal correspondent à la ressource ou à l’API demandée, le Service Azure IoT Hub Device Provisioning (DPS) autorise la demande. Ainsi, cette étape exige qu’un ou plusieurs rôles Azure soient attribués au principal de sécurité. Le Service Azure IoT Hub Device Provisioning (DPS) fournit des rôles intégrés qui ont des groupes d’autorisations communs.
Gérer l’accès au Service Azure IoT Hub Device Provisioning (DPS) à l’aide de l’attribution de rôle Azure RBAC
Avec Microsoft Entra ID et RBAC, le service DPS (Device Provisioning Service) Azure IoT Hub exige que le principal demandant à l’API d’avoir le niveau d’autorisation approprié pour l’autorisation. Pour octroyer l’autorisation au principal, donnez-lui une attribution de rôle.
- Si le principal est un utilisateur, un groupe ou un principal du service d’application, suivez les instructions fournies dans Attribuer des rôles Azure à l’aide du portail Azure.
- Si le principal est une identité managée, suivez les instructions fournies dans Attribuer à une identité managée un accès à une ressource à l’aide du portail Azure.
Pour garantir des privilèges minimum, attribuez toujours le rôle approprié au niveau de l’étendue de ressource le plus faible possible, à savoir probablement l’étendue du Service Azure IoT Hub Device Provisioning (DPS).
Azure IoT Hub Device Provisioning Service (DPS) fournit les rôles intégrés Azure suivants pour autoriser l’accès aux API DPS à l’aide de Microsoft Entra ID et du RBAC :
| Rôle | Description |
|---|---|
| Contributeur aux données du service de provisionnement des appareils | Permet un accès complet aux opérations du plan de données du service de provisionnement des appareils. |
| Lecteur de données du service de provisionnement des appareils | Permet un accès en lecture complet aux propriétés du plan de données du service de provisionnement des appareils. |
Vous pouvez également définir des rôles personnalisés à utiliser avec le Service Azure IoT Hub Device Provisioning (DPS) en combinant les autorisations dont vous avez besoin. Pour plus d’informations, consultez Créer des rôles personnalisés pour le contrôle d’accès en fonction du rôle Azure.
Clés d’écriture du plan de contrôle et de stratégie d’accès partagé
L’action Microsoft.Devices/provisioningServices/write permet à un principal de créer ou de mettre à jour toute propriété de la ressource DPS, y compris la authorizationPolicies collection. Parce que le contrat Azure Resource Manager (ARM) pour CreateOrUpdate accepte les valeurs primaryKey et secondaryKey fournies par l’appelant pour chaque stratégie, un principal disposant de write sur une ressource DPS peut :
- Définissez la clé primaire ou secondaire de toute politique d’accès partagé (y compris la politique root
provisioningserviceowner) à une valeur qu’ils choisissent, puis authentifiez comme cette politique. - Faites pivoter les clés de toute politique d’accès partagé, ce qui invalide les consommateurs existants.
- Ajoutez une nouvelle politique d’accès partagé nommée avec une valeur clé choisie.
Pour cette raison, Microsoft.Devices/provisioningServices/write équivaut fonctionnellement à la gestion complète des informations d’identification de la stratégie d’accès partagé de la ressource, que le principal détienne également Microsoft.Devices/provisioningServices/listkeys/action ou Microsoft.Devices/provisioningServices/listkey/action, ou non.
Important
Un rôle personnalisé qui accorde Microsoft.Devices/provisioningServices/write sur une ressource DPS sans accorder listkeys/action n’isole pas l’administration des accréditations de la configuration des ressources. Le principal dispose toujours d’un contrôle total sur les éléments de clé de la stratégie d’accès partagé par le biais du chemin d’écriture. Ne vous fiez pas à ce modèle pour la configuration du moindre privilège.
Si vous devez séparer la configuration des ressources de l’administration des identifiants de la politique d’accès partagée, utilisez plutôt l’un des schémas suivants :
- Privilégiez l’authentification Microsoft Entra ID pour le plan de données. Attribuer les rôles intégrés de Contributeur de données du Service de provisionnement de dispositifs ou de lecteur de données du Service de provisionnement des dispositifs pour la gestion des inscriptions, et désactiver l’accès à la signature d’accès partagé sur la ressource lorsque cela est possible.
- Restreindre
writeà l’échelle des ressources. Parce quewritecela implique un contrôle de clé, accordez-le uniquement aux principaux responsables en qui vous avez confiance avec des identifiants de politique d’accès partagés. - Auditer l’activité du plan de contrôle. Les modifications apportées à
authorizationPoliciesvia l’opération PUT du plan de contrôle sont enregistrées dans le Journal d’activité Azure sous l’opérationMicrosoft.Devices/provisioningServices/write. Examinez ces événements parallèlement aux événementslistkeys/actionlors de l’audit de l’accès aux informations d’identification.
Les mêmes considérations s’appliquent à Azure IoT Hub. Pour plus de détails, voir Contrôler l’accès à IoT Hub en utilisant Microsoft Entra ID.
Étendue des ressources
Avant d’attribuer un rôle RBAC Azure à un principal de sécurité, déterminez l’étendue de l’accès dont doit disposer le principal de sécurité. Il est toujours préférable d’accorder la plus petite étendue possible. Les rôles RBAC Azure définis au niveau d’une étendue plus large sont hérités par les ressources qui sont sous eux.
Cette liste décrit les niveaux auxquels vous pouvez étendre l’accès à IoT Hub, en commençant par la plus petite étendue :
- Le Service Azure IoT Hub Device Provisioning (DPS). Dans cette étendue, une attribution de rôle s’applique au Service Azure IoT Hub Device Provisioning (DPS). L’attribution de rôles à des périmètres plus restreints, comme un groupe d’inscriptions ou une inscription individuelle, n’est pas prise en charge.
- Groupe de ressources. Dans cette étendue, une attribution de rôle s’applique à tous les hubs IoT dans le groupe de ressources.
- Abonnement. Dans cette étendue, une attribution de rôle s’applique à tous les hubs IoT dans tous les groupes de ressources de l’abonnement.
- Un groupe d’administration. Dans cette étendue, une attribution de rôle s’applique à tous les hubs IoT dans tous les groupes de ressources de tous les abonnements dans le groupe d’administration.
Autorisations pour les API du Service Azure IoT Hub Device Provisioning (DPS)
Le tableau suivant décrit les autorisations disponibles pour les opérations d’API du Service Azure IoT Hub Device Provisioning (DPS). Pour permettre à un client d’appeler une opération particulière, vérifiez que le rôle RBAC attribué au client offre des autorisations suffisantes pour l’opération.
| Action de RBAC | Description |
|---|---|
Microsoft.Devices/provisioningServices/attestationmechanism/details/action |
Récupérer les détails du mécanisme d’attestation |
Microsoft.Devices/provisioningServices/enrollmentGroups/read |
Afficher les groupes d’inscriptions |
Microsoft.Devices/provisioningServices/enrollmentGroups/write |
Créer des groupes d’inscription |
Microsoft.Devices/provisioningServices/enrollmentGroups/delete |
Supprimer des groupes d’inscription |
Microsoft.Devices/provisioningServices/enrollments/read |
Consulter les inscriptions |
Microsoft.Devices/provisioningServices/enrollments/write |
Écrire des inscriptions |
Microsoft.Devices/provisioningServices/enrollments/delete |
Supprimer des inscriptions |
Microsoft.Devices/provisioningServices/registrationStates/read |
Lire des états d’inscription |
Microsoft.Devices/provisioningServices/registrationStates/delete |
Supprimer des états d’inscription |
Extension Azure IoT pour Azure CLI
La plupart des commandes pour Azure IoT Hub Device Provisioning Service (DPS) prennent en charge l’authentification Microsoft Entra. Vous pouvez contrôler le type d’authentification utilisé pour exécuter des commandes à l’aide du paramètre --auth-type, qui accepte des valeurs key ou login. La valeur par défaut est key.
Lorsque
--auth-typea la valeurkey, l’interface CLI découvre automatiquement une stratégie appropriée lors de l’interaction avec le Service Azure IoT Hub Device Provisioning (DPS).Lorsque
--auth-typea la valeurlogin, un jeton d’accès du principal connecté à Azure CLI est utilisé pour l’opération.Les commandes suivantes prennent actuellement en charge
--auth-type:az iot dps enrollmentaz iot dps enrollment-groupaz iot dps registration
Pour plus d’informations, consultez la page de publication de l’extension Azure IoT pour Azure CLI.
SDK et exemples
- Kits SDK Azure IoT pour le service de provisionnement Node.js
- Version préliminaire du Kit de développement logiciel (SDK) Azure IoT pour Java
- Microsoft Azure IoT SDKs for .NET Preview Release
Accès à Microsoft Entra ID à partir du Portail Azure
Remarque
L’accès à Microsoft Entra ID à partir du portail Azure n’est actuellement pas disponible en préversion.
Étapes suivantes
- Si vous souhaitez obtenir plus d’informations sur les avantages de l’utilisation de Microsoft Entra ID dans votre application, consultez Intégration à Microsoft Entra ID.
- Pour obtenir plus d’informations sur les demandes de jetons d’accès à partir de Microsoft Entra ID pour des utilisateurs et principaux de service, voir Scénarios d’authentification pour Microsoft Entra ID.