View a markdown version of this page

Asociar un AWS IoT cosa a una conexión de cliente MQTT - AWS IoT Core
Casos de usoCómo asociar un objeto a una conexión

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.

Asociar un AWS IoT cosa a una conexión de cliente MQTT

Una asociación de cosas exclusiva es cuando se adjunta un X.509 certificado a una sola AWS IoT cosa. En este caso, el certificado no se puede usar con otros objetos. Al garantizar que un certificado solo lo utilice un único objeto de IoT, ayuda a prevenir vulnerabilidades de seguridad.

En AWS IoT efecto, el ID de cliente es un identificador único para una cosa o un dispositivo cuando se conecta al bróker AWS IoT Core MQTT. Si utiliza una asociación no exclusiva, se pueden asociar varios objetos al mismo certificado. Si existe una asociación no exclusiva a un objeto, para mantener una asociación clara y evitar posibles conflictos, debe hacer coincidir su ID de cliente con el nombre del objeto.

Casos de uso

La asociación de un objeto a una conexión ofrece las siguientes funciones.

nota

Tenga en cuenta que si la conexión del objeto de IoT y del cliente tiene una asociación no exclusiva, puede utilizar todas las funciones siguientes, excepto la función de eventos del ciclo de vida. Para incluir el nombre del objeto en los mensajes de los eventos del ciclo de vida, la conexión del objeto de IoT y del cliente debe tener una asociación exclusiva.

Variables de política de cosas: puede usar variables de política de cosas para autorizar el acceso del dispositivo a las operaciones de la AWS IoT API. Estas variables te permiten escribir AWS IoT Core políticas que concedan o denieguen permisos en función de las propiedades de las cosas, como los nombres, los tipos y los valores de los atributos. Al usar variables de política de cosas, puedes aplicar la misma política para controlar varios AWS IoT Core dispositivos. Esto le permite simplificar la administración de políticas y reducir la duplicación de recursos. Para obtener más información, consulte Variables de política de objeto.

Eventos del ciclo de vida: puede recibir el nombre del objeto en los eventos del ciclo de vida (por ejemplo, conectarse, desconectarse, suscribirse y cancelar la suscripción). Esto permite procesar el nombre del objeto incluido en los mensajes, como, por ejemplo, en las reglas. Para obtener más información, consulte Eventos del ciclo de vida.

Resource-specific registro: puedes configurar el registro de recursos específicos para los grupos de cosas y aplicar fácilmente la configuración de registro deseada para todos los elementos del grupo de cosas definido. Para obtener más información, consulte Configure las Resource-specific anulaciones en AWS IoT (CLI).

Asignación de costos: puede crear grupos de facturación con etiquetas personalizadas para la asignación de costos y agregar los objetos a estos grupos. Para obtener más información, consulte Grupos de facturación.

Cómo asociar un objeto a una conexión

Si tu ID de cliente coincide con el nombre de tu cosa en el registro, después de adjuntar un X.509 certificado a esa cosa de IoT, AWS IoT Core asociaremos la conexión del cliente a esa cosa. Si tu ID de cliente no coincide con el nombre de la cosa en el registro, puedes adjuntar exclusivamente un X.509 certificado a la cosa para establecer esta asociación. El objeto que tiene esta asociación exclusiva se denomina “objeto exclusivo”. De lo contrario, se denomina “objeto no exclusivo”. Cuando un certificado está asociado a un objeto exclusivo, este certificado solo se puede asociar a otros objetos si lo desasocia del objeto exclusivo. En esta sección, elija Consola de administración de AWS o AWS CLI asocie una cosa a una conexión.

Para adjuntar un certificado a una cosa exclusivamente mediante el Consola de administración de AWS.

  1. Abre la página de AWS IoT inicio en la AWS IoT consola. En el panel de navegación de la izquierda, en Seguridad, elija Certificados.

  2. En la página Certificados, seleccione el certificado al que desee asociar un objeto. A continuación, seleccione Adjuntar a objetos en Acciones en la esquina superior derecha de la página.

    También puede elegir un certificado y acceder a la página de detalles del certificado. Seleccione la pestaña Objetos y, a continuación, elija Adjuntar a objetos.

  3. En la página Adjuntar certificado a objetos, marque la casilla de verificación Asociar objeto a una conexión. A continuación, elija el objeto al que desea asociar este certificado en la lista desplegable Objetos.

  4. Seleccione Adjuntar objetos. Si la acción se realiza correctamente, aparecerá un banner que indica: “Se ha asociado correctamente un objeto al certificado” y el objeto se agregará a la pestaña Objetos.

Para separar un certificado de una cosa exclusiva, utilice el Consola de administración de AWS

  1. Abre la página de AWS IoT inicio en la AWS IoT consola. En el panel de navegación de la izquierda, en Seguridad, elija Certificados.

  2. En la página Certificados, elija un certificado y diríjase a la página de detalles del certificado.

  3. En la página de detalles del certificado, elija la pestaña Objetos. A continuación, seleccione el objeto del que desee desasociar el certificado. Elija Desasociar objetos.

  4. En la ventana Desasociar objetos, confirme la acción. Elija Desasociar. Si la acción se realiza correctamente, aparecerá un banner que indica: “Se ha desasociado correctamente un objeto del certificado” y el objeto ya no aparecerá en la pestaña Objetos.

  1. Para adjuntar un certificado a algo usando AWS CLI, ejecuta el comando attach-thing-principal. Para especificar la asociación exclusiva de certificado a objeto, debe indicar EXCLUSIVE_THING en el campo --thing-principal-type. El siguiente comando es un ejemplo.

    aws iot attach-thing-principal \
    --thing-name "thing_1" \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8" \
    --thing-principal-type "EXCLUSIVE_THING"

    Este comando no proporciona ninguna salida. Para obtener más información, consulte Asociar un principal a un objeto.

  2. Para enumerar los objetos asociados al certificado especificado, junto con el tipo de asociación, ejecute el comando list-principal-things-v2. El tipo de asociación hace referencia a cómo se asocia el certificado al objeto. El siguiente comando es un ejemplo.

    $ aws iot list-principal-things-v2 \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"

    El resultado puede ser similar al siguiente.

    {
    "PrincipalThingObjects": [
        {
            "thingPrincipalType": "EXCLUSIVE_THING",
            "thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_1"
        }
    ]
}

    Para obtener más información, consulte Enumeración de los objetos asociados a una entidad principal V2.

  3. Para enumerar las entidades principales asociadas al objeto especificado, junto con el tipo de asociación, ejecute el comando list-thing-principals-v2. El tipo de asociación hace referencia a cómo se asocia el certificado al objeto. El siguiente comando es un ejemplo.

    $ aws iot list-thing-principals-v2 \
    --thing-name "thing_1"

    El resultado puede ser similar al siguiente.

    {
    "ThingPrincipalObjects": [
        {
            "thingPrincipalType": "EXCLUSIVE_THING",
            "principal": "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
        }
    ]
}

    Para obtener más información, consulte Enumeración de las entidades principales asociadas a un objeto V2.

  4. Para desasociar un certificado de un objeto, ejecute el comando detach-thing-principal.

    aws iot detach-thing-principal \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8" \
    --thing-name "thing_1"

    Este comando no proporciona ninguna salida. Para obtener más información, consulte Desvincular un principal de un objeto.