Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Trabajo con AWS IoT en el IDE de AWS Cloud9
Con AWS IoT en el IDE de AWS Cloud9, puede interactuar con el servicio AWS IoT y, al mismo tiempo, minimizar las interrupciones en su flujo de trabajo en AWS Cloud9. En esta guía se explica cómo puede empezar a utilizar las funciones del servicio AWS IoT que están disponibles en el IDE de AWS Cloud9. Para obtener más información, consulte ¿Qué es AWS IoT? en la Guía para desarrolladores de AWS IoT.
Requisitos previos de AWS IoT
Para empezar a usar AWS IoT en el IDE de AWS Cloud9, asegúrese de que su Cuenta de AWS y su configuración de AWS Cloud9 cumplen todos los requisitos. Para obtener información sobre los requisitos de Cuenta de AWS y los permisos de usuario de AWS específicos para el servicio AWS IoT, consulte Introducción a AWS IoT Core en la Guía para desarrolladores de AWS IoT.
Objetos de AWS IoT
AWS IoT conecta dispositivos con Servicios de AWS y recursos de AWS. Puede conectar sus dispositivos a AWS IoT mediante objetos. Un objeto es una representación de un dispositivo concreto o de una entidad lógica. Puede ser un dispositivo físico o un sensor (por ejemplo, una bombilla o un interruptor en la pared). Para obtener más información sobre los objetos de AWS IoT, consulte Administración de dispositivos con AWS IoT en la Guía para desarrolladores de AWS IoT.
Administración de objetos de AWS IoT
El IDE de AWS Cloud9 tiene varias funciones que aumentan la eficiencia de la administración de sus objetos. Para administrar sus objetos de AWS IoT, siga estos pasos:
Crear un objeto
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Abra el menú contextual (haga clic con el botón derecho) correspondiente al objeto y seleccione Create Thing (Crear objeto).
Introduzca un nombre para el objeto en el campo Thing Name (Nombre de objeto) y siga las instrucciones.
Cuando complete este paso, aparecerá un icono de objeto seguido del nombre que ha especificado que sea visible en la sección Thing (Objeto).
Para asociar un certificado a un objeto
-
Desde el Explorador de AWS, expanda la sección del servicio IoT.
-
En la subsección Things (Objetos), busque el objeto al que va a adjuntar el certificado.
-
Abra el menú contextual (haga clic con el botón derecho) del objeto y elija Attach Certificate (Adjuntar certificado) para abrir un selector de entrada con una lista de certificados.
-
En la lista, elija el ID de certificado que corresponda al que desea adjuntar a su objeto.
-
Una vez completado este paso, su certificado estará accesible en el Explorador de AWS como un elemento del objeto al que lo haya adjuntado.
Para desasociar un certificado de un objeto
-
Desde el Explorador de AWS, expanda la sección del servicio IoT.
-
En la subsección Things (Objetos), localice el objeto del que desea desasociar un certificado.
-
Abra el menú contextual (haga clic con el botón derecho) correspondiente al objeto y elija Attach Certificate (Asociar certificado).
-
Una vez completado este paso, el certificado desasociado ya no aparecerá como elemento del objeto en el Explorador de AWS. Sin embargo, aún se podrá acceder a él desde la subsección Certificates (Certificados).
Para eliminar un objeto
-
Desde el Explorador de AWS, expanda la sección del servicio IoT.
-
En la subsección Things (Objetos), localice el objeto que desea eliminar.
-
Abra el menú contextual (haga clic con el botón derecho) correspondiente al objeto y elija Delete Thing (Eliminar objeto).
-
Una vez completado este paso, el objeto eliminado ya no estará disponible en la subsección Things (Objetos).
nota
Solo puede eliminar un objeto que no tenga un certificado asociado.
AWS IoTCertificados de
Los certificados son una forma habitual de crear una conexión segura entre sus servicios de AWS IoT y sus dispositivos. Los certificados X.509 son certificados digitales que utilizan el estándar de infraestructura de clave pública X.509 para asociar una clave pública a una identidad contenida en un certificado. Para obtener más información sobre los certificados de AWS IoT, consulte Authentication (IoT) (Autenticación [IoT]) en la Guía para desarrolladores de AWS IoT.
Administración de certificados
El kit de herramientas de AWS le ofrece diversas formas de administrar sus certificados de AWS IoT directamente desde el Explorador de AWS. Se describen en los pasos siguientes:
Para crear un certificado de AWS IoT
Se utiliza un certificado X.509 para conectarse con su instancia de AWS IoT.
Desde el Explorador de AWS, expanda la sección del servicio IoT y abra (haga clic con el botón derecho) Certificates (Certificados).
-
Para abrir un cuadro de diálogo, seleccione Create Certificate (Crear certificado) en el menú contextual.
-
Para guardar su par de claves RSA y certificado X.509, seleccione un directorio en su sistema de archivos local.
nota
Los nombres de archivo predeterminados contienen el ID de certificado como prefijo.
Solo se almacena el certificado X.509 con su Cuenta de AWS, a través del servicio AWS IoT.
Su par de claves RSA solo puede emitirse una vez. Guárdelo en una ubicación segura de su sistema de archivos cuando se le solicite.
Si el certificado o el par de claves no pueden guardarse en su sistema de archivos, el kit de herramientas de AWS elimina el certificado de su Cuenta de AWS.
Para modificar el estado de un certificado
El estado de un certificado individual se muestra junto al ID de certificado en el Explorador de AWS y puede establecerse en active (activo), inactive (inactivo) o revoked (revocado).
nota
Un certificado debe tener el estado active (activo) para poder usarlo para conectar su dispositivo al servicio AWS IoT.
Un certificado inactivo puede activarse, tanto si se ha desactivado previamente como si está inactivo de forma predeterminada.
Un certificado que se ha revocado no se puede reactivar.
Desde el Explorador de AWS, expanda la sección del servicio IoT.
En la subsección Certificates (Certificados), busque el certificado que desee modificar.
Abra el menú contextual (haga clic con el botón derecho) del certificado que muestra las opciones de cambio de estado disponibles para ese certificado.
Si un certificado tiene el estado inactive (inactivo), elija activate (activar) para cambiar el estado a active (activo).
Si un certificado tiene el estado active (activo), elija deactivate (desactivar) para cambiar el estado a inactive (inactivo).
Si un certificado tiene el estado active (activo) o inactive (inactivo), elija revoke (revocar) para cambiar el estado a revoked (revocado).
nota
Puede acceder a todas estas acciones de cambio de estado seleccionando un certificado asociado a un objeto en la subsección Things (Objetos).
Para asociar una política de IoT a un certificado
Desde el Explorador de AWS, expanda la sección del servicio IoT.
En la subsección Certificates (Certificados), busque el certificado que desee modificar.
Abra el menú contextual (haga clic con el botón derecho) del certificado y elija Attach Policy (Asociar política) para abrir un selector de entrada con una lista de políticas disponibles.
Elija la política que desea asociar al certificado.
Una vez completado este paso, la política que haya seleccionado se agregará al certificado como un elemento del submenú.
Para desasociar una política de IoT de un certificado
Desde el Explorador de AWS, expanda la sección del servicio IoT.
En la subsección Certificates (Certificados), busque el certificado que desee modificar.
Expanda el certificado y busque la política que desee desasociar.
Abra el menú contextual (haga clic con el botón derecho) y elija Detach (Desasociar) en dicho menú.
Una vez completado este paso, ya no podrá acceder a la política desde su certificado, sino desde la subsección Policy (Política).
Para eliminar un certificado
Desde el Explorador de AWS, expanda el encabezado del servicio IoT.
En la subsección Certificates (Certificados), busque el certificado que desee eliminar.
Abra el menú contextual (haga clic con el botón derecho del ratón) del certificado y elija Delete Certificate (Eliminar certificado).
nota
No puede eliminar un certificado si está asociado a un objeto o tiene un estado activo. Puede eliminar un certificado que tenga políticas asociadas.
Políticas de AWS IoT
Las políticas básicas de AWS IoT se definen mediante documentos JSON. Cada uno contiene al menos una declaración de política. Las políticas definen cómo AWS IoT, AWS y su dispositivo pueden interactuar entre sí. Para obtener más información sobre cómo crear un documento de políticas, consulte IoT Polices (Políticas de IoT) en la Guía para desarrolladores de AWS IoT.
nota
Las políticas con nombre tienen una versión para que pueda revertirlas. En el Explorador de AWS, sus políticas de IoT aparecen en la subsección Policies (Políticas) del servicio AWS IoT. Puede ver las versiones de una política si la expande. La versión predeterminada se indica con un asterisco (*).
Administración de políticas
El IDE de AWS Cloud9 ofrece varias formas de administrar sus políticas del servicio AWS IoT. Estas son formas de administrar o modificar sus políticas directamente desde el Explorador de AWS en VS Code:
Para crear una política de AWS IoT
nota
Puede crear una nueva política desde el Explorador de AWS. Sin embargo, el documento JSON que define la política ya debe estar en el sistema de archivos.
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Abra el menú contextual (haga clic con el botón derecho) de la subsección Policies (Políticas) y, para abrir el campo de entrada Policy Name (Nombre de política), elija Create Policy from Document (Crear política a partir de un documento).
Introduzca un nombre y siga las instrucciones para abrir un cuadro de diálogo que le pedirá que seleccione un documento JSON de su sistema de archivos.
Elija el archivo JSON que contiene las definiciones de su política. La política estará disponible en el Explorador de AWS una vez completada esta operación.
Para cargar una nueva versión de política de AWS IoT
Puede crear una nueva versión de una política si carga un documento JSON en la política.
nota
El nuevo documento JSON debe estar en el sistema de archivos para crear una nueva versión mediante el Explorador de AWS.
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Expanda la subsección Policies (Políticas) para ver sus políticas de AWS IoT.
Abra el menú contextual (haga clic con el botón derecho) de la política que desea actualizar y elija Create new version from Document (Crear versión nueva a partir de un documento).
Cuando se abra el cuadro de diálogo, elija el archivo JSON que contiene las actualizaciones de las definiciones de la política.
Se puede acceder a la nueva versión desde su política en el Explorador de AWS.
Para editar una versión de política de AWS IoT
Puede abrir y editar un documento de política mediante AWS Cloud9. Cuando termine de editar el documento, guárdelo en el sistema de archivos. A continuación, cárguelo en su servicio AWS IoT desde el Explorador de AWS.
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Expanda la subsección Policies (Políticas) y localice la política que desea actualizar.
Para abrir el campo Policy Name (Nombre de política), elija Create Policy from Document (Crear política a partir de un documento).
Expanda la política que desea actualizar y, a continuación, abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea editar.
Para abrir la versión de la política en AWS Cloud9, elija View (Ver) en el menú contextual para abrir la versión de la política.
Cuando se abra el documento de política, edite y guarde los cambios.
nota
En este momento, los cambios realizados en la política solo se guardan en el sistema de archivos local. Para actualizar la versión y realizar un seguimiento con el Explorador de AWS, repita los pasos que se indican en Upload a new policy version.
Para seleccionar una nueva versión de política (predeterminada)
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Expanda la subsección Policies (Políticas) y localice la política que desea actualizar.
Expanda la política que desea actualizar y, a continuación, abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea establecer y elija Set as Default (Establecer como predeterminada).
Cuando haya terminado, la nueva versión predeterminada que ha seleccionado tendrá una estrella junto a ella.
Para eliminar políticas de
nota
Para poder eliminar una política o una versión de ella, asegúrese de que se cumplen las siguientes condiciones:
No puede eliminar una política si está asociada a un certificado.
No puede eliminar una política si tiene versiones distintas de las predeterminadas.
Solo puede eliminar la versión predeterminada de una política si se selecciona una nueva versión predeterminada o si se elimina la política completa.
Para poder eliminar una política completa, debe eliminar todas las versiones no predeterminadas de ella.
Desde el Explorador de AWS, expanda la sección del servicio IoT.
Expanda la subsección Policies (Políticas) y localice la política que desea actualizar.
Expanda la política que desea actualizar y abra el menú contextual (haga clic con el botón derecho) de la versión de la política que desea eliminar y elija Delete (Eliminar).
Cuando se elimina una versión, deja de estar visible desde el Explorador de AWS.
Si solo queda la versión predeterminada de una política, abra el menú contextual (haga clic con el botón derecho) de la política principal y elija Delete (Eliminar).
