Erstellen einer geheimen Ressource (Konsole)

Melden Sie sich an der AWS Secrets Manager-Konsole an.

Wählen Sie Store a new secret (Ein neues Secret speichern).

Wählen Sie unter Geheimtyp auswählen die Option Anderer Geheimtyp aus.

Unter Specify the key/value pairs to be stored for this secret (Angabe der Schlüssel/Wert-Paare, die für dieses Secret gespeichert werden sollen):

Lassen Sie aws/secretsmanager für den Verschlüsselungsschlüssel ausgewählt und wählen Sie dann Weiter.

Geben Sie für Secret name (Secret-Name) greengrass-TestSecret ein und klicken Sie auf Next (Weiter).

Für dieses Tutorial ist keine Rotation erforderlich. Wählen Sie daher Automatische Rotation deaktivieren und anschließend Weiter.

Prüfen Sie auf der Seite Review (Prüfen) Ihre Einstellungen und wählen Sie Store (Speichern).

Als nächstes erstellen Sie in Ihrer Greengrass-Gruppe eine geheime Ressource, die auf das Secret verweist.

Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter Verwalten die Option Greengrass-Geräte und wählen Sie dann Gruppen (V1) aus.

Wählen Sie die Gruppe, zu der Sie die geheime Ressource hinzufügen möchten.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Ressourcen und scrollen Sie dann nach unten zum Abschnitt Secrets. Im Bereich Secrets werden die geheimen Ressourcen angezeigt, die zu der Gruppe gehören. In diesem Bereich können Sie geheime Ressourcen hinzufügen, bearbeiten und entfernen.

Wählen Sie im Bereich Secrets die Option Hinzufügen aus.

Geben Sie auf der Seite Geheime Ressource hinzufügen MyTestSecret den Namen der Ressource ein.

Wählen Sie unter Geheim die Option greengrass- TestSecret aus.

Im Abschnitt Select labels (optional) steht das AWSCURRENT Staging-Label für die neueste Version des Secrets. Dieses Label ist immer in einer geheimen Ressource enthalten.

Wählen Sie Add resource (Ressource hinzufügen) aus.

Laden Sie von der AWS IoT GreengrassCore SDK-Downloadseite das AWS IoT Greengrass Core SDK für Python auf Ihren Computer herunter.

Entpacken Sie das heruntergeladene Paket, um das SDK zu erhalten. Das SDK ist der greengrasssdk-Ordner.

Speichern Sie die folgende Pythoncode-Funktion in einer lokalen Datei namens secret_test.py.

import greengrasssdk

secrets_client = greengrasssdk.client("secretsmanager")
iot_client = greengrasssdk.client("iot-data")
secret_name = "greengrass-TestSecret"
send_topic = "secrets/output"


def function_handler(event, context):
    """
    Gets a secret and publishes a message to indicate whether the secret was
    successfully retrieved.
    """
    response = secrets_client.get_secret_value(SecretId=secret_name)
    secret_value = response.get("SecretString")
    message = (
        f"Failed to retrieve secret {secret_name}."
        if secret_value is None
        else f"Successfully retrieved secret {secret_name}."
    )
    iot_client.publish(topic=send_topic, payload=message)
    print("Published: " + message)

Die get_secret_value Funktion unterstützt den Namen oder ARN des Secrets Manager Manager-Geheimnisses für den SecretId Wert. Dieses Beispiel verwendet den Namen des Secrets. Für dieses Beispiel-Secret gibt AWS IoT Greengrass das Schlüssel-Werte-Paar zurück: {"test":"abcdefghi"}.

Packen Sie die folgenden Elemente in einer ZIP-Datei mit dem Namen secret_test_python.zip. Schließen Sie beim Erstellen einer ZIP-Datei nur den Code und die Abhängigkeiten ein, nicht den dazugehörigen Ordner.

Dies ist Ihr Lambda-Funktionsbereitstellungspaket.

Erstellen Sie zunächst die Lambda-Funktion.

1. Wählen Sie in der AWS Management Console Services und öffnen Sie die AWS Lambda-Konsole.

2. Wählen Sie Funktion erstellen und dann Author from scratch.

3. Verwenden Sie im Abschnitt Basic information (Basisinformationen) folgende Werte:

   • Geben Sie für Function name (Funktionsname) SecretTest ein.

   • Wählen Sie für Runtime (Laufzeit) die Option Python 3.7 aus.

   • Behalten Sie für Berechtigungen die Standardeinstellung bei. Dadurch wird eine Ausführungsrolle erstellt, die grundlegende Lambda-Berechtigungen gewährt. Diese Rolle wird nicht verwendet vonAWS IoT Greengrass.

