Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS IoT SiteWise politiques basées sur l’identité

Les politiques IAM vous permettent de contrôler qui peut faire quoi. AWS IoT SiteWise Vous pouvez décider quelles actions sont autorisées ou non et définir des conditions spécifiques pour ces actions. Par exemple, vous pouvez définir des règles concernant les personnes autorisées à consulter ou à modifier des informations dans AWS IoT SiteWise. AWS IoT SiteWise prend en charge des actions, des ressources et des clés de condition spécifiques. Pour en savoir plus sur tous les éléments que vous utilisez dans une politique JSON, consultez Références des éléments de politique JSON IAM dans le Guide de l'utilisateur IAM.

Actions de politique

Les administrateurs peuvent utiliser des politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L’élément Action d’une politique JSON décrit les actions que vous pouvez utiliser pour autoriser ou refuser l’accès à une politique. Intégration d’actions dans une politique afin d’accorder l’autorisation d’exécuter les opérations associées.

Les actions de stratégie en AWS IoT SiteWise cours utilisent le préfixe suivant avant l'action :iotsitewise:. Par exemple, pour autoriser une personne à télécharger des données sur les propriétés des actifs à l' AWS IoT SiteWise aide de l'opération d'BatchPutAssetPropertyValueAPI, vous incluez l'iotsitewise:BatchPutAssetPropertyValueaction dans sa politique. Les déclarations de politique doivent inclure un NotAction élément Action ou. AWS IoT SiteWise définit son propre ensemble d'actions qui décrivent les tâches que vous pouvez effectuer avec ce service.

Pour spécifier plusieurs actions dans une seule instruction, séparez-les par des virgules, comme suit :

"Action": [
  "iotsitewise:action1",
  "iotsitewise:action2"
]

Vous pouvez aussi préciser plusieurs actions à l’aide de caractères génériques (*). Par exemple, pour spécifier toutes les actions qui commencent par le mot Describe, incluez l’action suivante.

"Action": "iotsitewise:Describe*"

Pour consulter la liste des AWS IoT SiteWise actions, consultez la section Actions définies par AWS IoT SiteWise dans le Guide de l'utilisateur IAM.

BatchPutAssetPropertyValue autorisation

AWS IoT SiteWise autorise l'accès à l'BatchPutAssetPropertyValueaction d'une manière inhabituelle. Pour la plupart des actions, lorsque vous autorisez ou refusez l'accès, cette action renvoie une erreur si les autorisations ne sont pas accordées. AvecBatchPutAssetPropertyValue, vous pouvez envoyer plusieurs entrées de données à différents actifs et propriétés d'actifs en une seule demande d'API. AWS IoT SiteWise autorise chaque saisie de données indépendamment. Pour toute entrée individuelle qui n'est pas autorisée dans la demande, AWS IoT SiteWise inclut une liste d'erreurs AccessDeniedException dans la liste des erreurs renvoyées. AWS IoT SiteWise reçoit les données de toute entrée autorisée et réussie, même si une autre entrée de la même demande échoue.

Ressources de politique

Les administrateurs peuvent utiliser des politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L’élément de politique JSON Resource indique le ou les objets auxquels l’action s’applique. Il est recommandé de définir une ressource à l’aide de son Amazon Resource Name (ARN). Pour les actions qui ne sont pas compatibles avec les autorisations de niveau ressource, utilisez un caractère générique (*) afin d’indiquer que l’instruction s’applique à toutes les ressources.

"Resource": "*"

Chaque déclaration de politique IAM s’applique aux ressources que vous spécifiez à l’aide de leur ARN. Un ARN a la syntaxe générale suivante :

arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}

Pour plus d'informations sur le format des ARN, consultez Identifier les AWS ressources avec Amazon Resource Names (ARNs).

Par exemple, pour spécifier l'actif avec l'ID a1b2c3d4-5678-90ab-cdef-22222EXAMPLE dans votre instruction, utilisez l'ARN suivant :

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"

Pour spécifier tous les flux de données qui appartiennent à un compte spécifique, utilisez le caractère générique (*) :

"Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*"

Pour spécifier tous les actifs appartenant à un compte spécifique, utilisez le caractère générique (*) :

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/*"

Certaines AWS IoT SiteWise actions, telles que celles relatives à la création de ressources, ne peuvent pas être effectuées sur une ressource spécifique. Dans ces cas-là, vous devez utiliser le caractère générique (*).

"Resource": "*"

Pour spécifier plusieurs ressources dans une seule instruction, séparez leurs ARN par des virgules.

"Resource": [
  "resource1",
  "resource2"
]

Pour consulter la liste des types de AWS IoT SiteWise ressources et de leurs ARN, consultez la section Types de ressources définis par AWS IoT SiteWise dans le Guide de l'utilisateur IAM. Pour savoir grâce à quelles actions vous pouvez spécifier l’ARN de chaque ressource, consultez Actions définies par AWS IoT SiteWise.

Clés de condition de politique

Les administrateurs peuvent utiliser des politiques AWS JSON pour spécifier qui a accès à quoi. C’est-à-dire, quel principal peut effectuer des actions sur quelles ressources et dans quelles conditions.

L’élément Condition indique à quel moment les instructions s’exécutent en fonction de critères définis. Vous pouvez créer des expressions conditionnelles qui utilisent des opérateurs de condition, tels que les signes égal ou inférieur à, pour faire correspondre la condition de la politique aux valeurs de la demande. Pour voir toutes les clés de condition AWS globales, consultez les clés contextuelles de conditions AWS globales dans le guide de l'utilisateur IAM.

AWS IoT SiteWise définit son propre ensemble de clés de condition et prend également en charge l'utilisation de certaines clés de condition globales. Pour voir toutes les clés de condition AWS globales, consultez les clés contextuelles de conditions AWS globales dans le guide de l'utilisateur IAM.

Pour savoir avec quelles actions et quelles ressources vous pouvez utiliser une clé de condition, consultez la section Actions définies par AWS IoT SiteWise.

Exemples

Pour consulter des exemples de politiques AWS IoT SiteWise basées sur l'identité, consultez. AWS IoT SiteWise exemples de politiques fondées sur l'identité