Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Gestore segreto
Il componente secret manager (aws.greengrass.SecretManager) distribuisce i segreti dai AWS Secrets Manager
dispositivi principali di Greengrass. Usa questo componente per utilizzare in modo sicuro le credenziali, come le password, nei componenti personalizzati sui tuoi dispositivi principali Greengrass. Per ulteriori informazioni su Secrets Manager, consultate What is? AWS Secrets Managernella Guida AWS Secrets Manager per l'utente.
Per accedere ai segreti di questo componente nei componenti Greengrass personalizzati, utilizzate l'GetSecretValueoperazione in. SDK per dispositivi AWS IoT Per ulteriori informazioni, consulta SDK per dispositivi AWS IoT Utilizzatelo per comunicare con il nucleo Greengrass, gli altri componenti e AWS IoT Core e Recupera valori segreti.
Questo componente crittografa i segreti sul dispositivo principale per proteggere le credenziali e le password fino a quando non è necessario utilizzarle. Utilizza la chiave privata del dispositivo principale per crittografare e decrittografare i segreti.
Argomenti
Versioni
Questo componente ha le seguenti versioni:
-
2.2.x
-
2.1.x
-
2.0.x
Tipo
Questo componente è un componente plug-in (aws.greengrass.plugin). Il nucleo di Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.
Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.
Per ulteriori informazioni, consulta Tipi di componenti.
Sistema operativo
Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
Linux
Windows
Requisiti
Questo componente ha i seguenti requisiti:
-
Il ruolo del dispositivo Greengrass deve consentire l'
secretsmanager:GetSecretValueazione, come mostrato nel seguente esempio di policy IAM.Nota
Se si utilizza una AWS Key Management Service chiave gestita dal cliente per crittografare i segreti, anche il ruolo del dispositivo deve consentire l'azione.
kms:DecryptPer ulteriori informazioni sulle politiche IAM per Secrets Manager, consulta quanto segue nella Guida per l'AWS Secrets Manager utente:
-
I componenti personalizzati devono definire una politica di autorizzazione che
aws.greengrass#GetSecretValueconsenta di ottenere i segreti archiviati con questo componente. In questa politica di autorizzazione, puoi limitare l'accesso dei componenti a segreti specifici. Per ulteriori informazioni, consulta l'autorizzazione IPC di Secret Manager. -
(Facoltativo) Se si archiviano la chiave privata e il certificato del dispositivo principale in un modulo di sicurezza hardware (HSM), l'HSM deve supportare le chiavi RSA, la chiave privata deve disporre dell'
unwrapautorizzazione e la chiave pubblica deve disporre dell'autorizzazione.wrap
Endpoint e porte
Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.
| Endpoint | Porta | Richiesto | Description |
|---|---|---|---|
|
|
443 | Sì |
Scarica i segreti sul dispositivo principale. |
Dipendenze
Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass
Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti. ComponentDependencies
Configurazione
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
periodicRefreshIntervalMin(facoltativo)-
L'intervallo in minuti in cui questo componente sincronizza i segreti configurati sul dispositivo principale con i valori segreti più recenti del AWS Secrets Manager servizio. Se questo intervallo non è configurato, secret manager non aggiornerà periodicamente i segreti configurati.
{ "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef" } ], "periodicRefreshIntervalMin" : 60 } cloudSecrets-
Un elenco di segreti di Secrets Manager da distribuire nel dispositivo principale. È possibile specificare le etichette per definire quali versioni di ogni segreto distribuire. Se non specificate una versione, questo componente distribuisce la versione con l'etichetta di staging allegata.
AWSCURRENTPer ulteriori informazioni, consulta Etichette di staging nella Guida per l'AWS Secrets Manager utente.Il componente secret manager memorizza i segreti nella cache locale. Se il valore segreto cambia in Secrets Manager, questo componente non recupera automaticamente il nuovo valore. Per aggiornare la copia locale, assegna al segreto una nuova etichetta e configura questo componente per recuperare il segreto identificato dalla nuova etichetta.
Ogni oggetto contiene le seguenti informazioni:
arn-
L'ARN del segreto da implementare. L'ARN del segreto può essere un ARN completo o parziale. Ti consigliamo di specificare un ARN completo anziché parziale. Per ulteriori informazioni, consulta Trovare un segreto da un ARN parziale. Di seguito è riportato un esempio di ARN completo e ARN parziale:
-
ARN completo:
arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef -
ARN parziale:
arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName
-
labels-
(Facoltativo) Un elenco di etichette per identificare le versioni del segreto da distribuire nel dispositivo principale.
Ogni etichetta deve essere una stringa.
Esempio Esempio: aggiornamento dell'unione delle configurazioni
{ "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef" } ] }
File di registro locale
Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.
Per visualizzare i log di questo componente
-
Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci
/greengrass/v2C:\greengrass\v2con il percorso della cartella AWS IoT Greengrass principale.
Changelog
La tabella seguente descrive le modifiche in ciascuna versione del componente.
|
Versione |
Modifiche |
|---|---|
|
2.2.10 |
|
|
2.2.9 |
|
|
2.2.8 |
Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus. |
|
2.2.7 |
Versione aggiornata per Greengrass nucleus versione 2.16.0. |
|
2.2.6 |
|
|
2.2.5 |
|
|
2.2.4 |
|
|
2.2.3 |
|
|
2.2.2 |
|
|
2.2.1 |
|
|
2.2.0 |
|
|
2.1.8 |
|
|
2.1.7 |
Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. |
|
2.1.6 |
Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
|
2.1.5 |
Versione aggiornata per la versione 2.10.0 di Greengrass nucleus. |
|
2.1.4 |
|
|
2.1.3 |
Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. |
|
2.1.2 |
Versione aggiornata per la versione 2.7.0 di Greengrass nucleus. |
|
2.1.1 |
Versione aggiornata per la versione 2.6.0 di Greengrass nucleus. |
|
2.1.0 |
|
|
2.0.9 |
Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. |
|
2.0.8 |
Versione aggiornata per la versione 2.3.0 di Greengrass nucleus. |
|
2.0.7 |
Versione aggiornata per la versione 2.2.0 di Greengrass nucleus. |
|
2.0.6 |
Versione aggiornata per la versione 2.1.0 di Greengrass nucleus. |
|
2.0.5 |
|
|
2.0.4 |
Versione iniziale. |
