

 AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants d’ AWS Cloud9 peuvent continuer à l’utiliser normalement. [En savoir plus](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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.

# Utilisation AWS IoT dans l' AWS Cloud9 IDE
<a name="iot-start"></a>

Avec AWS IoT l' AWS Cloud9 IDE, vous pouvez interagir avec le AWS IoT service tout en minimisant les interruptions de votre flux de travail AWS Cloud9. Ce guide explique comment commencer à utiliser les fonctionnalités de AWS IoT service disponibles dans l' AWS Cloud9 IDE. Pour plus d'informations, veuillez consulter [Présentation de AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) dans le *Manuel du développeur AWS IoT *.

## AWS IoT prérequis
<a name="iot-cloud9-prereq"></a>

Pour commencer à utiliser AWS IoT dans l' AWS Cloud9 IDE, assurez-vous que votre AWS Cloud9 configuration Compte AWS et votre installation répondent à toutes les exigences. Pour plus d'informations sur les Compte AWS exigences et les autorisations AWS utilisateur spécifiques au AWS IoT service, consultez la section [Getting Started with AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) dans le *guide du AWS IoT développeur*.

## AWS IoT Choses
<a name="iot-cloud9-things"></a>

AWS IoT connecte les appareils aux AWS ressources Services AWS et les connecte. Vous pouvez connecter vos appareils à AWS IoT l'aide d'objets appelés **objets**. Un objet est une représentation d’un appareil spécifique ou d’une entité logique. Il peut s'agir d'un appareil physique ou d'un capteur (par exemple, une ampoule ou un interrupteur sur un mur). Pour plus d'informations à ce AWS IoT sujet, consultez [la section Gestion des appareils AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html) dans le *Guide du AWS IoT développeur*. 

### Gérer AWS IoT les choses
<a name="iot-cloud9-things-actions"></a>

L' AWS Cloud9 IDE possède plusieurs fonctionnalités qui rendent la gestion de vos objets efficace. Pour gérer vos AWS IoT affaires, procédez comme suit : 
+ [Create a thing](#thing-create)
+ [Attach a certificate to a thing](#thing-certificate-attach)
+ [Detach a certificate from a thing](#thing-certificate-detach)
+ [Delete a thing](#thing-delete)<a name="thing-create"></a>

**Pour créer un objet**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Ouvrez le menu contextuel (clic droit) de l'**objet** et choisissez **Create Thing** (Créer un objet).

1. Saisissez un nom pour l'**objet** dans le champ **Thing Name** (Nom de l'objet) et suivez les instructions de l'invite.

1. Lorsque cette étape est terminée, une **icône d'objet** suivie du nom que vous avez spécifié est visible dans la section **Thing** (Objet).<a name="thing-certificate-attach"></a>

**Pour attacher un certificat à un objet**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Things** (Objets), localisez l'**objet** auquel vous voulez joindre le certificat. 

1. Ouvrez le menu contextuel (clic droit) de l'**objet** et choisissez **Attach Certificate** (Attacher un certificat) dans le menu contextuel, pour ouvrir un sélecteur d'entrée avec une liste de vos certificats.

1. Dans la liste, choisissez l'**ID du certificat** qui correspond au certificat que vous voulez attacher à votre objet.

1. Une fois cette étape terminée, votre certificat est accessible dans AWS Explorer en tant qu'élément de l'objet auquel vous l'avez attaché.<a name="thing-certificate-detach"></a>

**Pour détacher un certificat d'un objet**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Things** (Objets), localisez l'**objet** dont vous voulez détacher un certificat. 

1. Ouvrez le menu contextuel (clic droit) de l'**objet** et choisissez **Attach Certificate** (Attacher le certificat).

1. Une fois cette étape terminée, le certificat détaché n'est plus affiché sous l'objet dans l' AWS explorateur. Cependant, il est toujours accessible depuis la sous-section **Certificates** (Certificats).<a name="thing-delete"></a>

**Pour supprimer un objet**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Things** (Objets), localisez l'**objet** que vous souhaitez supprimer.

1. Ouvrez le menu contextuel (clic droit) de l'**objet** et choisissez **Delete Thing** (Supprimer l'objet).

1. Une fois cette étape terminée, l'**objet** supprimé n'est plus disponible dans la sous-section **Things** (Objets).
**Note**  
Vous pouvez seulement supprimer un objet qui n'est pas associé à un certificat.

## AWS IoT certificats
<a name="iot-cloud9-cert"></a>

Les certificats sont un moyen courant de créer une connexion sécurisée entre vos services AWS IoT et vos appareils. Les certificats X.509 sont des certificats numériques qui font appel à la norme d'infrastructure de clé publique X.509 pour associer une clé publique à une identité contenue dans un certificat. Pour plus d'informations sur les AWS IoT certificats, consultez la section [Authentification (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) dans le *guide du AWS IoT développeur*.

### Gestion de certificats
<a name="iot-cloud9-cert-actions"></a>

La AWS boîte à outils propose différentes méthodes pour gérer vos AWS IoT certificats directement depuis l' AWS explorateur. Ils sont présentés dans les étapes suivantes :
+ [Create a certificate](#cert-create)
+ [Change a certificate status](#cert-status)
+ [Attach a policy to a certificate](#cert-attach-policy)
+ [Delete a certificate](#cert-delete)<a name="cert-create"></a>

**Pour créer un AWS IoT certificat**

Un certificat X.509 est utilisé pour vous connecter à votre instance de AWS IoT. 

1. Dans l' AWS explorateur, développez la section des services **IoT** et ouvrez les **certificats** (cliquez avec le bouton droit).

1. Pour ouvrir une boîte de dialogue, choisissez **Create Certificate** (Créer un certificat) dans le menu contextuel.

1. Pour enregistrer votre paire de clés RSA et votre certificat X.509, sélectionnez un répertoire dans votre système de fichiers local.
**Note**  
Les noms de fichiers par défaut contiennent l'ID du certificat comme préfixe.
Seul le certificat X.509 est stocké chez vous Compte AWS, via le AWS IoT service.
Votre paire de clés RSA ne peut être émise qu'une seule fois, enregistrez-la dans un emplacement sécurisé de votre système de fichiers lorsque vous y êtes invité.
Si le certificat ou la paire de clés ne peuvent pas être enregistrés dans votre système de fichiers, le AWS Toolkit le supprime de votre Compte AWS.<a name="cert-status"></a>

**Pour modifier l'état d'un certificat**

Le statut d'un certificat individuel est affiché à côté de l'ID du certificat dans l' AWS explorateur et peut être défini comme **actif**, **inactif** ou **révoqué**.
**Note**  
Votre certificat doit avoir un statut **actif** avant de pouvoir l'utiliser pour connecter votre appareil à votre AWS IoT service.
Un certificat **inactive** (inactif) peut être activé, qu'il ait été désactivé précédemment ou qu'il soit inactif par défaut.
Un certificat qui a été **révoqué** ne peut pas être réactivé.

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Certificates** (Certificats), localisez le certificat que vous voulez modifier.

1. Ouvrez le menu contextuel (clic droit) du certificat qui affiche les options de changement d'état disponibles pour ce certificat.
+ Si un certificat présente l'état **inactif**, choisissez **activate** (activer) pour changer l'état en **actif**.
+ Si un certificat présente l'état **actif**, choisissez **deactivate** (désactiver) pour changer l'état en **inactif**.
+ Si un certificat présente l'état **actif** ou **inactif**, choisissez **revoke** (révoquer) pour changer l'état en **révoqué**.

**Note**  
Chacune de ces actions de changement d'état est disponible si vous sélectionnez un certificat attaché à un objet affiché dans la sous-section **Things** (Objets).<a name="cert-attach-policy"></a>

**Pour attacher une politique IoT à un certificat**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Certificates** (Certificats), localisez le certificat que vous voulez modifier.

1. Ouvrez le menu contextuel (clic droit) pour le certificat et choisissez **Attach Policy** (Attacher une politique) pour ouvrir un sélecteur d'entrée avec une liste de vos politiques disponibles.

1. Choisissez la politique que vous voulez attacher au certificat.

1. Lorsque cette étape est terminée, la politique que vous avez sélectionnée est ajoutée au certificat en tant qu'élément de sous-menu.<a name="cert-detach-policy"></a>

**Pour détacher une politique IoT d'un certificat**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Dans la sous-section **Certificates** (Certificats), localisez le certificat que vous voulez modifier.

1. Développez le certificat et localisez la politique que vous voulez détacher.

1. Ouvrez le menu contextuel (clic droit) de la politique et choisissez **Detach** (Détacher) dans le menu contextuel.

1. Une fois cette étape terminée, la politique n'est plus accessible depuis votre certificat, elle est disponible depuis la sous-section **Policy** (Politique).<a name="cert-delete"></a>

**Pour supprimer un certificat**

1. À partir de l' AWS explorateur, élargissez la rubrique du service **IoT**.

1. Dans la sous-section **Certificates** (Certificats), localisez le certificat que vous voulez supprimer.

1. Ouvrez le menu contextuel (clic droit) du certificat et choisissez **Delete Certificate** (Supprimer le certificat) dans le menu contextuel.
**Note**  
Vous ne pouvez pas supprimer un certificat s'il est attaché à un objet ou s'il a un état actif. Vous pouvez supprimer un certificat auquel sont associées des politiques.

## AWS IoT politiques
<a name="iot-vsctoolkit-policy"></a>

AWS IoT Les politiques de base sont définies par le biais de documents JSON. Chacune contient au moins une déclaration de politique. Les politiques définissent comment AWS IoT AWS, et votre appareil peut interagir les uns avec les autres. Pour obtenir plus d'informations sur la création d'un document de politique, consultez [IoT Polices](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) (Politiques IoT) du *guide du développeur AWS IoT *.

**Note**  
Les politiques nommées sont soumises à la gestion des versions afin que vous puissiez les annuler. Dans l' AWS explorateur, vos politiques IoT sont répertoriées dans la sous-section **Politiques** du AWS IoT service. Vous pouvez afficher les versions des politiques en développant une politique. La version par défaut est indiquée par un astérisque (\$1).

### Gestion des politiques
<a name="iot-vsctoolkit-policy-actions"></a>

L' AWS Cloud9 IDE vous propose plusieurs méthodes pour gérer vos politiques AWS IoT de service. Voici comment vous pouvez gérer ou modifier vos politiques directement depuis l' AWS explorateur dans VS Code : 
+ [Create a policy](#policy-create)
+ [Upload a new policy version](#policy-version-upload)
+ [Edit a policy version](#policy-version-edit)
+ [Change the policy version defualt](#policy-version-default)
+ [Change the policy version defualt](#policy-delete)<a name="policy-create"></a>

**Pour créer une AWS IoT politique**
**Note**  
Vous pouvez créer une nouvelle politique à partir de l' AWS explorateur. Cependant, le document JSON qui définit la politique doit déjà exister dans votre système de fichiers.

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Ouvrez le menu contextuel (clic droit) de la sous-section **Policies** (Politiques) et pour ouvrir le champ de saisie **Policy Name** (Nom de la politique), choisissez **Create Policy from Document** (Créer une politique à partir d'un document).

1. Saisissez un nom et suivez les instructions pour ouvrir une boîte de dialogue vous demandant de sélectionner un document JSON dans votre système de fichiers.

1. Choisissez le fichier JSON qui contient vos définitions de politique, la politique est disponible dans AWS Explorer après cette opération.<a name="policy-version-upload"></a>

**Pour télécharger une nouvelle version AWS IoT de la politique**

Vous pouvez créer une nouvelle version d'une politique en chargeant un document JSON dans la politique.
**Note**  
Le nouveau document JSON doit être présent sur votre système de fichiers pour créer une nouvelle version à l'aide de l' AWS explorateur.

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1.  Développez la sous-section **Policies** (Politiques) pour afficher vos politiques AWS IoT .

1. Ouvrez le menu contextuel (clic droit) de la politique que vous voulez mettre à jour et choisissez **Create new version from Document** (Créer une nouvelle version à partir du document).

1. Lorsque la boîte de dialogue s'ouvre, choisissez le fichier JSON qui contient les mises à jour de vos définitions de politiques. 

   La nouvelle version est accessible depuis votre politique dans AWS Explorer.<a name="policy-version-edit"></a>

**Pour modifier une version d'une AWS IoT politique**

Vous pouvez ouvrir et modifier un document de politique à l'aide de AWS Cloud9. Lorsque vous avez terminé de modifier le document, enregistrez-le dans votre système de fichiers. Ensuite, téléchargez-le sur votre AWS IoT service depuis l' AWS explorateur.

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Développez la sous-section **Policies** (Politiques) et localisez la politique que vous voulez mettre à jour.

1. Pour ouvrir **Policy Name** (Nom de la politique), choisissez **Create Policy** (Créer une politique) à partir de **Document**.

1. Développez la politique que vous souhaitez mettre à jour, puis ouvrez le menu contextuel (clic droit) de la version de la politique que vous souhaitez modifier.

1. Pour ouvrir la version de la politique dans AWS Cloud9, choisissez **Afficher** dans le menu contextuel pour ouvrir la version de la politique.

1. Lorsque le document de politique est ouvert, modifiez-le et enregistrez les modifications.
**Note**  
À ce stade, les modifications que vous avez apportées à la politique sont uniquement enregistrées dans votre système de fichiers local. Pour mettre à jour la version et en effectuer le suivi à l'aide de l' AWS explorateur, répétez les étapes décrites dans[Upload a new policy version](#policy-version-upload).<a name="policy-version-default"></a>

**Pour sélectionner une nouvelle version de la politique par défaut**

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Développez la sous-section **Policies** (Politiques) et localisez la politique que vous voulez mettre à jour.

1. Développez la politique que vous souhaitez mettre à jour, puis ouvrez le menu contextuel (clic droit) de la version de la politique que vous souhaitez définir et sélectionnez **Set as Default** (Définir comme valeur par défaut). 

   Lorsque cette opération est terminée, la nouvelle version par défaut que vous avez sélectionnée est accompagnée d'une étoile.<a name="policy-delete"></a>

**Pour supprimer des stratégies**
**Note**  
Avant de pouvoir supprimer une politique ou une version de politique, assurez-vous que les conditions suivantes sont remplies :  
Vous ne pouvez pas supprimer une politique si elle est attachée à un certificat.
Vous ne pouvez pas supprimer une politique si cette politique comporte des versions autres que celles par défaut.
Vous pouvez uniquement supprimer la version par défaut d'une politique si une nouvelle version par défaut est sélectionnée ou si la politique entière est supprimée.
Avant de supprimer une politique entière, vous devez supprimer toutes les versions autres que la version par défaut de cette même politique.

1. Dans l' AWS explorateur, développez la section des services **IoT**.

1. Développez la sous-section **Policies** (Politiques) et localisez la politique que vous voulez mettre à jour.

1. Développez la politique que vous souhaitez mettre à jour, puis ouvrez le menu contextuel (clic droit) de la version de la politique que vous souhaitez supprimer et sélectionnez **Delete** (Supprimer).

1. Lorsqu'une version est supprimée, elle n'est plus visible dans l' AWS explorateur.

1. S'il ne reste que la version par défaut d'une politique, ouvrez le menu contextuel (clic droit) de la politique parent et choisissez **Delete** (Supprimer).