

# Obtención de los archivos JSON del dispositivo para el aprovisionamiento
<a name="sidewalk-json-get"></a>

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](https://docs.sidewalk.amazon/provisioning/) en la *documentación de Amazon Sidewalk*.

## Obtención del archivo JSON (consola)
<a name="iot-sidewalk-json-get-console"></a>

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

1. Vaya al [Centro de dispositivos de Sidewalk](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk).

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

1. 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 name="iot-sidewalk-json-get-api"></a>

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.

**Topics**
+ [Paso 1: Obtención de la información del perfil de dispositivo como un archivo JSON](#iot-sidewalk-profile-get)
+ [Paso 2: Obtención de la información del dispositivo de Sidewalk como un archivo JSON](#iot-sidewalk-get-device)

### Paso 1: Obtención de la información del perfil de dispositivo como un archivo JSON
<a name="iot-sidewalk-profile-get"></a>

Use la operación 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) o el comando [https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-device-profile.html) 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 [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).

**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
<a name="iot-sidewalk-get-device"></a>

Use la operación 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) o el comando [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device.html) 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 [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).

**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
<a name="iot-sidewalk-json-next"></a>

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](https://docs.sidewalk.amazon/provisioning/) en la *documentación de Amazon Sidewalk*.