Attacher un mandataire à un objet

Un appareil physique peut utiliser un principal pour communiquer avec AWS IoT. Le principal peut être un certificat X.509 ou un identifiant Amazon Cognito. Vous pouvez associer un certificat ou un identifiant Amazon Cognito à l'élément du registre qui représente votre appareil en exécutant la attach-thing-principalcommande.

Pour associer un certificat ou un identifiant Amazon Cognito à votre objet, utilisez la attach-thing-principalcommande suivante :

$ aws iot attach-thing-principal \
    --thing-name "MyLightBulb1" \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"

Pour joindre un certificat à votre objet avec un type de pièce jointe (pièce jointe exclusive ou pièce jointe non exclusive), utilisez la attach-thing-principalcommande et spécifiez un type dans le --thing-principal-type champ. Une pièce jointe exclusive signifie que votre objet IoT est le seul élément attaché au certificat, et que ce certificat ne peut être associé à aucun autre élément. Une pièce jointe non exclusive signifie que votre objet IoT est associé au certificat et que ce certificat peut être associé à d'autres éléments. Pour de plus amples informations, veuillez consulter Associer un AWS IoT objet à une connexion MQTT client.

Note

Pour Associer un AWS IoT objet à une connexion MQTT client cette fonctionnalité, vous ne pouvez utiliser le certificat X.509 qu'en tant que principal.

$ aws iot attach-thing-principal \
    --thing-name "MyLightBulb2" \
    --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
    --thing-principal-type "EXCLUSIVE_THING"

Si la pièce jointe est réussie, la AttachThingPrincipal commande ne produit aucune sortie. Pour décrire la pièce jointe, utilisez la CLI commande list-thing-principals-v 2.

Pour plus d'informations, voir AttachThingPrincipalla AWS IoT Core APIréférence.