# Introducción a AWS IoT Wireless Si desea empezar a utilizar AWS IoT Wireless, regístrese para obtener una Cuenta de AWS y siga los pasos necesarios para crear un usuario de IAM. Cuando se haya registrado, podrá usar la Consola de administración de AWS, la API de AWS IoT Wireless o la AWS CLI para incorporar sus puertas de enlace y dispositivos Sidewalk y LoRaWAN. Cuando incorpore los dispositivos, piense en cómo va a describir y etiquetar sus recursos, ya que eso le ayudará a identificarlos con facilidad. En los siguientes temas, descubrirá cómo puede empezar a usar AWS IoT Wireless. **Topics** + [Configuración de AWS IoT Wireless](setting-up-iotwireless.md) + [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md) # Configuración de AWS IoT Wireless Al registrarse en AWS, su Cuenta de AWS se registra automáticamente en todos los servicios de AWS, incluido AWS IoT Wireless. Solo se le cobrará por los servicios que utilice. Para configurar AWS IoT Wireless, siga los pasos descritos en la siguiente sección: **Topics** + [Configuración de su Cuenta de AWS](#iotwireless-setup-account) + [Instalación de Python y la AWS CLI](#wireless-onboard-prereq) ## Configuración de su Cuenta de AWS Antes de usar AWS IoT Core para LoRaWAN o AWS IoT Core para Amazon Sidewalk por primera vez, haga lo siguiente para configurar su Cuenta de AWS. **Topics** + [Inscribirse en una cuenta de AWS](#aws-sign-up-iotwireless) + [Creación un usuario de IAM](#create-iam-user-iotwireless) + [Inicie sesión como usuario de IAM.](#sign-in-iam-user-iotwireless) ### Inscribirse en una cuenta de AWS Si no dispone de una Cuenta de AWS, siga estos pasos para crear una. **Creación de una Cuenta de AWS** 1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Siga las instrucciones que se le indiquen. Parte del procedimiento de registro consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono. Al registrarse en una Cuenta de AWS, se crea un *Usuario raíz de la cuenta de AWS*. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, [asigne acceso administrativo a un usuario administrativo](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) y utilice únicamente el usuario raíz para realizar [tareas que requieran acceso de usuario raíz](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html). ### Creación un usuario de IAM Para crear un usuario administrador, elija una de las siguientes opciones. **** | Elegir una forma de administrar el administrador | Para | Haga esto | También puede | | --- | --- | --- | --- | | En IAM Identity Center (recomendado) | Usar credenciales a corto plazo para acceder a AWS.Esto se ajusta a las prácticas recomendadas de seguridad. Para obtener información sobre las prácticas recomendadas, consulte [Prácticas recomendadas de seguridad en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) en la *Guía del usuario de IAM*. | Siga las instrucciones en [Introducción](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) en la Guía del usuario de AWS IAM Identity Center. | Configurar el acceso programático mediante [Configuración de la AWS CLI para usar AWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) en la Guía del usuario de AWS Command Line Interface. | | En IAM (no recomendado) | Usar credenciales a largo plazo para acceder a AWS. | Siga las instrucciones en [Creación del primer grupo de usuarios y usuario de administrador de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) en la Guía del usuario de IAM. | Configurar el acceso programático mediante [Administración de las claves de acceso de los usuarios de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) en la Guía del usuario de IAM. | ### Inicie sesión como usuario de IAM. Después de crear un usuario de IAM, puede iniciar sesión en AWS con su nombre de usuario y contraseña de IAM. Antes de iniciar sesión como usuario de IAM, puede verificar el vínculo de inicio de sesión para los usuarios de IAM en la consola de IAM. En el panel de IAM, en el enlace de inicio de sesión de usuarios de IAM, encontrará el enlace de inicio de sesión para su Cuenta de AWS. La URL del enlace de inicio de sesión contiene el ID de su Cuenta de AWS sin guiones (-). Si no desea que la URL del enlace de inicio de sesión contenga el ID de su Cuenta de AWS, puede crear un alias de cuenta. Para obtener más información, consulte [Creación, eliminación y descripción de un alias de Cuenta de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias) en la *Guía del usuario de IAM*. **Para iniciar sesión como usuario de IAM** 1. Cierre la sesión de la Consola de administración de AWS. 1. Introduzca su enlace de inicio de sesión, que incluye su ID de Cuenta de AWS (sin guiones) o su alias de Cuenta de AWS. ``` https://aws_account_id_or_alias.signin.aws.amazon.com/console ``` 1. Escriba el nombre y la contraseña del usuario de IAM que acaba de crear. Cuando haya iniciado sesión, la barra de navegación mostrará *"nombre\$1de\$1usuario @ id\$1de\$1cuenta\$1aws"*. ## Instalación de Python y la AWS CLI Antes de conectar el dispositivo final LoRaWAN o Sidewalk, debe configurar la AWS CLI y la instalación de Python. **importante** Para llevar a cabo todo el flujo de trabajo de incorporación para aprovisionar y registrar el dispositivo final de Sidewalk, también debe configurar la puerta de enlace y el HDK de Sidewalk. Para obtener instrucciones, consulte [Configuración del kit de desarrollo de hardware (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) y [Configuración de una puerta de enlace de Sidewalk](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) en la *documentación de Amazon Sidewalk*. **Topics** + [Instalación de Python y Python3-pip](#wireless-prereq-python) + [Configuración de la AWS CLI](#wireless-prereq-cli) ### Instalación de Python y Python3-pip Para utilizar la AWS CLI y boto3 como se describe en la sección siguiente, debe utilizar la versión 3.6 o posterior de Python. Si desea incorporar los dispositivos finales mediante la consola de AWS IoT, puede omitir esta sección y seguir configurando la Cuenta de AWS. Para comprobar si ya ha instalado Python y Python3-pip, ejecute los siguientes comandos. Si al ejecutar estos comandos se devuelve la versión, significa que Python y Python3-pip se han instalado correctamente. ``` python3 -V pip3 --version ``` Si este comando devuelve un error, podría deberse a que Python no está instalado o a que el sistema operativo llama al ejecutable de Python v3.x como Python3. En ese caso, sustituya todas las instancias de `python` por `python3` cuando ejecute los comandos. Si sigue produciendo un error, descargue y ejecute el [instalador de Python](https://www.python.org/downloads/) o instale Python en función del sistema operativo, tal y como se describe a continuación. ------ #### [ Windows ] En su equipo Windows, descargue Python del [sitio web de Python](https://www.python.org/downloads/windows/) y, a continuación, ejecute el instalador para instalar Python en el equipo. ------ #### [ Linux ] En su equipo Ubuntu, ejecute el siguiente comando `sudo` para instalar Python. ``` sudo apt install python3 sudo apt install python3-pip ``` ------ #### [ macOS ] En su equipo Mac, use Homebrew para instalar Python. Homebrew también instala pip, que luego apunta a la versión de Python3 instalada. ``` $ brew install python ``` ------ ### Configuración de la AWS CLI Los siguientes pasos muestran cómo configurar la AWS CLI y boto3 (SDK de AWS para Python). Antes de seguir estos pasos, deberá registrarse para obtener una Cuenta de AWS y crear un usuario administrativo. Para obtener instrucciones, consulte [Configuración de AWS IoT Wireless](#setting-up-iotwireless). 1. **Instalación y configuración de la AWS CLI** Puede usar la AWS CLI para incorporar mediante programación los dispositivos finales Sidewalk a AWS IoT Core para Amazon Sidewalk. Si desea incorporar los dispositivos finales mediante la consola de AWS IoT, puede omitir esta sección. Abra la [consola de AWS IoT Core](https://console.aws.amazon.com/iot/home#/) y vaya a la siguiente sección a fin de conectar sus dispositivos a AWS IoT Core para Amazon Sidewalk. Para obtener instrucciones sobre cómo configurar la AWS CLI, consulte [Instalación y configuración de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. **Instalación de boto3 (SDK de AWS para Python)** Los comandos siguientes muestran cómo instalar boto3 (SDK de AWS para Python) y la AWS CLI. También instalará botocore, que es necesario para ejecutar boto3. Para obtener instrucciones detalladas, consulte [Instalación de Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation) en la *Guía de documentación de Boto3*. **nota** La versión `1.26.6` de `awscli` requiere la versión de PyYAML 3.10 o posterior, pero solo hasta la 5.5. ``` python3 -m pip install botocore-version-py3-none-any.whl python3 -m pip install boto3-version-py3-none-any.whl ``` 1. **Configuración de las credenciales y la región predeterminada** Configure las credenciales y la región predeterminada en los archivos `~/.aws/credentials` y `~/.aws/config`. La biblioteca de boto3 usa estas credenciales para identificar la Cuenta de AWS y autorizar las llamadas a la API. Para obtener las instrucciones de configuración, consulte: + [Configuración](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) en la *Guía de documentación de Boto3* + [Ajustes del archivo de configuración y credenciales](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) en la *Guía de documentación de la AWS CLI* # Descripción de los recursos de AWS IoT Wireless Antes de empezar a incorporar los dispositivos LoRaWAN o Sidewalk, piense en la convención de nomenclatura que utilizará en sus dispositivos, puertas de enlace y destinos. AWS IoT Wireless proporciona varias opciones para ayudarle a identificar los recursos que crea. Si bien los recursos de AWS IoT Wireless reciben un identificador único cuando se crean, este identificador no es descriptivo ni se puede cambiar una vez creado el recurso. A fin de simplificar la selección, identificación y administración de sus recursos, puede asignar un nombre, agregar una descripción y asociar etiquetas y valores de etiqueta a la mayoría de los recursos de AWS IoT Wireless. + **[Nombres y descripción de los recursos](#wireless-describe-resource-names)** En el caso de las puertas de enlace, los dispositivos y los perfiles, el nombre del recurso es un campo opcional que puede cambiar tras crear el recurso. El nombre aparece en las listas que se muestran en las páginas del centro de recursos. Para los destinos, proporciona un nombre que sea único en su cuenta de AWS y Región de AWS. Después de crear el recurso de destino, no se puede cambiar el nombre de destino. Si bien un nombre puede tener hasta 256 caracteres, el espacio de visualización en el centro de recursos es limitado. Asegúrese de que la parte distintiva del nombre aparezca entre los primeros 20 a 30 caracteres, si es posible. + **[Etiquetas de recursos](#wireless-describe-resource-tags)** Las etiquetas son pares clave-valor de metadatos que se pueden asociar a los recursos de AWS. Puede elegir las claves de etiqueta y sus valores correspondientes. Las puertas de enlace, los destinos y los perfiles pueden tener hasta 50 etiquetas adjuntas. Los dispositivos no admiten etiquetas. ## Nombres y descripción de los recursos **Compatibilidad con los recursos de AWS IoT Wireless** | Recurso | Compatibilidad con el campo de nombre | | --- | --- | | Destino | El nombre es un ID único de recurso y no se puede cambiar. | | Dispositivo inalámbrico | El nombre es un descriptor opcional del recurso y se puede cambiar. | | Puerta de enlace LoRaWAN | El nombre es un descriptor opcional del recurso y se puede cambiar. | | Perfil | El nombre es un descriptor opcional del recurso y se puede cambiar. | El campo de nombre aparece en las listas de recursos de los centros de recursos; sin embargo, el espacio es limitado y, por lo tanto, es posible que solo estén visibles los primeros 15 a 30 caracteres del nombre. Al seleccionar los nombres de los recursos, tenga en cuenta cómo quiere que identifiquen los recursos y cómo se mostrarán en la consola. **Descripción** Los recursos de destino, dispositivo y puerta de enlace también admiten un campo de descripción, que puede aceptar hasta 2048 caracteres. El campo de descripción solo aparece en la página de detalles del recurso individual. Si bien el campo de descripción puede contener mucha información, ya que solo aparece en la página de detalles del recurso, no es práctico escanearlo en el contexto de varios recursos. ## Etiquetas de recursos **Compatibilidad de los recursos de AWS IoT Wireless con las etiquetas de AWS** | Recurso | Compatibilidad con etiquetas de AWS | | --- | --- | | Destino | Puede agregar hasta 50 etiquetas de AWS a cada recurso. | | Dispositivo inalámbrico | Este recurso no admite etiquetas de AWS. | | Puerta de enlace LoRaWAN | Puede agregar hasta 50 etiquetas de AWS a cada recurso. | | Perfil | Puede agregar hasta 50 etiquetas de AWS a cada recurso. | Las etiquetas son palabras o frases que actúan como metadatos que puede utilizar para identificar y organizar sus recursos de AWS. Puede pensar en la clave de etiqueta como una categoría de información y en el valor de la etiqueta como un valor específico de esa categoría. Por ejemplo, puede tener un valor de etiqueta de *color* y, a continuación, asignar a algunos recursos un valor de *azul* para esa etiqueta y a otros un valor de *rojo*. Con eso, puede usar el [Editor de etiquetas](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) de la consola de AWS para buscar los recursos con un valor de etiqueta de *color* *azul*. Para obtener más información sobre el uso de etiquetas en AWS IoT Wireless, consulte [Etiquetar los recursos de AWS IoT Wireless](tagging-iotwireless.md). Para obtener más información acerca de las estrategias de etiquetado, consulte [Editor de etiquetas](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).