# Erste Schritte mit AWS IoT Wireless Sie können mit AWS IoT Wireless beginnen, indem Sie sich für ein AWS-Konto anmelden und die Schritte zum Erstellen eines IAM-Benutzers ausführen. Nachdem Sie sich registriert haben, können Sie die AWS-Managementkonsole, die AWS IoT Wireless-API oder die AWS CLI verwenden, um Ihre Sidewalk- und LoRaWAN-Geräte und -Gateways einzubinden. Überlegen Sie beim Onboarding Ihrer Geräte, wie Sie Ihre Ressourcen beschreiben und markieren können, damit Sie sie leichter identifizieren können. In den folgenden Themen werden erste Schritte mit AWS IoT Wireless beschrieben. **Topics** + [Einrichten von AWS IoT Wireless](setting-up-iotwireless.md) + [Beschreiben Ihrer AWS IoT Wireless-Ressourcen](iotwireless-describe-resources.md) # Einrichten von AWS IoT Wireless Wenn Sie sich bei AWS registrieren, wird Ihr AWS-Konto automatisch für alle Services in AWS einschließlich AWS IoT Wireless registriert. Berechnet werden Ihnen aber nur die Services, die Sie nutzen. Führen Sie zum Einrichten von AWS IoT Wireless die Schritte im folgenden Abschnitt aus: **Topics** + [Einrichten Ihres AWS-Kontos](#iotwireless-setup-account) + [Installieren von Python und der AWS CLI](#wireless-onboard-prereq) ## Einrichten Ihres AWS-Kontos Bevor Sie AWS IoT Core für LoRaWAN oder AWS IoT Core für Amazon Sidewalk zum ersten Mal verwenden, führen Sie die folgenden Aufgaben aus, um Ihr AWS-Konto einzurichten. **Topics** + [Registrieren für ein AWS-Konto](#aws-sign-up-iotwireless) + [Erstellen eines IAM-Benutzers](#create-iam-user-iotwireless) + [Anmelden als IAM-Benutzer](#sign-in-iam-user-iotwireless) ### Registrieren für ein AWS-Konto Wenn Sie kein AWS-Konto haben, führen Sie die folgenden Schritte zum Erstellen durch. **Anmeldung für ein AWS-Konto** 1. Öffnen Sie [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Folgen Sie den Online-Anweisungen. Bei der Anmeldung müssen Sie auch einen Telefonanruf entgegennehmen und einen Verifizierungscode über die Telefontasten eingeben. Wenn Sie sich für ein AWS-Konto anmelden, wird ein *Root-Benutzer des AWS-Kontos* erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem [Administratorbenutzer Administratorzugriff](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html) erfordern. ### Erstellen eines IAM-Benutzers Wählen Sie zum Erstellen eines Administratorbenutzers eine der folgenden Optionen aus. **** | Wählen Sie eine Möglichkeit zur Verwaltung Ihres Administrators aus. | Bis | Von | Sie können auch | | --- | --- | --- | --- | | Im IAM Identity Center (Empfohlen) | Verwendung von kurzfristigen Anmeldeinformationen für den Zugriff auf AWS.Dies steht im Einklang mit den bewährten Methoden für die Sicherheit. Weitere Informationen zu bewährten Methoden finden Sie unter [Bewährte Methoden für die Sicherheit in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) im *IAM-Benutzerhandbuch*. | Beachtung der Anweisungen unter [Erste Schritte](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) im AWS IAM Identity Center-Benutzerhandbuch. | Programmgesteuerten Zugriff unter Berücksichtigung der Informationen im Abschnitt [Konfigurieren von AWS CLI für die Verwendung vonAWS IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) im AWS Command Line Interface-Benutzerhandbuch konfigurieren. | | In IAM (Nicht empfohlen) | Verwendung von langfristigen Anmeldeinformationen für den Zugriff auf AWS. | Beachtung der Anweisungen unter [Erstellen Ihres ersten IAM-Administratorbenutzers und Ihrer ersten Benutzergruppe](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) im IAM-Benutzerhandbuch. | Programmgesteuerten Zugriff unter Verwendung der Informationen unter [Verwalten der Zugriffsschlüssel für IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im IAM-Benutzerhandbuch konfigurieren. | ### Anmelden als IAM-Benutzer Nachdem Sie einen IAM-Benutzer erstellt haben, können Sie sich mit Ihrem IAM-Benutzernamen und Ihrem Passwort bei AWS anmelden. Bevor Sie sich als IAM-Benutzer anmelden, können Sie den Anmelde-Link für IAM-Benutzer in der IAM-Konsole überprüfen. Auf dem IAM-Dashboard finden Sie unter IAM users sign-in link (Anmelde-Link für IAM-Benutzer) den Anmelde-Link für Ihr AWS-Konto. Die URL für Ihren Anmelde-Link enthält Ihre AWS-Konto-ID ohne Bindestriche (-). Wenn Sie nicht möchten, dass die URL für Ihren Anmelde-Link Ihre AWS-Konto-ID enthält, können Sie einen Konto-Alias erstellen. Weitere Informationen finden Sie unter [Erstellen, Löschen und Auflisten eines AWS-Konto-Alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias) im *IAM-Benutzerhandbuch*. **So melden Sie sich als IAM-Benutzer an:** 1. Melden Sie sich von AWS-Managementkonsole ab. 1. Geben Sie Ihren Anmelde-Link ein, der Ihre AWS-Konto-ID (ohne Bindestriche) oder Ihren AWS-Konto-Alias enthält. ``` https://aws_account_id_or_alias.signin.aws.amazon.com/console ``` 1. Geben Sie den IAM-Benutzernamen und das von Ihnen soeben erstellte Passwort ein. Nachdem Sie sich angemeldet haben, wird in der Navigationsleiste *„your\$1user\$1name @ your\$1aws\$1account\$1id“* angezeigt. ## Installieren von Python und der AWS CLI Bevor Sie Ihr LoRaWAN- oder Sidewalk-Endgerät anschließen, müssen Sie Python einrichten und die AWS CLI konfigurieren. **Wichtig** Um den ganzen Onboarding-Workflow zur Bereitstellung und Registrierung des Sidewalk-Endgeräts durchzuführen, müssen Sie auch das Sidewalk Gateway und HDK einrichten. Anweisungen dazu siehe [Einrichten des Hardware Development Kit (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) und [Einrichten von Sidewalk Gateway](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) in der *Amazon Sidewalk-Dokumentation*. **Topics** + [Python und Python3-pip installieren](#wireless-prereq-python) + [Einrichten Ihrer AWS CLI](#wireless-prereq-cli) ### Python und Python3-pip installieren Um AWS CLI und boto3 wie im nachfolgenden Abschnitt beschrieben zu verwenden, müssen Sie eine Python-Version 3.6 oder höher verwenden. Wenn Sie Endgeräte über die AWS IoT Konsole einbinden möchten, können Sie diesen Abschnitt überspringen und mit der Einrichtung von AWS-Konto fortfahren. Führen Sie folgende Befehle aus, um zu überprüfen, ob Python und Python3-pip bereits installiert ist. Wenn die Ausführung der Befehle die Version zurückgibt, bedeutet dies, dass Python und Python3-pip korrekt installiert wurden. ``` python3 -V pip3 --version ``` Wenn der Befehl einen Fehler zurückgibt, kann es daran liegen, dass Python nicht installiert ist oder das Betriebssystem die ausführbare Python v3.x als Python3 aufruft. Ersetzen Sie in diesem Fall alle Instanzen von `python` durch `python3`, wenn Sie die Befehle ausführen. Wenn immer noch Fehler auftreten, laden Sie entweder [Python Installer](https://www.python.org/downloads/) herunter und führen ihn aus oder installieren Sie Python je nach Betriebssystem wie unten beschrieben. ------ #### [ Windows ] Laden Sie Python auf Ihrem Windows-Computer von der [Python Website](https://www.python.org/downloads/windows/) herunter und führen Sie dann das Installationsprogramm aus, um Python auf dem Computer zu installieren. ------ #### [ Linux ] Verwenden Sie den Befehl `sudo`, um Phyton zu installieren: ``` sudo apt install python3 sudo apt install python3-pip ``` ------ #### [ macOS ] Verwenden Sie Homebrew auf einem Mac-Computer, um Python zu installieren. Homebrew installiert auch pip, das dann auf die installierte Version Python3 verweist. ``` $ brew install python ``` ------ ### Einrichten Ihrer AWS CLI Die folgenden Schritte zeigen, wie Sie Ihre AWS CLI und boto3 (AWS SDK für Python) konfigurieren. Bevor Sie diese Schritte ausführen, müssen Sie ein AWS-Konto registrieren und einen administrativen Benutzer einrichten. Detaillierte Anweisungen finden Sie unter [Einrichten von AWS IoT Wireless](#setting-up-iotwireless). 1. **Installieren und Konfigurieren der AWS CLI.** Sie können die AWS CLI verwenden, um Ihre Sidewalk-Endgeräte für Amazon Sidewalk programmgesteuert in AWS IoT Core zu integrieren. Wenn Sie Ihre Geräte über die AWS IoT Konsole einbinden möchten, können Sie diesen Abschnitt überspringen. Öffnen Sie die [AWS IoT Core-Konsole](https://console.aws.amazon.com/iot/home#/) und fahren Sie mit nachfolgendem Abschnitt fort, um mit dem Anschluss der Geräte an AWS IoT Core für Amazon Sidewalk zu beginnen. Anweisungen zur Konfiguration von AWS CLI finden Sie unter [Installation und Konfiguration von AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. **Installieren Sie boto3 (AWS SDK für Python)** Verwenden Sie folgenden Befehl, um boto3 (AWS SDK für Python) und AWS CLI zu installieren: Sie müssen botocore installieren, das für die Ausführung von boto3 erforderlich ist. Eine ausführliche Anleitung finden Sie unter [Installation von Boto3 im * Boto3 Dokumentationshandbuch*](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation). **Anmerkung** `awscli` Version `1.26.6` erfordert eine PyYAML-Version 3.10 oder höher, aber nicht höher als 5.5. ``` python3 -m pip install botocore-version-py3-none-any.whl python3 -m pip install boto3-version-py3-none-any.whl ``` 1. **Konfigurieren der Anmeldeinformation und Standardregion.** Konfigurieren Sie Anmeldeinformationen und Standardregion in den Dateien `~/.aws/credentials` und`~/.aws/config`. Die boto3-Bibliothek verwendet diese Anmeldeinformationen, um AWS-Konto und API-Aufrufe zu identifizieren und zu autorisieren. Anweisungen für die Konfiguration finden Sie unter. + [Konfiguration](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) im *Boto3-Dokumentationsleitfaden* + [Konfiguration und Einstellungen der Anmeldeinformation](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) im *AWS CLIDokumentationshandbuch* # Beschreiben Ihrer AWS IoT Wireless-Ressourcen Bevor Sie mit dem Onboarding Ihrer LoRaWAN- oder Sidewalk-Geräte beginnen, sollten Sie die Benennungskonventionen für Ihre Geräte, Gateways und Ziele berücksichtigen. AWS IoT Wireless bietet mehrere Optionen, um die Ressourcen, die Sie erstellen, leichter zu identifizieren. AWS IoT Wireless-Ressourcen erhalten zwar bei ihrer Erstellung eine eindeutige ID, diese ID ist jedoch weder beschreibend noch kann sie nach der Erstellung der Ressource geändert werden. Um die Auswahl, Identifizierung und Verwaltung Ihrer Ressourcen zu vereinfachen, können Sie den meisten AWS IoT Wireless-Ressourcen auch einen Namen zuweisen, eine Beschreibung hinzufügen und Tags und Tagwerte anhängen. + **[Namen und Beschreibung von Ressourcen](#wireless-describe-resource-names)** Bei Geräten, Gateways und Profilen ist der Ressourcenname ein optionales Feld, das Sie ändern können, nachdem die Ressource erstellt wurde. Der Name erscheint in den Listen, die auf den Resource Hub-Seiten angezeigt werden. Für Ziele geben Sie einen Namen an, der in Ihrem AWS Konto eindeutig ist und AWS-Region. Sie können den Zielnamen nach dem Erstellen der Zielressource nicht mehr ändern. Ein Name kann zwar bis zu 256 Zeichen lang sein, der Anzeigeplatz im Resource Hub ist jedoch begrenzt. Stellen Sie sicher, dass der kennzeichnende Teil des Namens nach Möglichkeit in den ersten 20 bis 30 Zeichen erscheint. + **[Ressourcen-Tags](#wireless-describe-resource-tags)** Tags sind Schlüssel-Wert-Paare von Metadaten, die an AWS Ressourcen angehängt werden können. Sie wählen beide Tag-Schlüssel und die entsprechenden Werte aus. An Gateways, Ziele und Profile können bis zu 50 Tags angehängt werden. Geräte unterstützen keine Tags. ## Namen und Beschreibung von Ressourcen **Unterstützung für AWS IoT Wireless-Ressourcen-Namen** | Ressource | Unterstützung für Namensfelder | | --- | --- | | Bestimmungsort | Der Name ist eine eindeutige ID der Ressource und kann nicht geändert werden. | | Drahtloses Gerät | Der Name ist ein optionaler Deskriptor der Ressource und kann geändert werden. | | LoRaWAN-Gateway | Der Name ist ein optionaler Deskriptor der Ressource und kann geändert werden. | | Profil | Der Name ist ein optionaler Deskriptor der Ressource und kann geändert werden. | Das Namensfeld wird in Ressourcenlisten von Resource Hubs angezeigt. Der Speicherplatz ist jedoch begrenzt, sodass möglicherweise nur die ersten 15 bis 30 Zeichen des Namens sichtbar sind. Denken Sie bei der Auswahl der Namen für Ihre Ressourcen darüber nach, wie sie die Ressourcen identifizieren sollen und wie sie in der Konsole angezeigt werden sollen. **Beschreibung** Ziel-, Geräte- und Gateway-Ressourcen unterstützen auch ein Beschreibungsfeld, das bis zu 2.048 Zeichen aufnehmen kann. Das Beschreibungsfeld wird nur auf der Detailseite der einzelnen Ressource angezeigt. Das Beschreibungsfeld kann zwar viele Informationen enthalten, da es nur auf der Detailseite der Ressource angezeigt wird, eignet sich aber nicht für das Scannen im Kontext mehrerer Ressourcen. ## Ressourcen-Tags **Unterstützung von AWS Tags für AWS IoT Wireless-Ressourcen** | Ressource | AWS Tag-Unterstützung | | --- | --- | | Bestimmungsort | Sie können bis zu 50 AWS Tags für jede Ressource hinzufügen. | | Drahtloses Gerät | Diese Ressource unterstützt keine AWS Tags. | | LoRaWAN-Gateway | Sie können bis zu 50 AWS Tags für jede Ressource hinzufügen. | | Profil | Sie können bis zu 50 AWS Tags für jede Ressource hinzufügen. | Tags sind Wörter oder Phrasen, die als Metadaten fungieren und die Sie verwenden können, um Ihre AWS-Ressourcen zu identifizieren und zu verwalten. Sie können sich den Tag-Schlüssel als eine Informationskategorie und den Tag-Wert als einen bestimmten Wert in dieser Kategorie vorstellen. Sie könnten beispielsweise den Tagwert *Farbe* verwenden und dann einigen Ressourcen den Wert *Blau* für dieses Tag und anderen den Wert *Rot* zuweisen. Damit könnten Sie den [Tag-Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) in der AWS Konsole verwenden, um die Ressourcen mit dem *Farb-Tag-Wert* *Blau* zu finden. Weitere Informationen über das Markieren mit Tags in AWS IoT Wireless finden Sie unter [Markieren Ihrer AWS IoT Wireless-Ressourcen](tagging-iotwireless.md). Weitere Informationen zu Tags und Tag-Strategien finden Sie unter [Tag-Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).