# Mise en route avec AWS IoT Wireless Vous pouvez démarrer avec AWS IoT Wireless en ouvrant un Compte AWS et en suivant les étapes pour créer un utilisateur IAM. Une fois inscrit, vous pouvez utiliser la AWS Management Console, l’API AWS IoT Wireless ou AWS CLI pour intégrer vos appareils et vos passerelles Sidewalk et LoRaWAN. Lors de l’intégration de vos appareils, réfléchissez à la façon de décrire et de baliser vos ressources pour vous permettre de les identifier plus facilement. Les rubriques suivantes vous montrent comment démarrer avec AWS IoT Wireless. **Topics** + [Configuration d’AWS IoT Wireless](setting-up-iotwireless.md) + [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md) # Configuration d’AWS IoT Wireless Lorsque vous vous inscrivez à AWS, votre Compte AWS est automatiquement inscrit à tous les services d’AWS, y compris AWS IoT Wireless. Seuls les services que vous utilisez vous sont facturés. Pour configurer AWS IoT Wireless, effectuez les étapes de la section suivante : **Topics** + [Configurez votre Compte AWS](#iotwireless-setup-account) + [Installation de Python et d’AWS CLI](#wireless-onboard-prereq) ## Configurez votre Compte AWS Avant d’utiliser AWS IoT Core for LoRaWAN ou AWS IoT Core pour Amazon Sidewalk pour la première fois, exécutez les tâches suivantes pour configurer votre Compte AWS. **Topics** + [Inscription à un compte AWS](#aws-sign-up-iotwireless) + [Créer un utilisateur IAM](#create-iam-user-iotwireless) + [Connectez-vous en tant qu'utilisateur IAM.](#sign-in-iam-user-iotwireless) ### Inscription à un compte AWS Si vous n’avez pas de compte Compte AWS, procédez comme suit pour en créer un. **Pour s’inscrire à un Compte AWS** 1. Ouvrez [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Suivez les instructions en ligne. Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone. Lorsque vous souscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS* est créé. Par défaut, seul l’utilisateur root a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à [attribuer un accès administratif à un utilisateur administratif](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html), et à uniquement utiliser l’utilisateur root pour effectuer les [tâches nécessitant un accès utilisateur root](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html). ### Créer un utilisateur IAM Afin de créer un utilisateur administrateur, choisissez l'une des options suivantes : **** | Choisissez un moyen de gérer votre administrateur | Pour | Par | Vous pouvez également | | --- | --- | --- | --- | | Dans IAM Identity Center (Recommandé) | Utiliser des identifiants à court terme pour accéder à AWS.Telles sont les meilleures pratiques en matière de sécurité. Pour plus d'informations sur les bonnes pratiques, veuillez consulter [Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) (français non garanti) dans le *Guide de l'utilisateur IAM*. | Suivre les instructions de la section [Mise en route](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) dans le AWS IAM Identity Center Guide de l'utilisateur. | Configuration de l'accès par programmation en [Configurant le AWS CLI à utiliser AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html)dans le AWS Command Line InterfaceGuide de l'utilisateur. | | Dans IAM (Non recommandé) | Utiliser des identifiants à long terme pour accéder à AWS. | Suivre les instructions relatives à la [Création de votre premier groupe utilisateur administrateur et utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) dans le Guide de l'utilisateur IAM. | Configuration de l'accès par programmation via la [Gestion des clés d'accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le Guide de l'utilisateur IAM. | ### Connectez-vous en tant qu'utilisateur IAM. Après avoir créé un utilisateur IAM, vous pouvez vous connecter à AWS avec vos nom d'utilisateur et mot de passe IAM. Avant de vous connecter en tant qu'utilisateur IAM, vous pouvez vérifier le lien de connexion pour les utilisateurs IAM dans la console IAM. Dans le tableau de bord IAM, le lien de connexion de votre Compte AWS s’affiche sous Lien de connexion des utilisateurs IAM. L'URL de votre lien de connexion contient votre ID de Compte AWS sans tirets (-). Si vous ne souhaitez pas que l'URL de votre lien de connexion contienne votre ID de Compte AWS, vous pouvez créer un alias de compte. Pour de plus amples informations, veuillez consulter [Création, suppression et affichage d'un alias de Compte AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias) dans le *Guide de l'utilisateur IAM*. **Pour vous connecter en tant qu’utilisateur IAM** 1. Déconnectez-vous de la AWS Management Console. 1. Entrez votre lien de connexion, qui inclut votre ID de Compte AWS (sans tirets) ou votre alias de Compte AWS. ``` https://aws_account_id_or_alias.signin.aws.amazon.com/console ``` 1. Saisissez le nom utilisateur et le mot de passe IAM que vous venez de créer. Une fois la connexion établie, la barre de navigation affiche *« votre\$1nom\$1utilisateur @ votre\$1ID\$1compte\$1AWS »*. ## Installation de Python et d’AWS CLI Avant de connecter votre terminal LoRaWAN ou Sidewalk, vous devez installer Python et configurer AWS CLI. **Important** Pour effectuer l’intégralité du processus d’intégration pour la mise en service et l’enregistrement de votre terminal Sidewalk, vous devez également configurer votre passerelle Sidewalk et le HDK. Pour obtenir des instructions, veuillez consulter les sections [Configuration du kit de développement matériel (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) et [Configuration d’une passerelle Sidewalk](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) dans la documentation *Amazon Sidewalk*. **Topics** + [Installer Python et Python3-pip](#wireless-prereq-python) + [Configuration d’AWS CLI](#wireless-prereq-cli) ### Installer Python et Python3-pip Pour utiliser AWS CLI et boto3 comme décrit dans la section suivante, vous devez utiliser Python version 3.6 ou ultérieure. Si vous souhaitez intégrer vos terminaux à l’aide de la console AWS IoT, vous pouvez ignorer cette section et continuer à configurer votre Compte AWS. Pour vérifier si vous avez déjà installé Python et Python3-PIP, exécutez les commandes suivantes. Si l’exécution de ces commandes renvoie la version, cela signifie que Python et Python3-PIP ont été correctement installés. ``` python3 -V pip3 --version ``` Si cette commande renvoie une erreur, cela peut être dû au fait que Python n’est pas installé ou que votre système d’exploitation appelle le fichier exécutable Python v3.x en tant que Python3. Dans ce cas, remplacez toutes les instances de `python` par `python3` lorsque vous exécutez les commandes. Si l’erreur persiste, téléchargez et exécutez le programme d’[installation de Python](https://www.python.org/downloads/) ou installez Python en fonction de votre système d’exploitation, comme décrit ci-dessous. ------ #### [ Windows ] Sur votre machine Windows, téléchargez Python depuis le [site Web de Python](https://www.python.org/downloads/windows/), puis exécutez le programme d’installation pour installer Python sur votre machine. ------ #### [ Linux ] Sur votre machine Ubuntu, exécutez la commande `sudo` suivante pour installer Python. ``` sudo apt install python3 sudo apt install python3-pip ``` ------ #### [ macOS ] Sur votre ordinateur Mac, utilisez Homebrew pour installer Python. Homebrew installe également pip, qui pointe alors vers la version Python3 installée. ``` $ brew install python ``` ------ ### Configuration d’AWS CLI Les étapes suivantes vous montrent comment configurer AWS CLI et boto3 (AWS SDK pour Python). Avant de suivre ces étapes, vous devez ouvrir un Compte AWS et créer un utilisateur administratif. Pour obtenir des instructions, veuillez consulter [Configuration d’AWS IoT Wireless](#setting-up-iotwireless). 1. **Installation et configuration de l’AWS CLI** Vous pouvez utiliser AWS CLI pour intégrer par programmation vos terminaux Sidewalk à AWS IoT Core pour Amazon Sidewalk. Si vous souhaitez intégrer vos appareils à l’aide de la console AWS IoT, vous pouvez ignorer cette section. Ouvrez la [console AWS IoT Core](https://console.aws.amazon.com/iot/home#/), puis passez à la section suivante pour commencer à connecter vos appareils à AWS IoT Core pour Amazon Sidewalk. Pour obtenir les instructions de configuration de l’AWS CLI, consultez [Installation et configuration de l’AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. **Installez boto3 (AWS SDK pour Python)** Les commandes suivantes vous montrent comment installer boto3 (AWS SDK pour Python) et l’AWS CLI. Vous installerez également botocore, qui est requis pour exécuter boto3. Pour obtenir des instructions détaillées, veuillez consulter la section [Installation de Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation) dans le *guide de documentation de Boto3*. **Note** `awscli` version `1.26.6` nécessite une version de PyYAML 3.10 ou ultérieure, mais pas plus récente que la version 5.5. ``` python3 -m pip install botocore-version-py3-none-any.whl python3 -m pip install boto3-version-py3-none-any.whl ``` 1. **Configurez vos informations d’identification et région par défaut.** Configurez vos informations d’identification et région par défaut dans les fichiers `~/.aws/credentials` et `~/.aws/config` suivants. La bibliothèque boto3 utilise ces informations d’identification pour identifier Compte AWS et autoriser vos appels d’API. Pour obtenir les instructions de configuration IPv6, veuillez consulter : + [Configuration](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) dans le *Guide de documentation Boto3* + [Paramètres des fichiers de configuration et d’informations d’identification](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) dans le *Guide de documentation AWS CLI* # Description de vos ressources AWS IoT Wireless Avant de commencer à intégrer vos appareils LoRaWAN ou Sidewalk, tenez compte de la convention de dénomination de vos appareils, de vos passerelles et de votre destination. AWS IoT Wireless propose plusieurs options pour vous permettre d’identifier les ressources que vous créez. Bien que les ressources AWS IoT Wireless reçoivent un identifiant unique lors de leur création, celui-ci n’est pas descriptif et ne peut pas être modifié une fois la ressource créée. Pour faciliter la sélection, l’identification et la gestion de vos ressources, vous pouvez attribuer un nom, ajouter une description et associer des balises et des valeurs de balise à la plupart des ressources AWS IoT Wireless. + **[Noms et description des ressources](#wireless-describe-resource-names)** Pour les appareils, les passerelles et les profils, le nom de la ressource est un champ facultatif que vous pouvez modifier une fois la ressource créée. Le nom apparaît dans les listes affichées sur les pages du centre de ressources. Pour les destinations, vous fournissez un nom unique dans votre compte AWS etRégion AWS. Vous ne pouvez pas modifier le nom de la destination après avoir créé la ressource de destination. Bien qu’un nom puisse comporter jusqu’à 256 caractères, l’espace d’affichage dans le centre de ressources est limité. Assurez-vous que la partie distinctive du nom apparaît dans les 20 à 30 premiers caractères, si possible. + **[Balises de ressources](#wireless-describe-resource-tags)** Les balises sont des paires clé-valeur de métadonnées qui peuvent être attachées aux ressources AWS. Vous choisissez les deux clés de balise et leurs valeurs correspondantes. Jusqu’à 50 balises peuvent être attachées aux passerelles, aux destinations et aux profils. Les appareils ne prennent pas en charge les balises. ## Noms et description des ressources **Prise en charge du nom des ressources AWS IoT Wireless** | Ressource | Prise en charge du champ de nom | | --- | --- | | Destination | Le nom est l’ID unique de la ressource et ne peut pas être modifié. | | Appareil sans fil | Le nom est un descripteur facultatif de la ressource et peut être modifié. | | Passerelle LoRaWAN | Le nom est un descripteur facultatif de la ressource et peut être modifié. | | Profil | Le nom est un descripteur facultatif de la ressource et peut être modifié. | Le champ du nom apparaît dans les listes de ressources du centre de ressources ; toutefois, l’espace étant limité, seuls les 15 à 30 premiers caractères du nom peuvent être visibles. Lorsque vous sélectionnez des noms pour vos ressources, réfléchissez à la manière dont vous souhaitez qu’ils identifient les ressources et à la manière dont elles seront affichées dans la console. **Description** Les ressources de destination, d’appareil et de passerelle prennent également en charge un champ de description, qui peut accepter jusqu’à 2 048 caractères. Le champ de description apparaît uniquement dans la page détaillée de chaque ressource. Bien que le champ de description puisse contenir de nombreuses informations, étant donné qu’il n’apparaît que dans la page détaillée de la ressource, il n’est pas pratique à analyser dans le contexte de plusieurs ressources. ## Balises de ressources **Prise en charge des balises AWS pour les ressources AWS IoT Wireless** | Ressource | Prise en charge des balises AWS | | --- | --- | | Destination | Vous pouvez ajouter jusqu’à 50 balises AWS à la ressource. | | Appareil sans fil | Cette ressource ne prend pas en charge les balises AWS. | | Passerelle LoRaWAN | Vous pouvez ajouter jusqu’à 50 balises AWS à la ressource. | | Profil | Vous pouvez ajouter jusqu’à 50 balises AWS à la ressource. | Les balises sont des mots ou des expressions qui agissent comme des métadonnées qui permettent d’identifier et d’organiser vos ressources AWS. Vous pouvez considérer la clé de balise comme une catégorie d’informations et la valeur de balise comme une valeur spécifique dans cette catégorie. Par exemple, vous pouvez avoir une valeur de balise de *couleur*, puis attribuer à certaines ressources une valeur *bleue* pour cette balise et une valeur *rouge* à d’autres. Vous pouvez ainsi utiliser l’[éditeur de balises](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) de la console AWS pour rechercher les ressources dont la valeur de balise de *couleur* est *bleue*. Pour plus d’informations sur le balisage dans AWS IoT Wireless, consultez [Balisage de vos ressources AWS IoT Wireless](tagging-iotwireless.md). Pour de plus amples informations sur le balisage et les stratégies de balisage, veuillez consulter l’[éditeur de balises](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).