Come creare una risorsa segreta (console)

Accedere alla AWS Secrets Manager console.

Scegli Archivia un nuovo segreto.

In Scegli il tipo di segreto, scegli Altro tipo di segreto.

In Specify the key-value pairs to be stored for this secret (Specifica le coppie chiave-valore da archiviare per questo segreto):

Mantieni aws/secretsmanager selezionata la chiave di crittografia, quindi scegli Avanti.

In Secret name (Nome segreto), immetti greengrass-TestSecret, quindi seleziona Next (Avanti).

Questo tutorial non richiede la rotazione, quindi scegli Disabilita la rotazione automatica, quindi scegli Avanti.

Nella pagina Review (Revisione), rivedi le impostazioni e quindi scegli Store (Archivia).

Dovrai quindi creare una risorsa segreta nel gruppo Greengrass che faccia riferimento al segreto.

Nel pannello di navigazione della AWS IoT console, in Gestisci, espandi i dispositivi Greengrass, quindi scegli Gruppi (V1).

Scegli il gruppo a cui aggiungere la risorsa segreta.

Nella pagina di configurazione del gruppo, scegli la scheda Risorse, quindi scorri verso il basso fino alla sezione Segreti. La sezione Segreti mostra le risorse segrete che appartengono al gruppo. Puoi aggiungere, modificare e rimuovere risorse segrete da questa sezione.

Scegli Aggiungi nella sezione Segreti.

Nella pagina Aggiungi una risorsa segreta, inserisci MyTestSecret il nome della risorsa.

In Segreto, scegli greengrass-. TestSecret

Nella sezione Seleziona etichette (opzionale), l'etichetta di staging AWSCURRENT rappresenta l'ultima versione del segreto. Questa etichetta è sempre inclusa in una risorsa segreta.

Scegliere Add resource (Aggiungi risorsa).

Dalla pagina di download del AWS IoT Greengrass Core SDK, scarica il AWS IoT Greengrass Core SDK for Python sul tuo computer.

Decomprimere il pacchetto scaricato per ottenere l'SDK. Il kit SDK è la cartella greengrasssdk.

Salvare la seguente funzione del codice Python nel file locale 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 funzione supporta il nome o l'ARN del segreto di Secrets Manager per il valore. SecretId Questo esempio utilizza il nome segreto. Per questo esempio secret, AWS IoT Greengrass restituisce la coppia chiave-valore:. {"test":"abcdefghi"}

Comprimere le voci seguenti nel file secret_test_python.zip. Durante la creazione del file ZIP, includi solo il codice e le dipendenze e non la cartella che li contiene.

Questo è il pacchetto di distribuzione delle funzioni Lambda.

Innanzitutto, crea la funzione Lambda.

1. In Console di gestione AWS, scegli Servizi e apri la AWS Lambda console.

2. Scegli la funzione Crea, quindi scegli Autore da zero.

3. Nella sezione Basic information (Informazioni di base), specifica i seguenti valori:

   • Nel campo Function name (Nome funzione), immettere SecretTest.

   • In Runtime, scegliere Python 3.7.

   • Per le autorizzazioni, mantieni l'impostazione predefinita. Questo crea un ruolo di esecuzione che concede le autorizzazioni Lambda di base. Questo ruolo non è utilizzato da. AWS IoT Greengrass

4. Nella parte inferiore della pagina, scegli Crea funzione.

Quindi, registra il gestore e carica il pacchetto di distribuzione della funzione Lambda.

1. Nella scheda Codice, in Codice sorgente, scegli Carica da. Dal menu a discesa, scegli il file .zip.

   

2. Scegli Carica, quindi scegli il pacchetto di secret_test_python.zip distribuzione. Poi, scegli Salva.

3. Nella scheda Codice della funzione, in Impostazioni di runtime, scegli Modifica, quindi inserisci i seguenti valori.

   • In Runtime, scegliere Python 3.7.

   • In Handler (Gestore), immetti secret_test.function_handler

4. Selezionare Salva.

   Nota

   Il pulsante Test sulla AWS Lambda console non funziona con questa funzione. Il AWS IoT Greengrass Core SDK non contiene i moduli necessari per eseguire le funzioni Greengrass Lambda in modo indipendente nella console. AWS Lambda Questi moduli (ad esempiogreengrass_common) vengono forniti alle funzioni dopo essere stati distribuiti nel core di Greengrass.

Ora pubblica la prima versione della tua funzione Lambda e crea un alias per la versione.

1. Nel menu Actions (Operazioni), seleziona Publish new version (Pubblica nuova versione).

2. Per Version description (Descrizione versione), immettere First version, quindi scegliere Publish (Pubblica).

3. Nella pagina di configurazione SecretTest: 1, dal menu Azioni, scegli Crea alias.

4. Nella pagina Create a new alias (Crea un nuovo alias), utilizza i seguenti valori:

   • In Nome, inserisci GG_SecretTest.

   • In Version (Versione), selezionare 1.

   Nota

   AWS IoT Greengrass non supporta gli alias Lambda per le versioni $LATEST.

5. Scegli Crea.

Nella pagina di configurazione del gruppo, scegli la scheda Funzioni Lambda.

Nella sezione Le mie funzioni Lambda, scegli Aggiungi.

Per la funzione Lambda, scegli. SecretTest

Per la versione della funzione Lambda, scegli l'alias della versione che hai pubblicato.

Nella sezione di configurazione della funzione Lambda, apporta i seguenti aggiornamenti.

