View a markdown version of this page

Zuordnen einer AWS IoT Ding zu einer MQTT-Client-Verbindung - AWS IoT Core
AnwendungsfälleWie verbinde ich eine Sache mit einer Verbindung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Zuordnen einer AWS IoT Ding zu einer MQTT-Client-Verbindung

Eine exklusive Dingzuordnung liegt vor, wenn Sie ein X.509 Zertifikat an eine einzelne AWS IoT Sache anhängen. In diesem Fall kann das Zertifikat nicht zusammen mit anderen Dingen verwendet werden. Indem sichergestellt wird, dass ein Zertifikat nur von einem einzigen IoT-Gerät verwendet wird, werden Sicherheitslücken vermieden.

In AWS IoT ist die Client-ID eine eindeutige Kennung für ein Ding oder ein Gerät, wenn es eine Verbindung zum AWS IoT Core MQTT-Broker herstellt. Wenn Sie eine nicht exklusive Verknüpfung verwenden, können mehrere Dinge an dasselbe Zertifikat angehängt werden. Wenn eine nicht ausschließliche Zuordnung besteht, müssen Sie Ihre Client-ID mit dem Namen des Dings abgleichen, um eine klare Zuordnung aufrechtzuerhalten und potenzielle Konflikte zu vermeiden.

Anwendungsfälle

Das Zuordnen eines Dings zu einer Verbindung bietet die folgenden Funktionen.

Anmerkung

Beachten Sie, dass Sie, wenn Ihr IoT-Ding und Ihre Client-Verbindung eine nicht ausschließliche Verknüpfung haben, alle folgenden Funktionen mit Ausnahme der Funktion für Lebenszyklusereignisse verwenden können. Um Ihren Ding-Namen in die Lebenszyklus-Ereignismeldungen aufzunehmen, müssen Ihr IoT-Ding und Ihre Client-Verbindung eine exklusive Verknüpfung haben.

Ding-Richtlinienvariablen — Sie können Ding-Richtlinienvariablen verwenden, um den Gerätezugriff auf AWS IoT API-Operationen zu autorisieren. Mit diesen Variablen können Sie AWS IoT Core Richtlinien schreiben, die Berechtigungen auf der Grundlage von Dingeigenschaften wie Namen, Typen und Attributwerten gewähren oder verweigern. Mithilfe von Dingrichtlinienvariablen können Sie dieselbe Richtlinie anwenden, um mehrere AWS IoT Core Geräte zu steuern. Auf diese Weise können Sie die Richtlinienverwaltung vereinfachen und die doppelte Nutzung von Ressourcen reduzieren. Weitere Informationen finden Sie unter Ding-Richtlinienvariablen.

Lebenszyklusereignisse — Sie können den Namen des Dings in Lebenszyklusereignissen erhalten (z. B. Verbinden, Trennen und Abonnieren und Abmelden). Dies ermöglicht die Verarbeitung des in den Nachrichten enthaltenen Dingnamens, z. B. in Regeln. Weitere Informationen finden Sie unter Lifecycle-Ereignisse.

Resource-specific Protokollierung — Sie können die ressourcenspezifische Protokollierung für Dinggruppen konfigurieren und auf einfache Weise die gewünschte Protokollierungskonfiguration für alle Dinge innerhalb der definierten Dinggruppe anwenden. Weitere Informationen finden Sie unter Konfigurieren Sie Resource-specific Überschreibungen in AWS IoT (CLI).

Kostenzuweisung — Sie können Abrechnungsgruppen mit benutzerdefinierten Stichwörtern für die Kostenzuweisung erstellen und die Dinge zu diesen Gruppen hinzufügen. Weitere Informationen finden Sie unter Abrechnungsgruppen.

Wie verbinde ich eine Sache mit einer Verbindung

Wenn Ihre Client-ID mit dem Namen Ihres Dings in der Registrierung übereinstimmt, AWS IoT Core wird die Client-Verbindung dem Ding zugeordnet, nachdem Sie ein X.509 Zertifikat an dieses IoT-Ding angehängt haben. Wenn Ihre Client-ID nicht mit dem Namen des Dings in der Registrierung übereinstimmt, können Sie dem Ding ausschließlich ein X.509 Zertifikat beifügen, um diese Zuordnung herzustellen. Das Ding, das diesen exklusiven Anhang hat, wird als exklusives Ding bezeichnet. Andernfalls wird es als nicht ausschließliches Ding bezeichnet. Wenn ein Zertifikat mit einer exklusiven Sache verknüpft ist, kann dieses Zertifikat nur dann mit anderen Dingen verknüpft werden, wenn Sie es von der exklusiven Sache trennen. Wählen Sie in diesem Abschnitt entweder AWS-Managementkonsole oder aus, AWS CLI um einer Verbindung ein Ding zuzuordnen.