4. Klicken Sie unten auf der Seite auf Create function.

Registrieren Sie als Nächstes den Handler und laden Sie Ihr Lambda-Funktionsbereitstellungspaket hoch.

1. Wählen Sie auf der Registerkarte Code unter Codequelle die Option Hochladen von aus. Wählen Sie in der Dropdownliste die ZIP-Datei aus.

   

2. Wählen Sie Upload und anschließend Ihr secret_test_python.zip Bereitstellungspaket aus. Wählen Sie dann Save (Speichern) aus.

3. Wählen Sie auf der Registerkarte Code für die Funktion unter Laufzeiteinstellungen die Option Bearbeiten aus, und geben Sie dann die folgenden Werte ein.

   • Wählen Sie für Runtime (Laufzeit) die Option Python 3.7 aus.

   • Geben Sie unter Handler secret_test.function_handler ein.

4. Wählen Sie Speichern aus.

   Anmerkung

   Die Testtaste auf der AWS Lambda Konsole funktioniert mit dieser Funktion nicht. Das AWS IoT Greengrass Core SDK enthält keine Module, die erforderlich sind, um Ihre Greengrass Lambda-Funktionen unabhängig in der AWS Lambda Konsole auszuführen. Diese Module (zum Beispielgreengrass_common) werden den Funktionen zur Verfügung gestellt, nachdem sie auf Ihrem Greengrass-Kern bereitgestellt wurden.

Veröffentlichen Sie jetzt die erste Version Ihrer Lambda-Funktion und erstellen Sie einen Alias für die Version.

1. Wählen Sie im Menü Actions die Option Publish new version aus.

2. Geben Sie unter Version description (Versionsbeschreibung) den Wert First version ein und wählen Sie dann Publish (Veröffentlichen) aus.

3. Wählen Sie auf der Konfigurationsseite SecretTest: 1 im Menü Aktionen die Option Alias erstellen aus.

4. Geben Sie auf der Seite Create a new alias folgende Werte an:

   • Geben Sie unter Name GG_SecretTest ein.

   • Wählen Sie für Version die Option 1.

   Anmerkung

   AWS IoT Greengrassunterstützt keine Lambda-Aliase für $LATEST-Versionen.

5. Wählen Sie Erstellen aus.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Lambda-Funktionen aus.

Wählen Sie im Abschnitt Meine Lambda-Funktionen die Option Hinzufügen aus.

Wählen SecretTestSie für die Lambda-Funktion.

Wählen Sie für die Lambda-Funktionsversion den Alias der Version, die Sie veröffentlicht haben.

Nehmen Sie im Abschnitt Lambda-Funktionskonfiguration die folgenden Aktualisierungen vor.

1. Um ohne Containerisierung zu laufen:

   • Wählen Sie für Systembenutzer und Gruppe die Option. Another user ID/group ID Geben Sie als Systembenutzer-ID ein0. Geben Sie als Systemgruppen-ID ein0.

     Dadurch kann Ihre Lambda-Funktion als Root ausgeführt werden. Weitere Hinweise zur Ausführung als Root finden Sie unterFestlegen der Standardzugriffsidentität für Lambda-Funktionen in einer Gruppe.

     Tipp

     Sie müssen Ihre config.json Datei auch aktualisieren, um Root-Zugriff auf Ihre Lambda-Funktion zu gewähren. Informationen zum Verfahren finden Sie unterAusführen einer Lambda-Funktion als Root.

   • Wählen Sie für die Containerisierung von Lambda-Funktionen die Option Kein Container aus.

     Weitere Hinweise zur Ausführung ohne Containerisierung finden Sie unter. Überlegungen bei der Auswahl der Containerisierung von Lambda-Funktionen

   • Geben Sie in Timeout (Zeitüberschreitung) 10 seconds ein.

   • Wählen Sie für Pinned die Option True aus.

     Weitere Informationen finden Sie unter Lebenszykluskonfiguration für Greengrass-Lambda-Funktionen.

   • Wählen Sie unter Zusätzliche Parameter für Lesezugriff auf das Verzeichnis /sys die Option Aktiviert aus.

2. Um stattdessen im containerisierten Modus zu starten:

   Anmerkung

   Wir empfehlen nicht, im containerisierten Modus zu arbeiten, es sei denn, Ihr Geschäftsszenario erfordert dies.

   • Wählen Sie für Systembenutzer und Gruppe die Option Gruppenstandard verwenden aus.

   • Wählen Sie für die Containerisierung von Lambda-Funktionen die Option Gruppenstandard verwenden aus.

   • Geben Sie in Memory Limit (Speicherlimit) 1024 MB ein.

   • Geben Sie in Timeout (Zeitüberschreitung) 10 seconds ein.

   • Wählen Sie für Pinned die Option True aus.

     Weitere Informationen finden Sie unter Lebenszykluskonfiguration für Greengrass-Lambda-Funktionen.

   • Wählen Sie unter Zusätzliche Parameter für Lesezugriff auf das Verzeichnis /sys die Option Aktiviert aus.

