Comment créer une ressource de secret (console)

Connectez-vous à la console AWS Secrets Manager.

Choisissez Store a new secret (Stocker un nouveau secret).

Sous Choisir le type de secret, choisissez Autre type de secret.

Dans Spécifier les paires clé/valeur à stocker pour ce secret :

Gardez aws/secretsmanager sélectionné pour la clé de chiffrement, puis choisissez Next.

Pour Secret name, entrez greengrass-TestSecret et choisissez Next.

Ce didacticiel ne nécessite pas de rotation. Choisissez donc désactiver la rotation automatique, puis cliquez sur Suivant.

Dans la page Révision, passez en revue vos paramètres, puis choisissez Stocker.

Ensuite, vous créez une ressource de secret dans votre groupe Greengrass qui référence le secret.

Dans le volet de navigation de la AWS IoT console, sous Gérer, développez les appareils Greengrass, puis choisissez Groups (V1).

Choisissez le groupe auquel vous souhaitez ajouter la ressource de secret.

Sur la page de configuration du groupe, choisissez l'onglet Ressources, puis faites défiler la page jusqu'à la section Secrets. La section Secrets affiche les ressources secrètes appartenant au groupe. Vous pouvez ajouter, modifier et supprimer des ressources secrètes dans cette section.

Choisissez Ajouter dans la section Secrets.

Sur la page Ajouter une ressource secrète, entrez MyTestSecret le nom de la ressource.

Sous Secret, choisissez greengrass- TestSecret.

Dans la section Sélectionner les étiquettes (facultatif), AWSCURRENT l'étiquette intermédiaire représente la dernière version du secret. Cette étiquette est toujours incluse dans une ressource de secret.

Choisissez Add resource (Ajouter ressource).

Sur la page de téléchargement du SDK AWS IoT Greengrass Core, téléchargez le SDK AWS IoT Greengrass Core pour Python sur votre ordinateur.

Décompressez le package téléchargé pour obtenir le kit SDK. Le kit SDK est représenté par le dossier greengrasssdk.

Enregistrez la fonction de code Python suivante dans un fichier local nommé 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)

La get_secret_value fonction prend en charge le nom ou l'ARN du secret du Secrets Manager pour la SecretId valeur. Cet exemple utilise le nom du secret. Pour cet exemple, AWS IoT Greengrass renvoie la paire clé-valeur : {"test":"abcdefghi"}.

Compressez les éléments suivants dans un fichier nommé secret_test_python.zip. Lorsque vous créez le fichier ZIP, insérez uniquement le code et ses dépendances, pas le dossier dans lequel il se trouve.

Il s'agit de votre package de déploiement de fonctions Lambda.

Créez d'abord la fonction Lambda.

1. Dans AWS Management Console, choisissez Services et ouvrez la console AWS Lambda.

2. Choisissez Créer une fonction, puis sélectionnez Auteur à partir de zéro.

3. Dans la section Informations de base, spécifiez les valeurs suivantes :

   • Sous Nom de la fonction, saisissez SecretTest.

   • Pour Runtime, sélectionnez Python 3.7.

   • Pour les autorisations, conservez le paramètre par défaut. Cela crée un rôle d'exécution qui accorde des autorisations Lambda de base. Ce rôle n'est pas utilisé parAWS IoT Greengrass.

4. Dans le bas de la page, choisissez Create function.

Enregistrez ensuite le gestionnaire et téléchargez le package de déploiement de votre fonction Lambda.

1. Dans l'onglet Code, sous Source du code, choisissez Télécharger depuis. Dans le menu déroulant, sélectionnez le fichier .zip.

   

2. Choisissez Upload, puis choisissez votre package secret_test_python.zip de déploiement. Ensuite, choisissez Enregistrer.

3. Dans l'onglet Code de la fonction, sous Paramètres d'exécution, choisissez Modifier, puis entrez les valeurs suivantes.

   • Pour Runtime, sélectionnez Python 3.7.

   • Pour Handler (Gestionnaire), entrez secret_test.function_handler.

4. Choisissez Save (Enregistrer).

   Note

   Le bouton Test de la AWS Lambda console ne fonctionne pas avec cette fonction. Le SDK AWS IoT Greengrass principal ne contient pas les modules nécessaires pour exécuter vos fonctions Greengrass Lambda de manière indépendante dans la console. AWS Lambda Ces modules (par exemplegreengrass_common) sont fournis aux fonctions après leur déploiement sur votre noyau Greengrass.

À présent, publiez la première version de votre fonction Lambda et créez un alias pour cette version.

1. Dans le menu Actions, sélectionnez Publier une nouvelle version.

2. Dans Description de la version, saisissez First version, puis choisissez Publish.

3. Sur la page de configuration SecretTest: 1, dans le menu Actions, choisissez Créer un alias.

4. Sur la page Create a new alias, utilisez les valeurs suivantes :

   • Pour Name (Nom), saisissez GG_SecretTest.

   • Pour Version, choisissez 1.

   Note

   AWS IoT Greengrassne prend pas en charge les alias Lambda pour les versions $LATEST.

5. Sélectionnez Create (Créer).

Sur la page de configuration du groupe, choisissez l'onglet Fonctions Lambda.

Dans la section Mes fonctions Lambda, choisissez Ajouter.

Pour la fonction Lambda, choisissez. SecretTest

Pour la version de la fonction Lambda, choisissez l'alias de la version que vous avez publiée.

Dans la section Configuration de la fonction Lambda, effectuez les mises à jour suivantes.