Um ein Zertifikat an ein Objekt anzuhängen, verwenden Sie ausschließlich die AWS-Managementkonsole.

  1. Öffnen Sie die AWS IoT Startseite in der AWS IoT Konsole. Wählen Sie im linken Navigationsbereich unter Sicherheit die Option Zertifikate aus.

  2. Wählen Sie auf der Seite „Zertifikate“ ein Zertifikat aus, an das Sie etwas anhängen möchten. Wählen Sie dann in der oberen rechten Ecke der Seite unter Aktionen die Option An Dinge anhängen aus.

    Wählen Sie alternativ ein Zertifikat aus und navigieren Sie zur Seite mit den Zertifikatsdetails. Wählen Sie den Tab „Dinge“ und dann „An Dinge anhängen“.

  3. Markieren Sie auf der Seite Zertifikat an Sache (en) anhängen das Kontrollkästchen Ding mit Verbindung verknüpfen. Wählen Sie dann aus der Dropdownliste Dinge ein Objekt aus, an das dieses Zertifikat angehängt werden soll.

  4. Wählen Sie Ding (e) anhängen aus. Wenn die Aktion erfolgreich ist, wird ein Banner mit der Aufschrift „Ihrem Zertifikat wurde erfolgreich eine Sache angehängt“ angezeigt, und das Ding wird dem Tab „Dinge“ hinzugefügt.

Um ein Zertifikat von einem exklusiven Objekt zu trennen, verwenden Sie den AWS-Managementkonsole

  1. Öffnen Sie die AWS IoT Startseite in der AWS IoT Konsole. Wählen Sie im linken Navigationsbereich unter Sicherheit die Option Zertifikate aus.

  2. Wählen Sie auf der Seite Zertifikate ein Zertifikat aus und navigieren Sie zur Seite mit den Zertifikatsdetails.

  3. Wählen Sie auf der Seite mit den Zertifikatsdetails die Registerkarte Dinge aus. Wählen Sie dann eine Sache aus, von der Sie das Zertifikat trennen möchten. Wählen Sie Dinge trennen aus.

  4. Bestätigen Sie im Fenster Dinge trennen Ihre Aktion. Wählen Sie Trennen aus. Wenn die Aktion erfolgreich ist, wird ein Banner mit der Aufschrift „Eine Sache wurde erfolgreich von Ihrem Zertifikat getrennt“ angezeigt, und das Ding wird nicht mehr auf der Registerkarte „Dinge“ angezeigt.

  1. Um ein Zertifikat mit einem Objekt anzuhängen AWS CLI, führen Sie den Befehl attach-thing-principal aus. Um den exklusiven Anhang des Zertifikats an das Ding anzugeben, müssen Sie dies EXCLUSIVE_THING in dem Feld angeben. --thing-principal-type Ein Beispielbefehl kann der folgende sein.

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

    Dieser Befehl liefert keine Ausgabe. Weitere Informationen finden Sie unter Ein Prinzipal an ein Objekt anfügen.

  2. Führen Sie den list-principal-things-v2 Befehl aus, um die mit dem angegebenen Zertifikat verknüpften Elemente zusammen mit dem Anhangstyp aufzulisten. Der Anhangstyp bezieht sich darauf, wie das Zertifikat an das Ding angehängt wird. Ein Beispielbefehl kann der folgende sein.

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

    Die Ausgabe kann wie folgt aussehen.

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

    Weitere Informationen finden Sie unter Listet Dinge auf, die mit einem Principal V2 verknüpft sind.

  3. Führen Sie den list-thing-principals-v2 Befehl aus, um die Prinzipale, die dem angegebenen Objekt zugeordnet sind, zusammen mit dem Anhangstyp aufzulisten. Der Anhangstyp bezieht sich darauf, wie das Zertifikat an das Ding angehängt wird. Ein Beispielbefehl kann der folgende sein.

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

    Die Ausgabe kann wie folgt aussehen.

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

    Weitere Informationen finden Sie unter Listet Prinzipale auf, die einer Sache zugeordnet sind (V2).

  4. Um ein Zertifikat von einem Ding zu trennen, führen Sie den Befehl https://docs.aws.amazon.com/cli/latest/reference/iot/detach-thing-principal.html detach-thing-principal aus.

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

    Dieser Befehl liefert keine Ausgabe. Weitere Informationen finden Sie unter Ein Prinzipal von einem Objekt trennen.