Wählen Sie Lambda-Funktion hinzufügen.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Lambda-Funktionen aus.

Wählen Sie die SecretTestFunktion aus.

Wählen Sie auf der Detailseite der Funktion Ressourcen aus.

Scrollen Sie zum Bereich Secrets und wählen Sie Associate aus.

Wählen Sie MyTestSecretund wählen Sie dann Associate aus.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Abonnements und dann Abonnement hinzufügen aus.

Erstellen Sie ein Abonnement, das es AWS IoT ermöglicht, Nachrichten an die Funktion zu veröffentlichen.

Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte Abonnements und dann Abonnement hinzufügen aus.

Konfigurieren Sie auf der Seite Abonnement erstellen die Quelle und das Ziel wie folgt:

1. Wählen Sie unter Quelltyp die Option Lambda-Funktion und dann IoT Cloud aus.

2. Wählen Sie unter Zieltyp die Option Service und dann aus SecretTest.

3. Geben Sie im Themenfilter Folgendes ein secrets/input und wählen Sie dann Abonnement erstellen aus.

Hinzufügen eines zweiten Abonnements. Wählen Sie die Registerkarte Abonnements aus, wählen Sie Abonnement hinzufügen und konfigurieren Sie Quelle und Ziel wie folgt:

1. Wählen Sie unter Quelltyp die Option Dienste und dann aus SecretTest.

2. Wählen Sie unter Zieltyp die Option Lambda-Funktion und dann IoT Cloud aus.

3. Geben Sie im Themenfilter Folgendes ein secrets/output und wählen Sie dann Abonnement erstellen aus.

Stellen Sie sicher, dass der AWS IoT Greengrass Core läuft. Führen Sie im Raspberry Pi-Terminal die folgenden Befehle aus, falls nötig.

1. So prüfen Sie, ob der Daemon ausgeführt wird:

   ps aux | grep -E 'greengrass.*daemon'

   Wenn die Ausgabe einen root-Eintrag für /greengrass/ggc/packages/ggc-version/bin/daemon enthält, dann wird der Daemon ausgeführt.

   Anmerkung

   Die Version in dem Pfad hängt von der AWS IoT Greengrass-Core-Softwareversion ab, die auf Ihrem Core-Gerät installiert ist.

2. Um den Daemon zu starten:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Wählen Sie auf der Seite mit der Gruppenkonfiguration die Option Deploy aus.

1. Wählen Sie auf der Registerkarte Lambda-Funktionen im Abschnitt System-Lambda-Funktionen die Option IP-Detektor und dann Bearbeiten aus.

2. Wählen Sie im Dialogfeld IP-Detektoreinstellungen bearbeiten die Option MQTT-Broker-Endpunkte automatisch erkennen und überschreiben aus.

3. Wählen Sie Speichern aus.

   Damit können Geräte automatisch Core-Verbindungsinformationen abrufen, z. B. die IP-Adresse, DNS und die Portnummer. Die automatische Ermittlung wird empfohlen, aber AWS IoT Greengrass unterstützt auch manuell angegebene Endpunkte. Sie werden nur bei der ersten Bereitstellung der Gruppe zur Angabe der Ermittlungsmethode aufgefordert.

   Anmerkung

   Wenn Sie dazu aufgefordert werden, erteilen Sie die Erlaubnis, die Greengrass-Servicerolle zu erstellen und sie Ihrer AWS-Konto aktuellen AWS-Region Rolle zuzuordnen. Diese Rolle ermöglicht AWS IoT Greengrass den Zugriff auf Ihre Ressourcen in AWS Diensten.

   Auf der Seite Deployments werden der Zeitstempel, die Versions-ID und der Status der Bereitstellung angegeben. Nach Abschluss sollte der für die Bereitstellung angezeigte Status Abgeschlossen lauten.

   Hilfe zur Problembehebung finden Sie unter Fehlerbehebung für AWS IoT Greengrass.

Wählen Sie auf der Startseite der AWS IoT Konsole die Option Test aus.

Verwenden Sie für Thema abonnieren die folgenden Werte und wählen Sie dann Abonnieren aus.

Verwenden Sie für Im Thema veröffentlichen die folgenden Werte und wählen Sie dann Veröffentlichen, um die Funktion aufzurufen.

Im Erfolgsfall veröffentlicht die Funktion eine "Success"-Meldung.