1. Pour exécuter sans conteneurisation :

   • Pour Utilisateur et groupe du système, sélectionnezAnother user ID/group ID. Dans le champ ID utilisateur du système, entrez0. Pour l'ID du groupe de systèmes, entrez0.

     Cela permet à votre fonction Lambda de s'exécuter en tant que root. Pour plus d'informations sur l'exécution en tant que root, consultezDéfinition de l'identité d'accès par défaut pour les fonctions Lambda dans un groupe.

     Astuce

     Vous devez également mettre à jour votre config.json fichier pour accorder un accès root à votre fonction Lambda. Pour la procédure, voirExécution d'une fonction Lambda en tant que root.

   • Pour la conteneurisation de la fonction Lambda, sélectionnez Aucun conteneur.

     Pour plus d'informations sur l'exécution sans conteneurisation, consultez. Considérations à prendre en compte lors du choix de la conteneurisation des fonctions Lambda

   • Pour Expiration, entrez 10 seconds.

   • Pour Épinglé, choisissez True.

     Pour plus d'informations, veuillez consulter Configuration du cycle de vie pour les fonctions Greengrass Lambda.

   • Sous Paramètre supplémentaire, pour l'accès en lecture au répertoire /sys, choisissez Enabled.

2. Pour exécuter plutôt en mode conteneurisé :

   Note

   Nous vous déconseillons de l'exécuter en mode conteneurisé, sauf si votre analyse de rentabilisation l'exige.

   • Pour Utilisateur et groupe du système, choisissez Utiliser le groupe par défaut.

   • Pour la conteneurisation de la fonction Lambda, choisissez Utiliser le groupe par défaut.

   • Pour Limite de mémoire, entrez 1024 MB.

   • Pour Expiration, entrez 10 seconds.

   • Pour Épinglé, choisissez True.

     Pour plus d'informations, veuillez consulter Configuration du cycle de vie pour les fonctions Greengrass Lambda.

   • Sous Paramètres supplémentaires, pour l'accès en lecture au répertoire /sys, sélectionnez Activé.

Choisissez Ajouter une fonction Lambda.

Sur la page de configuration du groupe, choisissez l'onglet Fonctions Lambda.

Choisissez la SecretTestfonction.

Sur la page de détails de la fonction, sélectionnez Ressources.

Accédez à la section Secrets et choisissez Associer.

Choisissez MyTestSecret, puis choisissez Associer.

Sur la page de configuration du groupe, choisissez l'onglet Abonnements, puis choisissez Ajouter un abonnement.

Créez un abonnement qui permet à AWS IoT de publier des messages à la fonction.

Sur la page de configuration du groupe, choisissez l'onglet Abonnements, puis choisissez Ajouter un abonnement.

Sur la page Créer un abonnement, configurez la source et la cible comme suit :

1. Dans Type de source, sélectionnez Fonction Lambda, puis IoT Cloud.

2. Dans Type de cible, choisissez Service, puis choisissez SecretTest.

3. Dans le filtre de rubrique, entrezsecrets/input, puis choisissez Créer un abonnement.

Ajoutez un second abonnement. Choisissez l'onglet Abonnements, choisissez Ajouter un abonnement et configurez la source et la cible comme suit :

1. Dans Type de source, choisissez Services, puis sélectionnez SecretTest.

2. Dans Type de cible, choisissez la fonction Lambda, puis sélectionnez IoT Cloud.

3. Dans le filtre de rubrique, entrezsecrets/output, puis choisissez Créer un abonnement.

Assurez-vous que le AWS IoT Greengrass noyau fonctionne. Dans la fenêtre de terminal de votre Raspberry Pi, exécutez les commandes suivantes, si nécessaire.

1. Pour vérifier si le démon est en cours d'exécution :

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

   Si la sortie contient une entrée root pour /greengrass/ggc/packages/ggc-version/bin/daemon, le démon est en cours d'exécution.

   Note

   La version du chemin d'accès dépend de la version du logiciel AWS IoT Greengrass Core installée sur votre appareil principal.

2. Pour démarrer le daemon :

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

Sur la page de configuration du groupe, choisissez Deploy.

1. Dans l'onglet Fonctions Lambda, sous la section Fonctions Lambda du système, sélectionnez Détecteur IP et choisissez Modifier.

2. Dans la boîte de dialogue Modifier les paramètres du détecteur IP, sélectionnez Détecter et remplacer automatiquement les points de terminaison du broker MQTT.

3. Choisissez Save (Enregistrer).

   Les appareils peuvent ainsi acquérir automatiquement des informations de connectivité pour le noyau, telles que l'adresse IP, le DNS et le numéro de port. La détection automatique est recommandée, mais AWS IoT Greengrass prend également en charge les points de terminaison spécifiés manuellement. Vous êtes uniquement invité à indiquer la méthode de découverte lors du déploiement initial du groupe.

   Note

   Si vous y êtes invité, autorisez la création du rôle de service Greengrass et associez-le à votre rôle Compte AWS dans le service actuel. Région AWS Ce rôle permet d'accéder AWS IoT Greengrass à vos ressources dans les AWS services.

   La page Déploiements indique l'horodatage, l'ID de version et l'état du déploiement. Une fois terminé, le statut affiché pour le déploiement doit être Terminé.

   Pour bénéficier d'une aide à la résolution des problèmes, consultez Résolution des problèmes de AWS IoT Greengrass.

Sur la page d'accueil de la AWS IoT console, choisissez Test.

Pour S'abonner à la rubrique, utilisez les valeurs suivantes, puis choisissez S'abonner.

Pour Publier dans le sujet, utilisez les valeurs suivantes, puis choisissez Publier pour appeler la fonction.

En cas de réussite, la fonction publie un message « Success ».