View a markdown version of this page

Conditions préalables à l'exécution du AWS IoT Greengrass suite de qualifications - AWS IoT Greengrass

Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur Migrer depuis AWS IoT Greengrass Version 1.

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.

Conditions préalables à l'exécution du AWS IoT Greengrass suite de qualifications

Cette section décrit les conditions préalables à l'utilisation de AWS IoT Device Tester (IDT) AWS IoT Greengrass pour exécuter la suite de AWS IoT Greengrass qualification.

Téléchargez la dernière version de AWS IoT Testeur d'appareils pour AWS IoT Greengrass

Téléchargez la dernière version d'IDT et extrayez le logiciel dans un emplacement de votre système de fichiers où vous disposez d'autorisations de lecture et d'écriture.

Note

IDT ne prend pas en charge son exécution par plusieurs utilisateurs à partir d'un emplacement partagé, tel qu'un répertoire NFS ou un dossier partagé réseau Windows. Nous vous recommandons d'extraire le package IDT sur une unité locale et d'exécuter le fichier binaire IDT sur votre station de travail locale.

Pour Windows, la limitation de la longueur du chemin est de 260 caractères. Si vous utilisez Windows, décompressez IDT dans un répertoire racine comme C:\ ou D:\ afin que la longueur de vos chemins respecte la limite de 260 caractères.

Créez et configurez un Compte AWS

Avant de pouvoir utiliser IDT pour AWS IoT Greengrass, vous devez effectuer les étapes suivantes :

  1. Créez un Compte AWS. Si vous en avez déjà un Compte AWS, passez à l'étape 2.

  2. Configurez les autorisations pour IDT.

Ces autorisations de compte permettent à IDT d'accéder aux AWS services et de créer des AWS ressources, telles que des AWS IoT objets, des groupes Greengrass et des fonctions Lambda, en votre nom.

Pour créer ces ressources, IDT for AWS IoT Greengrass utilise les AWS informations d'identification configurées dans le config.json fichier pour effectuer des appels d'API en votre nom. Ces ressources sont allouées à différents moments d'un test.

Note

Bien que la plupart des tests soient éligibles au niveau gratuit d'Amazon Web Services, vous devez fournir une carte de crédit lorsque vous vous inscrivez à un Compte AWS. Pour de plus amples informations, veuillez consulter Pourquoi ai-je besoin d'un mode de paiement si mon compte est couvert par le niveau gratuit ?.

Étape 2 : Configurer les autorisations pour IDT

Dans cette étape, configurez les autorisations qu'IDT for AWS IoT Greengrass utilise pour exécuter des tests et collecter des données d'utilisation IDT. Vous pouvez utiliser le AWS Management Console ou AWS Command Line Interface (AWS CLI) pour créer une stratégie IAM et un utilisateur de test pour IDT, puis associer des politiques à l'utilisateur. Si vous avez déjà créé un utilisateur test pour IDT, passez à Configurez votre appareil pour exécuter des tests IDT ou Facultatif : Configuration de votre conteneur Docker pour IDT pour AWS IoT Greengrass.

Pour configurer des autorisations pour IDT (console)

