# Connexion à AWS IoT Core pour Amazon Sidewalk
Cette section explique comment intégrer votre terminal Sidewalk, puis comment connecter votre appareil au réseau Sidewalk. Il décrit les étapes que vous effectuez dans le didacticiel d’intégration, comme indiqué dans [Présentation de l’intégration de vos appareils Sidewalk](sidewalk-gs-workflow.md). Vous apprendrez à intégrer des appareils à l’aide de la console AWS IoT et des opérations d’API AWS IoT Core pour Amazon Sidewalk. Vous découvrirez également les commandes AWS CLI qui exécutent ces opérations.
## Prérequis
Pour ajouter votre terminal et votre destination à AWS IoT Core pour Amazon Sidewalk, vous devez configurer votre Compte AWS. Pour effectuer ces opérations à l’aide de l’API AWS IoT Wireless ou des commandes AWS CLI, vous devez également configurer l’AWS CLI. Pour plus d'informations sur les conditions préalables et la configuration, consultez [Installation de Python et d’AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq).
**Note**
Pour effectuer l’intégralité du processus d’intégration pour la mise en service et l’enregistrement de votre terminal, ainsi que pour la connexion à votre kit de développement matériel (HDK), vous devez également configurer votre passerelle Sidewalk et votre HDK. Pour plus d’informations, consultez [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*.
## Description de vos ressources Sidewalk
Avant de commencer à créer les ressources, nous vous recommandons de prendre en compte la convention de dénomination de vos terminaux, profils d’appareils et destinations Sidewalk. AWS IoT Core pour Amazon Sidewalk attribue un identifiant unique aux ressources que vous créez. Vous pouvez toutefois leur donner des noms plus descriptifs, ajouter une description ou ajouter des balises facultatives pour faciliter leur identification et leur gestion.
**Note**
Le nom de destination ne peut pas être modifié une fois créé. Utilisez un nom propre à votre Compte AWS et Région AWS.
Pour en savoir plus, consultez [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md).
**Topics**
+ [Prérequis](#sidewalk-connect-prereq)
+ [Description de vos ressources Sidewalk](#sidewalk-connect-resources)
+ [Ajout de votre appareil à AWS IoT Core pour Amazon Sidewalk](iot-sidewalk-create-device.md)
+ [Ajoutez une destination pour votre terminal Sidewalk](iot-sidewalk-qsg-destination.md)
+ [Connectez votre appareil Sidewalk et visualisez le format des métadonnées de liaison montante](iot-sidewalk-connect-uplink-metadata.md)
# Ajout de votre appareil à AWS IoT Core pour Amazon Sidewalk
Avant de créer un appareil sans fil, créez d’abord un profil d’appareil. Les profils d’appareils définissent les capacités de l’appareil et les autres paramètres de vos appareils Sidewalk. Un profil d’appareil unique peut être associé à plusieurs appareils.
Après avoir créé un profil d’appareil, lorsque vous récupérez des informations sur le profil, celui-ci renvoie un `DeviceTypeId`. Lorsque vous effectuez la mise en service votre terminal, vous utiliserez cet identifiant, les certificats de l’appareil, la clé publique du serveur d’applications et le SMSN.
## Comment créer et ajouter votre appareil
1. Créez un profil d’appareil pour vos terminaux Sidewalk. Spécifiez un nom de profil à utiliser pour vos appareils Sidewalk sous forme de chaîne alphanumérique. Le profil permettra d’identifier les appareils auxquels l’associer.
+ (Console) Lorsque vous ajoutez votre appareil Sidewalk, vous pouvez également créer un nouveau profil. Cela vous permet d’ajouter rapidement votre appareil à AWS IoT Core pour Amazon Sidewalk et de l’associer à un profil.
+ (API) Utilisez l’opération API `CreateDeviceProfile` en spécifiant un nom de profil et l’objet Sidewalk, `sidewalk {}`. La réponse de l’API contiendra un ID de profil et un ARN (Amazon Resource Name).
1. Ajoutez votre appareil sans fil à AWS IoT Core pour Amazon Sidewalk. Spécifiez un nom de destination et choisissez le profil d’appareil que vous avez créé à l’étape précédente.
+ (Console) Lorsque vous ajoutez votre appareil Sidewalk, entrez un nom de destination et choisissez le profil que vous avez créé.
+ (API) Utilisez l’opération d’API `CreateWirelessDevice`. Spécifiez un nom de destination et l’ID du profil d’appareil obtenu précédemment.
**Paramètres de l’appareil sans fil**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/iot-sidewalk-create-device.html)
1. Procurez-vous le fichier JSON contenant les informations requises pour la mise en service de votre appareil final.
+ (Console) Téléchargez ce fichier depuis la page de détails de l’appareil Sidewalk que vous avez créé.
+ (API) Utilisez les opérations d’API `GetDeviceProfile` et `GetWirelessDevice` pour récupérer des informations sur le profil de votre appareil et votre appareil sans fil. Stockez les informations de réponse de l’API sous forme de fichiers JSON, tels que *`device_profile.json`* et *`wireless_device.json`*.
# Ajoutez le profil de votre appareil et le terminal Sidewalk
Cette section explique comment créer un profil d’appareil. Il montre également comment utiliser la console AWS IoT et l’AWS CLI pour ajouter votre terminal Sidewalk à AWS IoT Core pour Amazon Sidewalk.
## Ajoutez votre appareil Sidewalk (console)
Pour ajouter votre appareil Sidewalk à l’aide de la AWS IoT console, accédez à [l’onglet Sidewalk du centre d’Appareils](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), choisissez **Mettre en service un appareil**, puis effectuez les étapes suivantes.
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/images/iot-sidewalk-provision-device.PNG)
1.
**Spécification des détails de l’appareil**
Spécifiez les informations de configuration de votre appareil Sidewalk. Vous pouvez également créer un nouveau profil d’appareil ou choisir un profil existant pour votre appareil Sidewalk.
1. Spécifiez un nom de l’appareil et une description facultative. La description peut comporter jusqu’à 2 048 caractères. Ces champs peuvent être modifiés après avoir créé l’appareil.
1. Choisissez un profil d’appareil à associer à votre appareil Sidewalk. Si vous avez des profils d’appareils existants, vous pouvez choisir votre profil. Pour créer un nouveau profil, sélectionnez **Créer un nouveau profil**, puis saisissez un nom pour le profil.
**Note**
Pour associer des tags au profil de votre appareil, après avoir créé votre profil, accédez au [centre de Profils](https://console.aws.amazon.com/iot/home#/wireless/profiles), puis modifiez votre profil pour ajouter ces informations.
1. Spécifiez le nom de la destination qui acheminera les messages de votre appareil vers un autre Services AWS. Si vous n’avez pas encore créé de destination, rendez-vous dans le [centre Destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations) pour créer votre destination. Vous pouvez ensuite choisir cette destination pour votre appareil Sidewalk. Pour en savoir plus, consultez [Ajoutez une destination pour votre terminal Sidewalk](iot-sidewalk-qsg-destination.md).
1. Choisissez **Suivant** pour continuer à ajouter votre appareil Sidewalk.
1.
**Associer un appareil Sidewalk à un objet AWS IoT (facultatif)**
Vous pouvez éventuellement associer votre appareil Sidewalk à n’importe quel objet AWS IoT. Les objets IoT sont des entrées dans le registre d'appareils AWS IoT. Les objets peuvent faciliter la recherche et la gestion de vos appareils. Associer un objet à votre appareil permet à celui-ci d’accéder à d’autres fonctionnalités AWS IoT Core.
Pour associer votre appareil à un objet, choisissez **Enregistrement automatique des objets**.
1. Entrez un nom unique pour l’objet IoT que vous souhaitez associer à votre appareil Sidewalk. Les noms d’objets distinguent les majuscules et minuscules et doivent être uniques dans votre Compte AWS et Région AWS.
1. Fournissez des configurations supplémentaires pour votre objet IoT, par exemple en utilisant un type d’objet, ou des attributs consultables pouvant être utilisés pour filtrer des objets dans une liste d’objets.
1. Choisissez **Suivant** et vérifiez les informations relatives à votre appareil Sidewalk, puis choisissez **Créer**.
## Ajoutez votre appareil Sidewalk (CLI)
Pour ajouter votre appareil Sidewalk et télécharger les fichiers JSON qui seront utilisés pour mettre en service votre appareil Sidewalk, effectuez les opérations d’API suivantes.
**Topics**
+ [Étape 1 : Créer un profil d’appareil](#iot-sidewalk-profile-create)
+ [Étape 2 : Ajouter votre appareil Sidewalk](#iot-sidewalk-device-create)
### Étape 1 : Créer un profil d’appareil
Pour créer un profil d’appareil dans votre Compte AWS, utilisez l’opération de l’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html). Lorsque vous créez un profil, spécifiez un nom et des balises facultatives sous forme de paires nom-valeur.
Par exemple, la commande suivante crée un profil d’appareil pour vos appareils Sidewalk :
```
aws iotwireless create-device-profile \
--name sidewalk_profile --sidewalk {}
```
L’exécution de cette commande renvoie l’Amazon Resource Name (ARN) et l’ID du profil de l’appareil en sortie.
```
{
"DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
```
### Étape 2 : Ajouter votre appareil Sidewalk
Pour ajouter votre appareil Sidewalk à votre compte pour AWS IoT Core pour Amazon Sidewalk, utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html). Lorsque vous créez votre appareil, spécifiez les paramètres suivants, en plus du nom et de la description facultatifs de votre appareil Sidewalk.
**Note**
Si vous souhaitez associer votre appareil Sidewalk à un objet AWS IoT, utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithThing.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html](https://docs.aws.amazon.com/cli/latest/reference/associate-wireless-device-with-thing.html).
La commande suivante montre un exemple de création d’un appareil Sidewalk :
```
aws iotwireless create-wireless-device \
--cli-input-json "file://device.json"
```
L’exemple suivant affiche le contenu du fichier `device.json`.
**Contenu de device.json**
```
{
"Type": "Sidewalk",
"Name": "SidewalkDevice",
"DestinationName": "SidewalkDestination",
"Sidewalk": {
"DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}
}
```
L’exécution de cette commande renvoie l’ID de l’appareil et l’Amazon Resource Name (ARN) en sortie.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
"Id": "23456789-abcd-0123-bcde-fabc012345678"
}
```
# Obtenir les fichiers JSON de l’appareil pour la mise en service
Après avoir ajouté votre appareil Sidewalk à AWS IoT Core pour Amazon Sidewalk, téléchargez le fichier JSON contenant les informations requises pour la mise en service de votre terminal. Vous pouvez récupérer ces informations à l’aide de la console AWS IoT ou du AWS CLI. Pour plus d’informations sur la mise en service de l’appareil, consultez la section [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) dans la documentation *Amazon Sidewalk*.
## Obtenir un fichier JSON (console)
Pour obtenir le fichier JSON permettant de mettre en service votre appareil Sidewalk, procédez comme suit :
1. Accédez au [centre des appareils Sidewalk](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk).
1. Choisissez l’appareil que vous avez ajouté à AWS IoT Core pour Amazon Sidewalk pour afficher ses détails.
1. Obtenez le fichier JSON en choisissant **Télécharger le fichier JSON de l’appareil** sur la page de détails de l’appareil que vous avez ajouté.
Un fichier `certificate.json` contenant les informations requises pour la mise en service de votre terminal sera téléchargé. L’illustration ci-dessous présente un exemple de fichier JSON. Il contient les certificats de l’appareil, les clés privées, le numéro de série de fabrication (SMSN) de Sidewalk et le `DeviceTypeID`.
```
{
"p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
"eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
"metadata": {
"devicetypeid": "fe98",
"applicationDeviceArn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/897ce68e-3ca2-4ed0-85a2-30b0666c4052",
"applicationDeviceId": "897ce68e-3ca2-4ed0-85a2-30b0666c4052",
"smsn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A",
"devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
"devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
},
"applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}
```
Sur la page de détails de votre appareil Sidewalk, vous trouverez également des informations sur :
+ L’ID de l’appareil, son Amazon Resource Name (ARN) et les détails de tout objet AWS IoT auquel l’appareil est associé.
+ Le profil de l’appareil et les détails de la destination.
+ Heure à laquelle le dernier message de liaison montante a été reçu de l’appareil.
+ État qui indique si votre appareil a été mis en service ou enregistré.
## Obtenir un fichier JSON (CLI)
Pour obtenir les fichiers JSON permettant de mettre en service votre terminal Sidewalk à l’aide de l’API AWS IoT Core pour Amazon Sidewalk ou de l’AWS CLI, enregistrez temporairement la réponse de l’API provenant de la récupération d’informations sur le profil de votre appareil et votre appareil sans fil sous forme de fichiers JSON, par exemple *`wireless_device.json`* et *`device_profile.json`*. Vous les utiliserez pour mettre en service votre appareil Sidewalk.
Voici comment extraire les fichiers JSON.
**Topics**
+ [Étape 1 : obtenir les informations du profil de l’appareil sous forme de fichier JSON](#iot-sidewalk-profile-get)
+ [Étape 2 : obtenir les informations de l’appareil Sidewalk sous forme de fichier JSON](#iot-sidewalk-get-device)
### Étape 1 : obtenir les informations du profil de l’appareil sous forme de fichier JSON
Utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html) pour obtenir des informations sur le profil de votre appareil que vous avez ajouté à votre compte pour AWS IoT Core pour Amazon Sidewalk. Pour récupérer des informations sur le profil de votre appareil, spécifiez l’ID du profil.
L’API renverra ensuite des informations sur le profil de l’appareil correspondant à l’identifiant spécifié et à l’identifiant de l’appareil. Vous enregistrez ces informations de réponse sous forme de fichier et vous leur donnez un nom tel que *`device_profile.json`*.
Ce qui suit présente un exemple de commande CLI.
```
aws iotwireless get-device-profile \
--id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json
```
L’exécution de cette commande renvoie les paramètres du profil de votre appareil, la clé publique du serveur d’applications et le `DeviceTypeID`. Ce qui suit montre un fichier JSON qui contient un exemple d’informations de réponse provenant de l’API. Pour plus d’informations sur les paramètres de la réponse de l’API, veuillez consulter [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html).
**`GetDeviceProfile`Réponse de l’API (contenu de `device_profile.json`)**
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
"Name": "Sidewalk_profile",
"LoRaWAN": null,
"Sidewalk":
{
"ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
"DAKCertificateMetadata": [
{
"DeviceTypeId: "fe98",
"CertificateId": "43564A6D2D50524F544F54595045",
"FactorySupport": false,
"MaxAllowedSignature": 1000
}
],
"QualificationStatus": false
}
}
```
### Étape 2 : obtenir les informations de l’appareil Sidewalk sous forme de fichier JSON
Utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) pour obtenir des informations sur l’appareil Sidewalk que vous avez ajouté à votre compte pour AWS IoT Core pour Amazon Sidewalk. Pour obtenir des informations sur votre terminal, fournissez l’identifiant de l’appareil sans fil que vous avez obtenu lors de l’ajout de votre appareil.
L’API renverra ensuite des informations sur l’appareil correspondant à l’identifiant spécifié et à l’identifiant de l’appareil. Enregistrez ces informations de réponse dans un fichier JSON. Donnez au fichier un nom pertinent comme *`wireless_device.json`*.
L’exemple suivant illustre l’exécution de la commande à l’aide de la CLI :
```
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json
```
L’exécution de cette commande renvoie les détails de l’appareil, les certificats de l’appareil, les clés privées et le numéro de série de fabrication (SMSN) de Sidewalk. La sortie de l’exécution de cette commande est présentée ci-dessous. Pour plus d’informations sur les paramètres de la réponse de l’API, veuillez consulter [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html).
**`GetWirelessDevice`Réponse de l’API (contenu de `wireless_device.json`)**
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
"Id": "23456789-abcd-0123-bcde-fabc012345678",
"DestinationName": "SidewalkDestination",
"Type": "Sidewalk",
"Sidewalk": {
"CertificateId": "4C7438772D50524F544F54595045",
"DeviceCertificates": [
{
"SigningAlg": "Ed25519",
"Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNl7NKe4ounb5UMQtLjnm7zOUPYOqghCeVOLCBUiQe2ZiMBEW18JDUXIhffPobqZgohK91+LKFJ10X/F+GeltcafZcFKhS+O5NPcVNR/fHYaf/cn5iUbRwlz/T+ODXvGdwkBkgDyFgoUJgn7JdzFjaneE5qzTWXUbL79i1sXToGGjP8hiD9jJhidPWhIswleydAWgO1OZGA4CjzIaSGVM1VtaLB0VDphAkEpjMkZrtVDH3S8U1vDZTVi6YSbnkYZgfWv/uMMBfgAeL8Tdv5LkFIPIB3ZX9zt8zzmAuFRzI4MuNjWfIDnOF6AKu37WWU6/QYhZoQrW9D/wndiCcsRGl+ANn367r/HE02Re4DOiCfs9f2rjc4LT1LKt7g/KW2ii+W+9HYvvY0bBAI+AHx6Cx4j+djabTsvrgW2k6NU2zUSM7bdDP3z2a2+Z4WzBji/jYwt/OP8rpsy5Ee4ywXUfCsfQ0rKOr0zay6yh27p3I3MZle2oCO4JIlqK0VbIQqsXzSSyp6XXS0lhmuGugZ1AAADGz+gFBeX/ZNN8VJwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHhU79Z+oAAYAAAzsnf9SDIZPoDXF0TdC9POqTgld0oXDl2XPaVD4CvvLearrOSlFv+lsNbC4rgZn23MtIBM/7YQmJwmQ+FXRup6Tkubg1hpz04J/09dxg8UiZmntHiUr1GfkTOFMYqRB+Aw=="
},
{
"SigningAlg": "P256r1",
"Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNmHmGU8a+SOqDXWwDNt3VSntpbTTQl7cMIusqweQo+JPXXWElbGh7eaxPGz4ZeF5yM2cqVNUrQr1lX/6lZ+OLuycrFrLzzB9APi0NIMLqV/Rt7XJssHQs2RPcT1ul/2XVpa6ztULJeQi2JwhTb/k48wbh/EvafG/ibrIBIx9v7/dwGRAPKHq7Uwb9hHnhpa8qNOUtjeUdIwJNh9vCBFX9s22t4PdortoFxbXo9C149PDDD4wqUHJGYlCsVX/Sqqjf7Aug3h5dwdYN6cDgsuuiOm0+aBcXBGpkh7OxVxlwXkIP+11dt23TkrSUKd0B01sc9Mc/0yEBCzx5RutKBwsefzyOl4vQX3AHgV7oD/XV73THMgGiDxQ55CPaaxN/pm791VkQ76BSZaBeF+Su6tg0k/eQneklt8Du5uqkyBHVxy8MvxsBIMZ73vIFwUrLHjDeq3+nOOyQqSBMnrHKU2mAwN3zb2LolwjPkKNOh1+NNnv99L2pBcNCnhnoBULWmWAZNXJpMx9QrcSwI9AHylcgUbGQJgf9Ryun+BgewzYNdWrXyKkp4O3ZDa4f+5SVWvbY5eyDDXcohvz/OcCtuRjAkzKBCvIjBDnCv1McjVdCO3+utizGntfhAo1RZstnOoRkgVF2WuMT9IrUmzYximuTXUmWtjyFSTqgNBZwHWUTlMmjlpLCVzZQWM4zOisXUAAALPsP34BS6EzJO5AsS5pC7QTpjBtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBjtvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4UrVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4AhsyjMvKCsZQiKgiI8ECwjfXBaSZdY4zYsRlO3FC428H1atrFChFCZT0Bqt5LPXD38bMSB+vAUJiP8XqiEdXeqf2mYMJ5ykoDpwkve/cUQfPpjzFQlQfvwjBwiJDANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw=="
}
],
"DeviceProfileId": "0ff5b0c6-f149-4498-af34-21993acd52a7",
"PrivateKeys": [
{
"SigningAlg": "Ed25519",
"Value": "2c24d4572327f23b9bef38097137c29224a9e979081b3d90124ac9dfa477934e"
},
{
"SigningAlg": "P256r1",
"Value": "38d526f29cfaf142f596deca187bd809ef71bc13435eedc885b63bb825d63def"
}
],
"SidewalkManufacturingSn": "843764270F4BDAE3023918C89A3307AB3351EA761887A40A9DC4A5E46B6140D9",
"Status": "PROVISIONED"
},
...
}
```
## Étapes suivantes
Stockez les fichiers JSON, *`wireless_device.json`* et *`device_profile.json`* temporairement, car vous les utiliserez à l’étape suivante pour mettre en service et enregistrer votre terminal afin de le connecter à la plate-forme matérielle. Pour plus d’informations, consultez la section [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) dans la *documentation Amazon Sidewalk*.
# Ajoutez une destination pour votre terminal Sidewalk
Utilisez des règles AWS IoT pour traiter les données et les messages de l’appareil et les acheminer vers d’autres services. Vous pouvez également définir des règles pour traiter les messages binaires reçus d’un appareil et les convertir dans d’autres formats afin de faciliter leur utilisation par d’autres services. Les destinations associent votre terminal Sidewalk à la règle qui traite les données de l’appareil pour les envoyer à d’autres Service AWS.
## Comment créer et utiliser une destination
1. Créez une règle AWS IoT et un rôle IAM pour la destination. La règle AWS IoT spécifie les règles qui traiteront les données de l’appareil et les achemineront pour qu’elles soient utilisées par d’autres Service AWS et par vos applications. Le rôle IAM accorde l’autorisation d’accéder à la règle.
1. Créez une destination pour vos appareils Sidewalk à l’aide de l’opération de l’API `CreateDestination`. Spécifiez le nom de la destination, le nom de la règle, le nom du rôle et tous les paramètres facultatifs. L’API renvoie un identifiant unique pour la destination, que vous pouvez spécifier lors de l’ajout de votre terminal à AWS IoT Core pour Amazon Sidewalk.
Ce qui suit montre comment créer une destination, ainsi qu’une règle AWS IoT et un rôle IAM pour la destination.
**Topics**
+ [Comment créer et utiliser une destination](#iot-sidewalk-destination-how)
+ [Créez une destination pour votre appareil Sidewalk](iot-sidewalk-destination-create.md)
+ [Créer un rôle IAM et une règle IoT pour votre destination](sidewalk-destination-rule-role.md)
# Créez une destination pour votre appareil Sidewalk
Vous pouvez ajouter une destination à votre compte pour AWS IoT Core pour Amazon Sidewalk soit à l’aide du [hub Destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations), soit à l’aide de `CreateDestination`. Lors de la création de votre destination, spécifiez :
+ Un nom unique pour la destination à utiliser pour votre terminal Sidewalk.
**Note**
Si vous avez déjà ajouté votre appareil en utilisant un nom de destination, vous devez utiliser ce nom lors de la création de votre destination. Pour en savoir plus, consultez [Étape 2 : Ajouter votre appareil Sidewalk](iot-sidewalk-add-device.md#iot-sidewalk-device-create).
+ Le nom de la règle AWS IoT qui traitera les données de l’appareil et le sujet dans lequel les messages sont publiés.
+ Rôle IAM qui accorde aux données de l’appareil l’autorisation d’accéder à la règle.
Les sections suivantes décrivent comment créer la règle AWS IoT et le rôle IAM pour votre destination.
## Créer une destination (console)
Pour créer une destination à l’aide de la console AWS IoT, accédez au [centre Destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations) et choisissez **Ajouter une destination**.
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/images/iot-sidewalk-add-destination.PNG)
Pour traiter les données d’un appareil, spécifiez les champs suivants lors de la création d’une destination, puis choisissez **Ajouter une destination**.
+
**Détails de la destination**
Entrez un **nom de destination** et une description facultative pour votre destination.
+
**Nom de la règle**
La règle AWS IoT configurée pour évaluer les messages envoyés par votre appareil et traiter les données de celui-ci. Le nom de la règle sera mappé à votre destination. La destination a besoin de la règle pour traiter les messages qu’elle reçoit. Vous pouvez choisir de traiter les messages en invoquant une règle AWS IoT ou en les publiant sur l’agent de messages AWS IoT.
+ Si vous choisissez **Entrez un nom de règle**, entrez un nom, puis choisissez **Copier** pour copier le nom de règle que vous allez entrer lors de la création de la règle AWS IoT. Vous pouvez soit choisir **Créer une règle** pour créer la règle maintenant, soit accéder au centre de [règles](https://console.aws.amazon.com/iot/home#/create/rule) de la AWS IoT console et créer une règle portant ce nom.
Vous pouvez également entrer une règle et utiliser le paramètre **Avancé** pour spécifier un nom de rubrique. Le nom du sujet est fourni lors de l’invocation de la règle et est accessible à l’aide de l’expression `topic` contenue dans la règle. Pour plus d’informations sur les règles AWS IoT, consultez [AWS IoT Règles](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html).
+ Si vous choisissez **Publier sur AWS IoT l’agent de messages**, entrez le nom du sujet. Vous pouvez ensuite copier le nom du sujet MQTT et plusieurs abonnés peuvent s’abonner à ce sujet pour recevoir les messages publiés sur ce sujet. Pour plus d’informations, consultez [les rubriques MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).
Pour plus d’informations sur les règles AWS IoT relatives aux destinations, voir [Créer des règles pour traiter les messages des appareils LoRaWAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
+
**Nom du rôle**
Le rôle IAM qui autorise les données de l’appareil à accéder à la règle nommée dans **Nom de la règle**. Dans la console, vous pouvez créer une nouvelle fonction du service ou sélectionner une fonction du service existant. Si vous créez un nouvelle fonction du service, vous pouvez soit entrer un nom de rôle (par exemple,**SidewalkDestinationRole**), soit le laisser vide AWS IoT Core for LoRaWAN pour générer un nouveau nom de rôle. AWS IoT Core for LoRaWAN créera ensuite automatiquement le rôle IAM avec les autorisations appropriées en votre nom.
## Créer une destination (CLI)
Pour créer une destination, utilisez l’opération de l’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html). Par exemple, la commande suivante crée une destination pour votre terminal Sidewalk :
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
L’exécution de cette commande renvoie les détails de destination, notamment l’Amazon Resource Name (ARN) et le nom de destination.
```
{
"Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination",
"Name": "SidewalkDestination"
}
```
Pour plus d’informations sur la création d’une destination, consultez [Création de règles pour traiter les messages des appareils LoRaWAN](https://docs.aws.amazon.com/iot/latest/developerguide/connect-iot-lorawan-destination-rules.html).
# Créer un rôle IAM et une règle IoT pour votre destination
Les règles AWS IoT envoient des messages de l’appareil à d’autres services. Les règles AWS IoT peuvent également traiter les messages binaires reçus d’un terminal Sidewalk pour que d’autres services puissent les utiliser. Les destinations AWS IoT Core pour Amazon Sidewalk associent un appareil sans fil à la règle qui traite les données des messages de l’appareil pour les envoyer à d’autres services. La règle agit sur les données de l’appareil dès qu’AWS IoT Core pour Amazon Sidewalk les reçoit. Pour tous les appareils qui envoient leurs données au même service, vous pouvez créer une destination qui peut être partagée par tous les appareils. Vous devez également créer un rôle IAM qui autorise l’envoi de données à la règle.
## Créer un rôle IAM pour votre destination
Créez un rôle IAM qui autorise AWS IoT Core pour Amazon Sidewalk à envoyer des données à la règle AWS IoT. Pour créer le rôle, utilisez l’opération d’API [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role). Vous pouvez nommer le rôle comme *`SidewalkRole`*.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
```
Vous pouvez également définir la politique d’approbation pour le rôle à l’aide d’un fichier JSON.
```
aws iam create-role --role-name SidewalkRole \
--assume-role-policy-document file://trust-policy.json
```
L’exemple suivant affiche le contenu du fichier JSON.
**Contenu de trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Créez une règle pour votre destination
Utilisez l’opération de l’API, AWS IoT Core [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html), ou la commande AWS CLI, [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), pour créer une règle. La règle du sujet sera utilisée par votre destination pour acheminer les données reçues de votre terminal Sidewalk vers un autre Services AWS. Par exemple, vous pouvez créer une action de règle qui envoie un message à une fonction Lambda. Vous pouvez définir la fonction Lambda de telle sorte qu’elle reçoive les données d’application de votre appareil et utilise le base64 pour décoder les données de charge utile afin qu’elles puissent être utilisées par d’autres applications.
Les étapes suivantes montrent comment créer la fonction Lambda, puis une règle de rubrique qui envoie un message à cette fonction.
1.
**Créer un rôle et une stratégie d’exécution**
Créez un rôle IAM qui accorde à votre fonction la permission d'accéder aux ressources AWS. Vous pouvez également définir la politique d’approbation pour le rôle à l’aide d’un fichier JSON.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
L’exemple suivant affiche le contenu du fichier JSON.
**Contenu de lambda-trust-policy.json**
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
1.
**Créer et tester la fonction Lambda.**
Procédez comme suit pour créer une fonction AWS Lambda qui décode les données de charge utile en base64.
1. Écrivez le code pour décoder les données de charge utile. Par exemple, vous pouvez utiliser l’exemple de code Python suivant. Spécifiez un nom pour le script, par exemple *`base64_decode.py`*.
**Contenu du fichier base64\$1decode.py**
```
// -----------------------------------------------------------
// ----- Python script to decode incoming binary payload -----
// -----------------------------------------------------------
import json
import base64
def lambda_handler(event, context):
message = json.dumps(event)
print (message)
payload_data = base64.b64decode(event["PayloadData"])
print(payload_data)
print(int(payload_data,16))
```
1. Créez un package de déploiement sous la forme d’un fichier zip contenant le fichier Python et nommez-le comme `base64_decode.zip`. Utilisez l’API `CreateFunction` ou la commande CLI `create-function` pour créer une fonction Lambda pour l’exemple de code, *`base64_decode.py`*.
1.
```
aws lambda create-function --function-name my-function \
--zip-file fileb://base64_decode.zip --handler index.handler \
--runtime python3.9 --role arn:aws:iam::123456789012:role/lambda-ex
```
Le résultat suivant doit s'afficher. Vous utiliserez la valeur Amazon Resource Name (ARN) de la sortie, `FunctionArn`, lors de la création de la règle de sujet.
```
{
"FunctionName": "my-function",
"FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function",
"Runtime": "python3.9",
"Role": "arn:aws:iam::123456789012:role/lambda-ex",
"Handler": "index.handler",
"CodeSha256": "FpFMvUhayLkOoVBpNuNiIVML/tuGv2iJQ7t0yWVTU8c=",
"Version": "$LATEST",
"TracingConfig": {
"Mode": "PassThrough"
},
"RevisionId": "88ebe1e1-bfdf-4dc3-84de-3017268fa1ff",
...
}
```
1. Pour obtenir les journaux d’une invocation à partir de la ligne de commande, utilisez l’option `--log-type` avec la commande `invoke`. La réponse inclut un champ LogResult qui contient jusqu’à 4 Ko de journaux codés en base64 provenant de l’invocation.
```
aws lambda invoke --function-name my-function out --log-type Tail
```
Vous devez recevoir une réponse avec un `StatusCode` de 200. Pour plus d’informations sur la création et l’utilisation de fonction Lambda à partir de AWS CLI, consultez [Utiliser une fonction Lambda avec AWS CLI](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-awscli.html).
1. Créer une règle de rubrique
Utilisez l’API `CreateTopicRule` ou la commande CLI `create-topic-rule` pour créer une règle de rubrique qui envoie un message à cette fonction Lambda. Vous pouvez également ajouter une deuxième action de règle qui republie dans une rubrique AWS IoT. Donnez à cette règle de rubrique le nom `Sidewalkrule`.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
Vous pouvez utiliser le fichier `myrule.json` pour spécifier plus de détails sur la règle. Par exemple, le fichier JSON suivant montre comment republier dans une rubrique AWS IoT et envoyer un message à une fonction Lambda.
```
{
"sql": "SELECT * ",
"actions": [
{
// You obtained this functionArn when creating the Lambda function using the
// create-function command.
"lambda": {
"functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
}
},
{
// This topic can be used to observe messages exchanged between the device and
// AWS IoT Core for Amazon Sidewalk after the device is connected.
"republish": {
"roleArn": "arn:aws:iam::123456789012:role/service-role/SidewalkRepublishRole",
"topic": "project/sensor/observed"
}
}
],
}
```
# Connectez votre appareil Sidewalk et visualisez le format des métadonnées de liaison montante
Dans ce didacticiel, vous allez utiliser le client de test MQTT pour tester la connectivité et voir les messages échangés entre votre terminal et le AWS Cloud. Pour recevoir des messages, dans le client de test MQTT, abonnez-vous à la rubrique spécifiée lors de la création de la règle IoT pour votre destination. Vous pouvez également envoyer un message de liaison descendante depuis AWS IoT Core pour Amazon Sidewalk à votre appareil à l’aide de l’opération d’API `SendDataToWirelessDevice`. Vous pouvez vérifier que le message a été remis en activant la notification d’événement d’état de remise du message.
**Note**
Pour plus d’informations sur la connexion et la configuration de votre plate-forme matérielle, consultez [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) et [Configuration du kit de développement matériel (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) dans la documentation *Amazon Sidewalk*.
## Envoyer des messages de liaison descendante à votre terminal
Utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html) pour envoyer des messages de liaison descendante depuis AWS IoT Core pour Amazon Sidewalk à votre terminal Sidewalk. Voici un exemple de la marche à suivre. Les données de charge utile sont le binaire à envoyer, codé en base64.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```
Vous trouverez ci-dessous un exemple de résultat de l’exécution de cette commande, qui est un identifiant du message de liaison descendante envoyé à l’appareil.
```
{
MessageId: "6011dd36-0043d6eb-0072-0008"
}
```
**Note**
L’API `SendDataToWirelessDevice` peut renvoyer un ID de message, mais le message risque de ne pas être livré correctement. Pour vérifier l’état du message envoyé à l’appareil, vous pouvez activer les événements relatifs à l’état de livraison des messages pour vos comptes et appareils Sidewalk. Pour plus d’informations sur l’activation de cet événement, consultez [Notifications d’événements pour les ressources Sidewalk](iot-sidewalk-events.md). Pour plus d’informations sur ce type d’événement, consultez [Événements d’envoi de messages](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk-message-delivery-events.html).
## Afficher le format des messages en liaison montante depuis l’appareil
Une fois que vous avez connecté votre appareil, vous pouvez vous abonner à la rubrique (par exemple, *`project/sensor/observed`*) que vous avez spécifiée lors de la création de la règle de destination et observer les messages de liaison montante provenant de l’appareil.
Si vous avez indiqué un nom de rubrique lors de la création de votre destination, vous pouvez vous abonner à la rubrique pour surveiller les messages en liaison montante provenant de votre terminal. Accédez au [client de test MQTT](https://console.aws.amazon.com/iot/home#/test) sur la page **Test** de la console AWS IoT, entrez le nom du sujet (par exemple, *`project/sensor/observed`*), puis choisissez **S’abonner**.
L’exemple suivant illustre le format des messages de liaison montante envoyés par les appareils Sidewalk à AWS IoT. `WirelessMetadata` contient des métadonnées relatives à la demande de message.
```
{
"PayloadData":"ZjRlNjY1ZWNlNw==",
"WirelessDeviceId":"wireless_device_id",
"WirelessMetadata":{
"Sidewalk":{
"CmdExStatus":"Cmd",
"SidewalkId":"device_id",
"Seq":0,
"MessageType":"messageType"
}
}
}
```
Le tableau suivant présente une définition des différents paramètres des métadonnées de liaison montante. `device-id` est l’ID de l’appareil sans fil, tel que `ABCDEF1234` et le `messageType` est le type de message de liaison montante reçu de l’appareil.
**Paramètres des métadonnées de la liaison montante Sidewalk**
| Paramètre | Description | Type | Obligatoire |
| --- | --- | --- | --- |
| PayloadData | Charge utile des messages envoyés depuis l’appareil sans fil. | Chaîne | Oui |
| WirelessDeviceID | L’identifiant de l’appareil sans fil qui envoie les données | Chaîne | Oui |
| Sidewalk.CmdExStatus | État d’exécution de la commande. Les messages de type réponse doivent inclure le code d’état, `COMMAND_EXEC_STATUS_SUCCESS`. Toutefois, les notifications peuvent ne pas inclure le code d’état. | Énumération | Non |
| Sidewalk.NackExStatus | État de réponse, qui peut être `RADIO_TX_ERROR` ou`MEMORY_ERROR`. | Tableau de chaînes | Non |