1. Per eseguire senza containerizzazione:

   • Per utente e gruppo di sistema, scegli. Another user ID/group ID Per ID utente di sistema, inserisci0. Per ID del gruppo di sistema, immettere0.

     Ciò consente alla funzione Lambda di essere eseguita come root. Per ulteriori informazioni sull'esecuzione come root, consultaImpostazione dell'identità di accesso predefinita per le funzioni Lambda in un gruppo.

     Suggerimento

     È inoltre necessario aggiornare il config.json file per concedere l'accesso root alla funzione Lambda. Per la procedura, consultaEsecuzione di una funzione Lambda come utente root.

   • Per la containerizzazione della funzione Lambda, scegli Nessun contenitore.

     Per ulteriori informazioni sull'esecuzione senza containerizzazione, consulta. Considerazioni sulla scelta della containerizzazione delle funzioni Lambda

   • Per Timeout, immettere 10 seconds.

   • Per Pinned, scegli True.

     Per ulteriori informazioni, consulta Configurazione del ciclo di vita per le funzioni Greengrass Lambda.

   • In Parametro aggiuntivo, per l'accesso in lettura alla directory /sys, scegli Abilitato.

2. Per eseguire invece in modalità containerizzata:

   Nota

   Si sconsiglia l'esecuzione in modalità containerizzata a meno che il business case non lo richieda.

   • Per Utente e gruppo di sistema, scegli Usa l'impostazione predefinita del gruppo.

   • Per la containerizzazione delle funzioni Lambda, scegli Usa default di gruppo.

   • Per Memory limit (Limite memoria), immettere 1024 MB.

   • Per Timeout, immettere 10 seconds.

   • Per Pinned, scegli True.

     Per ulteriori informazioni, consulta Configurazione del ciclo di vita per le funzioni Greengrass Lambda.

   • In Parametri aggiuntivi, per l'accesso in lettura alla directory /sys, scegli Abilitato.

Scegli Aggiungi funzione Lambda.

Nella pagina di configurazione del gruppo, scegli la scheda Funzioni Lambda.

Scegli la SecretTest funzione.

Nella pagina dei dettagli della funzione, scegli Risorse.

Scorri fino alla sezione Segreti e scegli Associa.

Scegli MyTestSecret, quindi scegli Associa.

Nella pagina di configurazione del gruppo, scegli la scheda Abbonamenti, quindi scegli Aggiungi abbonamento.

Crea un abbonamento che AWS IoT consenta di pubblicare messaggi nella funzione.

Nella pagina di configurazione del gruppo, scegli la scheda Abbonamenti, quindi scegli Aggiungi abbonamento.

Nella pagina Crea un abbonamento, configura l'origine e la destinazione, come segue:

1. In Tipo di sorgente, scegli la funzione Lambda, quindi scegli IoT Cloud.

2. In Tipo di destinazione, scegli Servizio, quindi scegli SecretTest.

3. Nel filtro Argomento secrets/input, inserisci, quindi scegli Crea abbonamento.

Aggiungere un secondo abbonamento. Scegli la scheda Abbonamenti, scegli Aggiungi abbonamento e configura l'origine e la destinazione, come segue:

1. In Tipo di origine, scegli Servizi, quindi scegli SecretTest.

2. In Tipo di destinazione, scegli la funzione Lambda, quindi scegli IoT Cloud.

3. Nel filtro Argomento, inseriscisecrets/output, quindi scegli Crea abbonamento.

Assicurati che il AWS IoT Greengrass core sia in esecuzione. Esegui i seguenti comandi nel terminale di Raspberry Pi in base alle esigenze.

1. Per controllare se il daemon è in esecuzione:

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

   Se l'output contiene una voce root per /greengrass/ggc/packages/ggc-version/bin/daemon, allora il daemon è in esecuzione.

   Nota

   La versione indicata nel percorso dipende dalla versione del software AWS IoT Greengrass Core installata sul dispositivo principale.

2. Per avviare il demone:

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

Nella pagina di configurazione del gruppo, scegli Deploy.

1. Nella scheda Funzioni Lambda, nella sezione Funzioni di sistema Lambda, seleziona IP detector e scegli Modifica.

2. Nella finestra di dialogo Modifica le impostazioni del rilevatore IP, seleziona Rileva e sostituisci automaticamente gli endpoint del broker MQTT.

3. Selezionare Salva.

   Questo consente ai dispositivi di acquisire automaticamente informazioni di base sulla connettività, come, ad esempio indirizzo IP, DNS e numero della porta. Il rilevamento automatico è consigliato, ma supporta AWS IoT Greengrass anche endpoint specificati manualmente. Ti viene chiesto il metodo di individuazione solo la prima volta che il gruppo viene distribuito.

   Nota

   Se richiesto, concedete l'autorizzazione per creare il ruolo del servizio Greengrass e associarlo al vostro Account AWS ruolo attuale. Regione AWS Questo ruolo consente di accedere AWS IoT Greengrass alle risorse nei AWS servizi.

   Nella pagina Deployments (Distribuzioni) vengono visualizzati il timestamp della distribuzione, l'ID versione e lo stato. Una volta completata, lo stato visualizzato per la distribuzione dovrebbe essere Completato.

   Per la risoluzione dei problemi, consultare Risoluzione dei problemi AWS IoT Greengrass.

Nella home page AWS IoT della console, scegli Test.

Per Sottoscrivi all'argomento, utilizza i seguenti valori, quindi scegli Iscriviti.

Per Pubblica su argomento, utilizza i seguenti valori, quindi scegli Pubblica per richiamare la funzione.

In caso di esito positivo, la funzione pubblica il messaggio "Success" ("Successo").