Procédez comme suit pour utiliser la console afin de configurer les autorisations pour IDT pour AWS IoT Greengrass.

  1. Connectez-vous à la console IAM.

  2. Créez une stratégie gérée par le client qui accorde des autorisations de création des rôles avec des autorisations spécifiques.

    1. Dans le volet de navigation, sélectionnez Politiques, puis Créer une politique.

    2. Sur l'onglet JSON, remplacez le contenu de l'espace réservé par la stratégie suivante.

      JSON
      { "Version":"2012-10-17", "Statement": [ { "Sid": "ManageRolePoliciesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:DetachRolePolicy", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws:iam::*:role/idt-*", "arn:aws:iam::*:role/GreengrassServiceRole" ], "Condition": { "ArnEquals": { "iam:PolicyARN": [ "arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy", "arn:aws:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess", "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" ] } } }, { "Sid": "ManageRolesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:PassRole", "iam:GetRole" ], "Resource": [ "arn:aws:iam::123456789012:role/idt-*", "arn:aws:iam::123456789012:role/GreengrassServiceRole" ] } ] }
      Important

      La stratégie suivante accorde l'autorisation de créer et de gérer les rôles requis par IDT pour AWS IoT Greengrass. Cela inclut les autorisations permettant d'associer les politiques AWS gérées suivantes :

    3. Choisissez Suivant : Balises.

    4. Choisissez Suivant : Vérification.

    5. Pour Nom, saisissez IDTGreengrassIAMPermissions. Sous Résumé, vérifiez les autorisations accordées par votre stratégie.

    6. Choisissez Create Policy (Créer une politique).

  3. Créez un utilisateur IAM et associez les autorisations requises par IDT pour. AWS IoT Greengrass

    1. Créez un utilisateur IAM. Suivez les étapes 1 à 5 de la section Création d'utilisateurs IAM (console) dans le guide de l'utilisateur IAM.

    2. Associez les autorisations à votre utilisateur IAM :

      1. Sur la page Définir les autorisations, choisissez Joindre directement les politiques existantes.

      2. Recherchez la IDTGreengrassIAMPermissionspolitique que vous avez créée à l'étape précédente. Activez la case à cocher.

      3. Recherchez la AWSIoTDeviceTesterForGreengrassFullAccesspolitique. Activez la case à cocher.

        Note

        AWSIoTDeviceTesterForGreengrassFullAccessIl s'agit d'une politique AWS gérée qui définit les autorisations dont IDT a besoin pour créer et accéder aux AWS ressources utilisées pour les tests. Pour de plus amples informations, veuillez consulter AWS politique gérée pour AWS IoT Testeur d'appareils.

    3. Choisissez Suivant : Identifications.

    4. Choisissez Suivant : Réviser pour afficher un résumé de vos choix.

    5. Choisissez Create user (Créer un utilisateur).

    6. Pour afficher les clés d'accès de l'utilisateur (ID de clé d'accès et clés d'accès secrètes), choisissez Afficher en regard du mot de passe et de la clé d'accès. Pour enregistrer les clés d'accès, choisissez Download.csvet enregistrez le fichier dans un emplacement sécurisé. Vous utiliserez ces informations ultérieurement pour configurer votre fichier AWS d'informations d'identification.

  4. Étape suivante : Configurez votre appareil physique.

 

Pour configurer les autorisations pour IDT (AWS CLI)

Procédez comme suit pour utiliser le AWS CLI afin de configurer les autorisations pour IDT pour AWS IoT Greengrass. Si vous avez déjà configuré des autorisations dans la console, passez à Configurez votre appareil pour exécuter des tests IDT ou Facultatif : Configuration de votre conteneur Docker pour IDT pour AWS IoT Greengrass.

  1. Sur votre ordinateur, installez et configurez le AWS CLI s'il n'est pas déjà installé. Suivez les étapes décrites AWS CLI dans la section Installation du guide de AWS Command Line Interface l'utilisateur.

    Note

    AWS CLI Il s'agit d'un outil open source que vous pouvez utiliser pour interagir avec les AWS services à partir de votre shell de ligne de commande.

  2. Créez une stratégie gérée par le client qui accorde les autorisations pour gérer IDT et les rôles AWS IoT Greengrass .

    Linux, macOS, or Unix
    aws iam create-policy --policy-name IDTGreengrassIAMPermissions --policy-document '{ "Version":"2012-10-17", "Statement": [ { "Sid": "ManageRolePoliciesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:DetachRolePolicy", "iam:AttachRolePolicy" ], "Resource": [ "arn:aws:iam::*:role/idt-*", "arn:aws:iam::*:role/GreengrassServiceRole" ], "Condition": { "ArnEquals": { "iam:PolicyARN": [ "arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy", "arn:aws:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess", "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" ] } } }, { "Sid": "ManageRolesForIDTGreengrass", "Effect": "Allow", "Action": [ "iam:CreateRole", "iam:DeleteRole", "iam:PassRole", "iam:GetRole" ], "Resource": [ "arn:aws:iam::123456789012:role/idt-*", "arn:aws:iam::123456789012:role/GreengrassServiceRole" ] } ] }'
    Windows command prompt
    aws iam create-policy --policy-name IDTGreengrassIAMPermissions --policy-document '{\"Version\": \"2012-10-17\", \"Statement\": [{\"Sid\": \"ManageRolePoliciesForIDTGreengrass\",\"Effect\": \"Allow\",\"Action\": [\"iam:DetachRolePolicy\", \"iam:AttachRolePolicy\"], \"Resource\": [\"arn:aws:iam::*:role/idt-*\",\"arn:aws:iam::*:role/GreengrassServiceRole\"],\"Condition\": {\"ArnEquals\": {\"iam:PolicyARN\": [\"arn:aws:iam::aws:policy/service-role/AWSGreengrassResourceAccessRolePolicy\",\"arn:aws:iam::aws:policy/service-role/GreengrassOTAUpdateArtifactAccess\",\"arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole\"]}}},{\"Sid\": \"ManageRolesForIDTGreengrass\",\"Effect\": \"Allow\",\"Action\": [\"iam:CreateRole\",\"iam:DeleteRole\", \"iam:PassRole\", \"iam:GetRole\"],\"Resource\": [\"arn:aws:iam::*:role/idt-*\",\"arn:aws:iam::*:role/GreengrassServiceRole\"]}]}'
    Note

    Cette étape inclut un exemple d'invite de commande Windows car elle utilise une syntaxe JSON différente de celle des commandes de terminal Linux, macOS ou Unix.

  3. Créez un utilisateur IAM et associez les autorisations requises par IDT pour. AWS IoT Greengrass

    1. Créez un utilisateur IAM. Dans cet exemple de configuration, l'utilisateur est nommé IDTGreengrassUser.

      aws iam create-user --user-name IDTGreengrassUser
    2. Attachez la IDTGreengrassIAMPermissions politique que vous avez créée à l'étape 2 à votre utilisateur IAM. Remplacez <account-id> dans la commande par l'identifiant de votre Compte AWS.

      aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws:iam::<account-id>:policy/IDTGreengrassIAMPermissions
    3. Attachez la AWSIoTDeviceTesterForGreengrassFullAccess politique à votre utilisateur IAM.

      aws iam attach-user-policy --user-name IDTGreengrassUser --policy-arn arn:aws:iam::aws:policy/AWSIoTDeviceTesterForGreengrassFullAccess
      Note

      AWSIoTDeviceTesterForGreengrassFullAccessIl s'agit d'une politique AWS gérée qui définit les autorisations dont IDT a besoin pour créer et accéder aux AWS ressources utilisées pour les tests. Pour de plus amples informations, veuillez consulter AWS politique gérée pour AWS IoT Testeur d'appareils.

  4. Créez une clé d'accès secrète pour l'utilisateur.

    aws iam create-access-key --user-name IDTGreengrassUser

    Stockez la sortie dans un emplacement sécurisé. Vous utiliserez ces informations ultérieurement pour configurer votre fichier AWS d'informations d'identification.

  5. Étape suivante : Configurez votre appareil physique.

AWS politique gérée pour AWS IoT Testeur d'appareils

La politique AWSIoTDeviceTesterForGreengrassFullAccessgérée permet à IDT d'exécuter des opérations et de collecter des métriques d'utilisation. Cette stratégie accorde les autorisations IDT suivantes :

  • iot-device-tester:CheckVersion. Vérifiez si un ensemble de versions AWS IoT Greengrass, une suite de tests et une version IDT sont compatibles.

  • iot-device-tester:DownloadTestSuite. Téléchargez les suites de tests.

  • iot-device-tester:LatestIdt. Obtenez des informations sur la dernière version d'IDT disponible en téléchargement.

  • iot-device-tester:SendMetrics. Publiez les données d'utilisation collectées par IDT à propos de vos tests.

  • iot-device-tester:SupportedVersion. Obtenez la liste des versions AWS IoT Greengrass de la suite de tests prises en charge par IDT. Ces informations apparaissent dans la fenêtre de ligne de commande.