# Ajout de destinations à AWS IoT Core for LoRaWAN AWS IoT Core pour les destinations LoRaWAN, décrivez la règle AWS IoT qui traite les données d’un appareil à des fins d’utilisation par les services AWS. Étant donné que la plupart des appareils LoRaWAN n’envoient pas de données vers AWS IoT Core pour LoRaWAN dans un format utilisable par les services AWS, une règle AWS IoT doit d’abord les traiter. La règle AWS IoT contient l’instruction SQL qui interprète les données de l’appareil et les actions de règle de rubrique qui envoient le résultat de l’instruction SQL aux services qui l’utiliseront. Si vous ajoutez votre destination pour la première fois, nous vous recommandons d’utiliser la console. ## Ajout d’une destination à l’aide de la console Si vous ajoutez un appareil sans fil à l’aide de la console comme décrit dans[Ajoutez les spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de la console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), après avoir déjà ajouté les spécifications et les profils de l’appareil sans fil à AWS IoT Core for LoRaWAN comme décrit précédemment, vous pouvez continuer et ajouter une destination. Vous pouvez également ajouter une destination AWS IoT Core for LoRaWAN depuis la page [Destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations) de la console AWS IoT. Pour traiter les données d’un appareil, spécifiez les champs suivants lors de la création d’une destination AWS IoT Core pour LoRaWAN, 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’`topic`expression topic contenue dans la règle. Pour plus d’informations sur les règles du AWS IoT, consultez [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html](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 en savoir plus, consultez [https://docs.aws.amazon.com/iot/latest/developerguide/topics.html](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html). Pour plus d’informations sur les règles AWS IoT, veuillez consulter [Créez des règles pour traiter les messages des appareils LoRaWAN](lorawan-destination-rules.md). + **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,**IoTWirelessDestinationRole**), 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. Pour plus d’informations sur les rôles IAM, veuillez consulter [Utilisation de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html). ## Ajout d’une destination à l’aide de l’API Si vous souhaitez plutôt ajouter une destination à l’aide de la CLI, vous devez déjà avoir créé la règle et le rôle IAM pour votre destination. Pour plus d’informations sur les détails dont une destination a besoin dans le rôle, veuillez consulter [Création d’un rôle IAM pour vos destinations](#lorawan-create-destinations-roles). La liste suivante contient les actions d’API qui exécutent les tâches associées à l’ajout, à la mise à jour ou à la suppression d’une destination. **Actions d’API AWS IoT Wireless pour les destinations** + [Créer une destination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) + [GetDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDestination.html) + [ListDestinations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDestinations.html) + [ UpdateDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDestination.html) + [DeleteDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDestination.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser le AWS CLI pour ajouter une destination** Vous pouvez utiliser le AWS CLI pour ajouter une destination à l’aide de la commande [create-destination.](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-destination.html) L’exemple suivant montre comment créer une destination en saisissant le nom d’une règle `RuleName` à l’aide de la valeur du paramètre `expression-type`. Si vous souhaitez spécifier un nom de rubrique pour la publication ou l’abonnement à l’agent de messages, remplacez la valeur du paramètre `expression-type` par `MqttTopic` d. ``` aws iotwireless create-destination \ --name IoTWirelessDestination \ --expression-type RuleName \ --expression IoTWirelessRule \ --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole ``` L’exécution de cette commande crée une destination avec le nom de destination, le nom de règle et le nom de rôle spécifiés. Pour plus d’informations sur les noms de règles et de rôles pour les destinations, veuillez consulter [Créez des règles pour traiter les messages des appareils LoRaWAN](lorawan-destination-rules.md) et [Création d’un rôle IAM pour vos destinations](#lorawan-create-destinations-roles). Pour plus d’informations sur les CLI que vous pouvez utiliser, veuillez consulter la [AWS CLIréférence](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html). ## Création d’un rôle IAM pour vos destinations Les destinations AWS IoT Core for LoRaWAN nécessitent des rôles IAM qui donnent à AWS IoT Core for LoRaWAN les autorisations nécessaires pour envoyer des données à la règle AWS IoT. Si un tel rôle n’est pas déjà défini, vous devez le définir pour qu’il apparaisse dans la liste des rôles. Lorsque vous utilisez la console pour ajouter une destination, AWS IoT Core for LoRaWAN crée automatiquement un rôle IAM pour vous, comme décrit précédemment dans cette rubrique. Lorsque vous ajoutez une destination à l’aide de l’API ou de la CLI, vous devez créer le rôle IAM pour votre destination. **Création d’une politique IAM pour votre rôle de destination AWS IoT Core for LoRaWAN** 1. Ouvrez la page [Centre de politiques de la console IAM](https://console.aws.amazon.com/iam/home#/policies). 1. Sélectionnez **Créer une politique**, puis l’onglet **JSON**. 1. Dans l’éditeur, supprimez tout contenu de l’éditeur et collez ce document de politique. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:DescribeEndpoint", "iot:Publish" ], "Resource": "*" } ] } ``` 1. Choisissez **Réviser la politique**, puis dans l’onglet **Nom**, entrez un nom pour la politique. Vous avez besoin de ce nom pour l’utiliser dans la procédure suivante. Vous pouvez également décrire cette politique dans **Description**, si vous le souhaitez. 1. Sélectionnez **Créer une politique**. **Création d’un rôle IAM pour votre rôle de destination AWS IoT Core for LoRaWAN** 1. Ouvrez la page [ Centre de rôles de la console IAM](https://console.aws.amazon.com/iam/home#/roles) et choisissez **Créer un rôle**. 1. Dans l’onglet **Sélectionner le type d’entité d’approbation**, choisissez **Autre Compte AWS**. 1. Dans **ID de compte**, entrez votre Compte AWS identifiant, puis choisissez **Suivant : Autorisations**. 1. Dans le champ de recherche, entrez le nom de la politique IAM que vous avez créée dans la procédure précédente. 1. Dans les résultats de la recherche, vérifiez la politique IAM que vous avez créée dans la procédure précédente. 1. Sélectionnez **Suivant : Balises**, puis **Suivant : Vérification)**. 1. Dans l’onglet **Nom du rôle**, saisissez un nom pour votre rôle, puis sélectionnez **Créer un rôle**. 1. Dans le message de confirmation, sélectionnez le nom du rôle que vous avez créé pour modifier le nouveau rôle. 1. Dans **Récapitulatif**, choisissez l’onglet **Relations d’approbation**, puis choisissez **Modifier la relation d’approbation**. 1. Dans l’onglet **Document de politique**, modifiez la `Principal` propriété pour qu’elle ressemble à cet exemple. ``` "Principal": { "Service": "iotwireless.amazonaws.com" }, ``` Après avoir modifié la `Principal` propriété, le document de politique complet doit ressembler à cet exemple. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotwireless.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Pour enregistrer vos modifications et quittez, sélectionnez **Mettre à jour la politique d’approbation**. Une fois ce rôle défini, vous pouvez le retrouver dans la liste des rôles lorsque vous configurez vos destinations AWS IoT Core for LoRaWAN.