Obtenir les fichiers JSON de l’appareil pour la mise en service - AWS IoT Wireless
Obtenir un fichier JSON (console)Obtenir un fichier JSON (CLI)Étapes suivantes

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 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.

  2. Choisissez l’appareil que vous avez ajouté à AWS IoT Core pour Amazon Sidewalk pour afficher ses détails.

  3. 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.

Étape 1 : obtenir les informations du profil de l’appareil sous forme de fichier JSON

Utilisez l’opération d’API GetDeviceProfile ou la commande d’interface de ligne de commande get-device-profile 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 GetDeviceProfile.

GetDeviceProfileRé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 GetWirelessDevice ou la commande d’interface de ligne de commande get-wireless-device 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 GetWirelessDevice.

GetWirelessDeviceRé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 dans la documentation Amazon Sidewalk.