AWS Cloud9 ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von AWS Cloud9 können den Dienst weiterhin wie gewohnt nutzen. [Weitere Informationen](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/) 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. # Arbeiten mit AWS IoT in AWS Cloud9 IDE Mit AWS IoT der AWS Cloud9 integrierten IDE können Sie mit dem AWS IoT Dienst interagieren und gleichzeitig Unterbrechungen Ihres Arbeitsablaufs minimieren. AWS Cloud9 In diesem Handbuch wird beschrieben, wie Sie mit der Nutzung der in der IDE verfügbaren AWS IoT Servicefunktionen beginnen können. AWS Cloud9 Weitere Informationen finden Sie unter [Was ist AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) im *AWS IoT -Entwicklerhandbuch*. ## AWS IoT Voraussetzungen Um mit der Verwendung AWS IoT in der AWS Cloud9 IDE zu beginnen, stellen Sie sicher, dass Ihr AWS-Konto und Ihr AWS Cloud9 Setup alle Anforderungen erfüllen. Informationen zu den spezifischen AWS-Konto Anforderungen und AWS Benutzerberechtigungen für den AWS IoT Dienst finden Sie unter [Erste Schritte mit AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html) im *AWS IoT Entwicklerhandbuch*. ## AWS IoT Dinge AWS IoT verbindet Geräte mit AWS-Services und AWS Ressourcen. Sie können Ihre Geräte mit verbinden, AWS IoT indem Sie Objekte verwenden, die als **Dinge** bezeichnet werden. Ein Objekt ist eine Darstellung eines bestimmten Geräts oder einer logischen Entität. Es kann ein physisches Gerät oder ein Sensor sein (beispielsweise eine Glühbirne oder ein Wandschalter). Weitere Informationen dazu finden AWS IoT Sie unter [Geräte verwalten mit AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html) im *AWS IoT Entwicklerhandbuch*. ### AWS IoT Dinge verwalten Die AWS Cloud9 IDE verfügt über mehrere Funktionen, mit denen Sie Ihre Dinge effizient verwalten können. Gehen Sie wie folgt vor, um Ihre AWS IoT Dinge zu verwalten: + [Create a thing](#thing-create) + [Attach a certificate to a thing](#thing-certificate-attach) + [Detach a certificate from a thing](#thing-certificate-detach) + [Delete a thing](#thing-delete) **So erstellen Sie eine Objekt** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das **Objekt** und wählen Sie **Create Thing** (Objekt erstellen) aus. 1. Geben Sie einen Namen für das **Objekt** im Feld **Thing Name** (Objektname) ein und folgen Sie der Aufforderung. 1. Wenn dieser Schritt abgeschlossen ist, ist ein **Objektsymbol** gefolgt von dem von Ihnen angegebenen Namen im Abschnitt **Thing** (Objekt) sichtbar. **So fügen Sie einem Objekt ein Zertifikat an** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Things** (Objekte) nach dem **Objekt**, dem Sie das Zertifikat anfügen. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das **Objekt** und wählen Sie im Kontextmenü **Attach Certificate** (Zertifikat anfügen) aus, um einen Eingabeselektor mit einer Liste Ihrer Zertifikate zu öffnen. 1. Wählen Sie aus der Liste die **Zertifikats-ID** aus, die dem Zertifikat entspricht, das Sie Ihrem Objekt anfügen möchten. 1. Nachdem dieser Schritt abgeschlossen ist, ist Ihr Zertifikat im AWS Explorer als Element des Objekts verfügbar, dem Sie es angefügt haben. **So trennen Sie ein Zertifikat von einem Objekt** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Things** (Objekte) nach dem **Objekt**, dessen Zertifikat Sie trennen möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das **Objekt** und wählen Sie **Attach Certificate** (Zertifikat anfügen) aus. 1. Nachdem dieser Schritt abgeschlossen ist, wird das separate Zertifikat nicht mehr unter dem Ding im AWS Explorer angezeigt. Es ist jedoch weiterhin im Unterabschnitt **Certificates** (Zertifikate) verfügbar. **So löschen Sie ein Objekt** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Things** (Objekte) nach dem **Objekt**, das Sie löschen möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das **Objekt** und wählen Sie **Delete Thing** (Objekt löschen) aus. 1. Nachdem dieser Schritt abgeschlossen ist, ist das gelöschte **Objekt** nicht mehr im Unterabschnitt **Things** (Objekte) verfügbar. **Anmerkung** Sie können nur ein Objekt löschen, dem kein Zertifikat angefügt ist. ## AWS IoT zertifikate Zertifikate sind eine gängige Methode, um eine sichere Verbindung zwischen Ihren AWS IoT -Services und -Geräten herzustellen. X.509-Zertifikate sind digitale Zertifikate, die den X.509-Standard für Public-Key-Infrastrukturen verwenden, um einen öffentlichen Schlüssel mit einer Identität in einem Zertifikat zu verknüpfen. Weitere Informationen zu AWS IoT Zertifikaten finden Sie unter [Authentifizierung (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) im *AWS IoT Entwicklerhandbuch*. ### Verwalten von Zertifikaten Das AWS Toolkit bietet eine Vielzahl von Möglichkeiten, wie Sie Ihre AWS IoT Zertifikate direkt vom AWS Explorer aus verwalten können. Sie werden in den folgenden Schritten beschrieben: + [Create a certificate](#cert-create) + [Change a certificate status](#cert-status) + [Attach a policy to a certificate](#cert-attach-policy) + [Delete a certificate](#cert-delete) **Um ein Zertifikat zu erstellen AWS IoT** Ein X.509-Zertifikat wird verwendet, um eine Verbindung mit Ihrer Instanz von AWS IoT herzustellen. 1. Erweitern Sie im AWS Explorer den Abschnitt **IoT-Dienst** und öffnen Sie (Rechtsklick) **Zertifikate**. 1. Wenn Sie ein Dialogfeld öffnen möchten, wählen Sie im Kontextmenü die Option **Create Certificate** (Zertifikat erstellen) aus. 1. Um Ihr RSA-Schlüsselpaar und Ihr X.509-Zertifikat zu speichern, wählen Sie ein Verzeichnis in Ihrem lokalen Dateisystem aus. **Anmerkung** Die Standarddateinamen enthalten die Zertifikat-ID als Präfix. Nur das X.509-Zertifikat wird über den AWS IoT Dienst bei Ihnen AWS-Konto gespeichert. Ihr RSA-Schlüsselpaar kann nur einmal ausgestellt werden. Speichern Sie es an einem sicheren Ort in Ihrem Dateisystem, wenn Sie dazu aufgefordert werden. Wenn das Zertifikat oder das key pair nicht in Ihrem Dateisystem gespeichert werden können, löscht das AWS Toolkit das Zertifikat aus Ihrem. AWS-Konto **So ändern Sie den Status eines Zertifikats** **Der Status eines einzelnen Zertifikats wird im AWS Explorer neben der Zertifikat-ID angezeigt und kann auf **aktiv, **inaktiv**** oder gesperrt gesetzt werden.** **Anmerkung** Ihr Zertifikat muss einen **aktiven** Status haben, bevor Sie es verwenden können, um Ihr Gerät mit Ihrem AWS IoT Dienst zu verbinden. Ein **inaktives** Zertifikat kann aktiviert werden, unabhängig davon, ob es zuvor deaktiviert wurde oder standardmäßig inaktiv ist. Ein Zertifikat, das **widerrufen** wurde, kann nicht erneut aktiviert werden. 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Certificates** (Zertifikate) das Zertifikat, das Sie ändern möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das Zertifikat, das die Optionen zur Statusänderung anzeigt, die für dieses Zertifikat verfügbar sind. + Wenn ein Zertifikat den Status **inactive** (inaktiv) hat, wählen Sie **activate** (Aktivieren) aus, um den Status in **active** (aktiv) zu ändern. + Hat ein Zertifikat den Status **active** (aktiv), wählen Sie **deactivate** (Deaktivieren) aus, um den Status in **inactive** (inaktiv) zu ändern. + Wenn ein Zertifikat weder den Status **active** (aktiv) noch **inactive** (inaktiv) hat, wählen Sie **revoke** (Widerrufen) aus, um den Status in **revoked** (widerrufen) zu ändern. **Anmerkung** Jede dieser Aktionen zur Statusänderung ist verfügbar, wenn Sie ein Zertifikat auswählen, das einem Objekt im Unterabschnitt **Things** (Objekte) angefügt ist. **So fügen Sie einem Zertifikat eine IoT-Richtlinie an** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Certificates** (Zertifikate) das Zertifikat, das Sie ändern möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das Zertifikat und wählen Sie **Attach Policy** (Richtlinie anfügen) aus, um einen Eingabeselektor mit einer Liste der verfügbaren Richtlinien zu öffnen. 1. Wählen Sie die Richtlinie aus, die Sie dem Zertifikat anfügen möchten. 1. Wenn dieser Schritt abgeschlossen ist, wird die von Ihnen ausgewählte Richtlinie dem Zertifikat als Untermenüelement hinzugefügt. **So trennen Sie eine IoT-Richtlinie von einem Zertifikat** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Suchen Sie im Unterabschnitt **Certificates** (Zertifikate) das Zertifikat, das Sie ändern möchten. 1. Erweitern Sie das Zertifikat und suchen Sie die Richtlinie, die Sie trennen möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) und wählen Sie **Detach** (Trennen) aus dem Kontextmenü aus. 1. Wenn dieser Schritt abgeschlossen ist, ist die Richtlinie nicht mehr über Ihr Zertifikat verfügbar. Sie steht im Unterabschnitt **Policy** (Richtlinie) zur Verfügung. **So löschen Sie ein Zertifikat** 1. Erweitern Sie im AWS Explorer die Überschrift **IoT-Dienst**. 1. Suchen Sie im Unterabschnitt **Certificates** (Zertifikate) das Zertifikat, das Sie löschen möchten. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für das Zertifikat und wählen Sie **Delete Certificate** (Zertifikat löschen) aus dem Kontextmenü aus. **Anmerkung** Sie können ein Zertifikat nicht löschen, wenn es einem Objekt angefügt ist oder einen aktiven Status hat. Sie können ein Zertifikat löschen, dem Richtlinien angefügt sind. ## AWS IoT Richtlinien AWS IoT Kernrichtlinien werden durch JSON-Dokumente definiert. Jede Richtlinie muss mindestens eine Richtlinienanweisung umfassen. Richtlinien definieren AWS IoT, wie AWS, und Ihr Gerät miteinander interagieren können. Weitere Informationen zum Erstellen eines Richtliniendokuments finden Sie unter [IoT-Richtlinien](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) im *AWS IoT -Entwicklerhandbuch*. **Anmerkung** Benannte Richtlinien sind versioniert, sodass Sie ein Rollback für sie ausführen können. Im AWS Explorer werden Ihre IoT-Richtlinien im Unterabschnitt **Richtlinien** des Dienstes aufgeführt. AWS IoT Sie können die Versionen der Richtlinien anzeigen, indem Sie eine Richtlinie erweitern. Die Standardversion ist mit einem Sternchen (\$1) gekennzeichnet. ### Verwalten von Richtlinien Die AWS Cloud9 IDE bietet Ihnen mehrere Möglichkeiten, Ihre AWS IoT Servicerichtlinien zu verwalten. Auf diese Weise können Sie Ihre Richtlinien direkt im AWS Explorer in VS Code verwalten oder ändern: + [Create a policy](#policy-create) + [Upload a new policy version](#policy-version-upload) + [Edit a policy version](#policy-version-edit) + [Change the policy version defualt](#policy-version-default) + [Change the policy version defualt](#policy-delete) **Um eine AWS IoT Richtlinie zu erstellen** **Anmerkung** Sie können im AWS Explorer eine neue Richtlinie erstellen. Das JSON-Dokument, das die Richtlinie definiert, muss jedoch bereits in Ihrem Dateisystem vorhanden sein. 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für den Unterabschnitt **Policies** (Richtlinien) und wählen Sie **Create Policy from Dokument** (Richtlinie aus Dokument erstellen) aus, um das Eingabefeld **Policy Name** (Richtlinienname) zu öffnen. 1. Geben Sie einen Namen ein und folgen Sie den Anweisungen, um ein Dialogfeld zu öffnen, in dem Sie aufgefordert werden, ein JSON-Dokument aus Ihrem Dateisystem auszuwählen. 1. Wählen Sie die JSON-Datei aus, die Ihre Richtliniendefinitionen enthält. Sobald dieser Vorgang abgeschlossen ist, ist die Richtlinie im AWS Explorer verfügbar. **Um eine neue AWS IoT Richtlinienversion hochzuladen** Sie können eine neue Version einer Richtlinie erstellen, indem Sie ein JSON-Dokument in die Richtlinie hochladen. **Anmerkung** Das neue JSON-Dokument muss in Ihrem Dateisystem vorhanden sein, um mit dem AWS Explorer eine neue Version zu erstellen. 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) um Ihre AWS IoT -Richtlinien anzuzeigen. 1. Öffnen Sie das Kontextmenü (rechte Maustaste) für die zu aktualisierende Richtlinie und wählen Sie **Create new version from Document** (Neue Version aus Dokument erstellen) aus. 1. Wenn das Dialogfeld geöffnet wird, wählen Sie die JSON-Datei aus, die die Aktualisierungen Ihrer Richtliniendefinitionen enthält. Auf die neue Version kann über Ihre Richtlinie im AWS Explorer zugegriffen werden. **Um eine AWS IoT Richtlinienversion zu bearbeiten** Sie können ein Richtliniendokument mit öffnen und bearbeiten AWS Cloud9. Wenn Sie mit der Bearbeitung des Dokuments fertig sind, speichern Sie es in Ihrem Dateisystem. Laden Sie es dann aus dem AWS Explorer in Ihren AWS IoT Dienst hoch. 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) und suchen Sie die Richtlinie, die Sie aktualisieren möchten. 1. Um den **Richtliniennamen** zu öffnen, wählen Sie **Create Policy**** from Document** (Richtlinie aus Dokument erstellen) aus. 1. Erweitern Sie die zu aktualisierende Richtlinie und öffnen Sie dann das Kontextmenü (rechte Maustaste) für die zu bearbeitende Version der Richtlinie. 1. Um die Richtlinienversion in zu öffnen AWS Cloud9, wählen Sie im Kontextmenü die Option **Ansicht** aus, um die Richtlinienversion zu öffnen. 1. Wenn das Richtliniendokument geöffnet ist, bearbeiten Sie es und speichern Sie die Änderungen. **Anmerkung** Zu diesem Zeitpunkt werden die Änderungen, die Sie an der Richtlinie vorgenommen haben, nur in Ihrem lokalen Dateisystem gespeichert. Um die Version zu aktualisieren und sie mit dem AWS Explorer zu verfolgen, wiederholen Sie die Schritte unter. [Upload a new policy version](#policy-version-upload) **So wählen Sie eine neue Standardversion einer Richtlinie aus** 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) und suchen Sie die Richtlinie, die Sie aktualisieren möchten. 1. Erweitern Sie die zu aktualisierende Richtlinie und öffnen Sie dann das Kontextmenü (rechte Maustaste) für die Version der Richtlinie, die Sie festlegen möchten. Wählen Sie dann **Set as Default** (Als Standard festlegen) aus. Wenn dieser Vorgang abgeschlossen ist, wird neben der neuen Standardversion, die Sie ausgewählt haben, ein Stern angezeigt. **So löschen Sie -Richtlinien** **Anmerkung** Bevor Sie eine Richtlinie oder eine Richtlinienversion löschen können, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind: Sie können eine Richtlinie nicht löschen, wenn diese Richtlinie einem Zertifikat angefügt ist. Sie können eine Richtlinie nicht löschen, wenn diese Richtlinie Versionen hat, die von der Standardversion abweichen. Sie können die Standardversion einer Richtlinie nur löschen, wenn eine neue Standardversion ausgewählt ist oder die gesamte Richtlinie gelöscht wird. Bevor Sie eine gesamte Richtlinie löschen, müssen Sie alle Versionen dieser Richtlinie löschen, die von der Standardversion abweichen. 1. Erweitern Sie im AWS Explorer den Bereich **IoT-Service**. 1. Erweitern Sie den Unterabschnitt **Policies** (Richtlinien) und suchen Sie die Richtlinie, die Sie aktualisieren möchten. 1. Erweitern Sie die zu aktualisierende Richtlinie und öffnen Sie dann das Kontextmenü (rechte Maustaste) für die zu löschende Version der Richtlinie. Wählen Sie dann **Delete** (Löschen) aus. 1. Wenn eine Version gelöscht wird, ist sie im AWS Explorer nicht mehr sichtbar. 1. Wenn nur die Standardversion einer Richtlinie verbleibt, öffnen Sie das Kontextmenü (rechte Maustaste) für die übergeordnete Richtlinie und wählen Sie **Delete** (Löschen) aus.