Obtención de los archivos JSON del dispositivo para el aprovisionamiento - AWS IoT Wireless
Obtención del archivo JSON (consola)Obtención del archivo JSON (CLI)Siguientes pasos

Obtención de los archivos JSON del dispositivo para el aprovisionamiento

Cuando haya añadido el dispositivo Sidewalk a AWS IoT Core para Amazon Sidewalk, descargue el archivo JSON que contiene la información necesaria para aprovisionar el dispositivo final. Puede recuperar esta información mediante la consola de AWS IoT o la AWS CLI. Para obtener más información sobre cómo aprovisionar el dispositivo, consulte Aprovisionamiento y registro de un dispositivo final en la documentación de Amazon Sidewalk.

Obtención del archivo JSON (consola)

Para obtener el archivo JSON para aprovisionar el dispositivo de Sidewalk:

  1. Vaya al Centro de dispositivos de Sidewalk.

  2. Seleccione el dispositivo que ha agregado a AWS IoT Core para Amazon Sidewalk a fin de ver los detalles.

  3. Para obtener el archivo JSON, seleccione Descargar el archivo JSON del dispositivo en la página de detalles del dispositivo que ha agregado.

    Se descargará un archivo certificate.json que contiene la información necesaria para aprovisionar el dispositivo final. A continuación se muestra un archivo JSON de ejemplo. Contiene los certificados de dispositivo, las claves privadas, el número de serie del fabricante de Sidewalk (SMSN) y el 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"
}

En la página de detalles del dispositivo de Sidewalk, también verá información sobre:

  • El ID del dispositivo, su nombre de recurso de Amazon (ARN) y detalles sobre cualquier objeto de AWS IoT al que esté asociado el dispositivo.

  • El perfil del dispositivo y los detalles del destino.

  • La hora a la que se recibió el último mensaje de enlace ascendente del dispositivo.

  • El estado que indica si el dispositivo se ha aprovisionado o registrado.

Obtención del archivo JSON (CLI)

A fin de obtener los archivos JSON para aprovisionar el dispositivo final Sidewalk mediante la API de AWS IoT Core para Amazon Sidewalk o la AWS CLI, guarde temporalmente la respuesta de la API al recuperar información sobre el perfil de dispositivo y el dispositivo inalámbrico como archivos JSON, como wireless_device.json y device_profile.json. Los usará para aprovisionar el dispositivo de Sidewalk.

A continuación, mostramos cómo recuperar los archivos JSON.

Paso 1: Obtención de la información del perfil de dispositivo como un archivo JSON

Use la operación API GetDeviceProfile o el comando get-device-profile de la CLI para obtener información sobre el perfil del dispositivo que ha añadido a su cuenta de AWS IoT Core para Amazon Sidewalk. Para recuperar información sobre el perfil del dispositivo, especifique el ID del perfil.

A continuación, la API devolverá información sobre el perfil del dispositivo que coincida con el identificador especificado y el ID de dispositivo. Guarde esta información de respuesta en un archivo y asígnele un nombre como device_profile.json.

El siguiente es un ejemplo del comando de la CLI:

aws iotwireless get-device-profile \ 
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json

Al ejecutar este comando, se devuelven los parámetros del perfil del dispositivo, la clave pública del servidor de aplicaciones y el DeviceTypeID. A continuación, se muestra un archivo JSON que contiene un ejemplo de información de respuesta de la API. Para obtener más información sobre los parámetros en la respuesta de la API, consulte GetDeviceProfile.

Respuesta de la API GetDeviceProfile (contenido 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
    }
}

Paso 2: Obtención de la información del dispositivo de Sidewalk como un archivo JSON

Use la operación API GetWirelessDevice o el comando get-wireless-device de la CLI para obtener información sobre el dispositivo Sidewalk que ha añadido a su cuenta de AWS IoT Core para Amazon Sidewalk. Para obtener información sobre el dispositivo final, proporcione el identificador del dispositivo inalámbrico que obtuvo al agregar el dispositivo.

A continuación, la API devolverá información sobre el dispositivo que coincida con el identificador especificado y el ID de dispositivo. Guarde esta información de respuesta en un archivo JSON. Póngale un nombre significativo, por ejemplo wireless_device.json.

El siguiente ejemplo muestra la ejecución del comando mediante la CLI:

aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \ 
    --identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json

Al ejecutar este comando, se obtienen los detalles del dispositivo, los certificados del dispositivo, las claves privadas y el número de serie de fabricación de Sidewalk (SMSN). A continuación se muestra un ejemplo del resultado asociado a la ejecución de este comando. Para obtener más información sobre los parámetros en la respuesta de la API, consulte GetWirelessDevice.

Respuesta de la API GetWirelessDevice (contenido 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"
    },
    
    ...
    
}

Siguientes pasos

Guarde temporalmente los archivos JSON wireless_device.json y device_profile.json, ya que los utilizará en el siguiente paso para aprovisionar y registrar el dispositivo final para conectarlo a la plataforma de hardware. Para obtener más información, consulte Aprovisionamiento y registro de un dispositivo final en la documentación de Amazon Sidewalk.